Mengimpor konfigurasi klien MCP — tiga server yang digunakan asisten pemrograman
.mcp.json milik Claude Code yang mencantumkan tiga server Model Context Protocol — dua dijalankan dari baris perintah dan satu dijalankan oleh pihak lain — dijadikan draf berkas Aggrega oleh aggrega import, dengan setiap server dipetakan ke realisasi yang sesuai dengan cara server itu berjalan, dan di-build untuk Kubernetes.
Mengimpor konfigurasi klien MCP membahasnya langkah demi langkah: perintahnya, berkas yang ditulisnya dan alasan setiap barisnya ada, build-nya, serta server yang berjalan. Folder ini memuat setiap tahap dari panduan tersebut:
| folder atau berkas | isinya |
|---|---|
source/ | konfigurasi klien, .mcp.json, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, dan import-answers.yaml, nama Secret Kubernetes tempat token server GitHub dibaca |
draft/ | berkas yang ditulis oleh aggrega import .mcp.json --target helm, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar |
Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.
Membuat contoh
Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example import-mcpKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd import-mcpBuild
Impor membuat draf berkas Aggrega di samping proyek, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan oleh registri bawaan ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menyebutnya dengan digest-nya dalam catatan yang ditulisnya di samping draf. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder tersebut sebagai gantinya. Impor membaca nama Secret dari import-answers.yaml, lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:
cd sourceaggrega import .mcp.json --target helmaggrega build --release release.yamlBuild menulis manifes Kubernetes di bawah dist/helm/; cara membuat Secret dan menerapkan manifes tersebut ada di panduan yang ditautkan di atas.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-mcp`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-mcp` dan tanpa `dir`: alat itu menulis contoh ke folder `import-mcp` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-mcp/source`, `source` diatur ke `.mcp.json`, dan `target` diatur ke `helm`: alat itu membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `.mcp.json`, menulis drafnya ke `import-mcp/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-mcp/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-mcp/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya berkas mana yang ditulis build; berkas tersebut berada di bawah `import-mcp/source/dist/`.Mengujinya
Setelah build diterapkan, teruskan sebuah port lokal ke Service milik server fetch dan biarkan perintah tetap berjalan:
kubectl port-forward svc/fetch-default 8080:8080Dari terminal lain, minta server membuka sesi dengan permintaan initialize milik MCP:
curl -sS http://127.0.0.1:8080/mcp \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}': keepalive
: keepalive
event: messagedata: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}Panduan melakukan panggilan yang sama di Docker Compose dan ke server GitHub.