MCP クライアント設定をインポートする — コーディングアシスタントが使う 3 つのサーバー
3 つの Model Context Protocol サーバー — コマンドラインから起動する 2 つと、他者が運用する 1 つ — を列挙した Claude Code の .mcp.json を、aggrega import で Aggrega ファイルに下書きし、各サーバーをその実行方法に対応する実現にマッピングしたうえで Kubernetes 向けにビルドしたものです。
MCP クライアント設定をインポートする では、コマンド、それが書き出すファイルと各行がある理由、ビルド、そして実行中のサーバーまでを順を追って説明します。このフォルダーには、そのウォークスルーの各段階が収められています:
| フォルダーまたはファイル | 内容 |
|---|---|
source/ | クライアント設定 .mcp.json、フォルダーをワークスペースにする .aggrega-config.yaml、そして GitHub サーバーのトークンの読み取り元となる Kubernetes Secret の名前を記した import-answers.yaml |
draft/ | aggrega import .mcp.json --target helm が書き出したファイル(変更なし、release.lock を含む)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt |
ドキュメントリポジトリのチェックアウトでは、check.sh がインポートを再実行し、書き出した内容と出力した内容を draft/ と比較し、ウォークスルーが引用するブロックをこれらのファイルと比較して、インポートが書き出したものを検証しビルドします。このリポジトリの隣に標準ライブラリのカタログ(入手先)がチェックアウトされているか、そのディレクトリが AGGREGA_CATALOG_DIRS に指定されている必要があります。
サンプルを生成する
この例のインポートは、以下のコマンドで実行することも、AI アシスタントに代わりに実行させることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example import-mcpその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd import-mcpビルド
インポートは、プロジェクトの横の source/ に Aggrega ファイルを下書きします。プロジェクトを標準ライブラリのカタログと照らし合わせます。このカタログはワークスペースのデフォルトレジストリが署名付きスナップショットとして公開しているもので、最初のインポートがそれを取得し、検証し、ワークスペースのコンテンツキャッシュに保持し、下書きの横に書き出す記録の中でそのダイジェストによって示します。独自のカタログフォルダーを指定するワークスペース — AGGREGA_CATALOG_DIRS で、または workspace.catalog_dirs の下で — は、代わりにそれらに対してインポートします。インポートは import-answers.yaml から Secret の名前を読み取り、続いて下書きされた Release が依存するものをプルするため、すぐにビルドを続けられます:
cd sourceaggrega import .mcp.json --target helmaggrega build --release release.yamlビルドは Kubernetes マニフェストを dist/helm/ の下に書き出します。Secret の作成とマニフェストの適用は、上のリンク先のウォークスルーにあります。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `import-mcp` フォルダーがない場合は、`example` を `import-mcp` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。このツールは例を新しい `import-mcp` フォルダーに書き込み、その `source` フォルダーにこの例がインポートするものが入ります。次に、`workspace_root` を `import-mcp/source`、`source` を `.mcp.json`、`target` を `helm` に設定して `import` ツールを呼び出してください。このツールは必要な回答を `.mcp.json` の隣にある `import-answers.yaml` から読み取り、下書きを `import-mcp/source` に書き込み、下書きが必要とするものをプルします。次に、`workspace_root` を `import-mcp/source`、`release` を `release.yaml` に設定して `validate` ツールを、`workspace_root` を `import-mcp/source`、`release` を `release.yaml`、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `import-mcp/source/dist/` の下にあります。テストする
ビルドを適用したら、ローカルポートを fetch サーバーの Service に転送し、コマンドを実行したままにします:
kubectl port-forward svc/fetch-default 8080:8080別のターミナルから、MCP の initialize リクエストでセッションを開くようサーバーに依頼します:
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"}}}ウォークスルー では、Docker Compose 上でも、GitHub サーバーに対しても同じ呼び出しを行います。