ガイド

あらゆる AI コーディングエージェントに MCP サーバーを追加する方法:Claude Code、Cursor、Codex、Gemini CLI、VS Code ほか 8 ツール(2026)

各 AI コーディングエージェントは MCP サーバーの設定をどこに保存し、どのコマンドでサーバーを追加しますか?

ほとんどのエージェントは mcpServers オブジェクトを持つ JSON ファイルを読み込みます。Cursor は .cursor/mcp.json、Claude Code は .mcp.json、Kiro は .kiro/settings/mcp.json、Factory Droid は .factory/mcp.json、Junie は .junie/mcp/mcp.json です。例外は VS Code(.vscode/mcp.json の servers キー)、Codex(~/.codex/config.toml の [mcp_servers.NAME] テーブル)、OpenCode(opencode.json の mcp キー)、Zed(設定の context_servers)、goose(config.yaml の extensions)です。Claude Code、Codex、Gemini CLI、Amp、Factory Droid には mcp add コマンドもあります。

このページは英語版ガイドの翻訳です。コマンド、設定キー、コードは原文のままです。内容に差異がある場合は英語版が優先されます。 英語版を読む → · 他の言語: 简体中文 · 한국어 · Español · Português (Brasil)

設定の変更をいち早くチェック

これらのツールの設定、フラグ、権限ルールが変わったときに、週 1 回メール(英語)でお知らせします。内容は公式ドキュメントで確認済みです。

クイックアンサー:各エージェントの設定の置き場所

  • Claude Code:リモートサーバーは claude mcp add --transport http NAME URL、ローカルサーバーは claude mcp add NAME -- COMMAND。デフォルトは local スコープです。--scope project は共有の .mcp.json に書き込み、--scope user はすべてのプロジェクトでサーバーを使えるようにします。
  • Cursor:1 つのプロジェクトには .cursor/mcp.json、すべてのプロジェクトには ~/.cursor/mcp.json の mcpServers。
  • OpenAI Codex:codex mcp add NAME -- COMMAND、または ~/.codex/config.toml の [mcp_servers.NAME] テーブル。
  • Gemini CLI:gemini mcp add NAME COMMAND。デフォルトではプロジェクトの .gemini/settings.json に書き込みます。~/.gemini/settings.json に書くには -s user を付けます。
  • VS Code(GitHub Copilot):.vscode/mcp.json のトップレベルの servers オブジェクト、または MCP: Open User Configuration で開くユーザープロファイルのファイル。
  • GitHub 上の Copilot cloud agent:リポジトリの Settings、Copilot、MCP servers の順に開き、mcpServers オブジェクトを含む JSON を貼り付けます。
  • OpenCode:opencode.json のトップレベルの mcp キー。
  • Cline:cline_mcp_settings.json の mcpServers。CLI では ~/.cline/data/settings/cline_mcp_settings.json に保存されます。
  • Amp:amp mcp add NAME -- COMMAND または amp mcp add NAME URL、あるいは ~/.config/amp/settings.json か .amp/settings.json の amp.mcpServers。
  • Kiro:.kiro/settings/mcp.json(ワークスペース)または ~/.kiro/settings/mcp.json(ユーザー)の mcpServers。
  • Factory Droid:droid mcp add NAME URL_OR_COMMAND --type stdio|http|sse で ~/.factory/mcp.json に保存されます。チームでは .factory/mcp.json でサーバーを共有します。
  • Junie:.junie/mcp/mcp.json(プロジェクト)または ~/.junie/mcp/mcp.json(ユーザー)の mcpServers。
  • Zed:Zed の設定ファイルの context_servers。
  • goose:~/.config/goose/config.yaml の extensions キー配下の拡張、または goose configure から Add Extension。

ローカルとリモートのエントリは、どこでもほぼ同じ形

ローカルサーバーは、エージェントがマシン上で起動し stdio で通信するコマンドです。リモートサーバーは URL です。ほとんどの JSON 設定では、ローカルのエントリは command、args、env を持ち、リモートのエントリは url と任意の headers を持ちます。Cursor、Kiro、Junie はいずれも mcpServers 配下でこの形式を受け付けます。

.cursor/mcp.json、.kiro/settings/mcp.json、または .junie/mcp/mcp.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "remote-server": {
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Codex:~/.codex/config.toml

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"

VS Code:.vscode/mcp.json

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp"
    }
  }
}

OpenCode:opencode.json

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"]
    },
    "remote-server": {
      "type": "remote",
      "url": "https://example.com/mcp"
    }
  }
}

あるエージェントから別のエージェントに設定をコピーするときの注意点

  • VS Code の .vscode/mcp.json では mcpServers ではなく servers を使います。Cursor からコピーしたファイルはこのキー名を変更する必要があります。
  • OpenCode では type に local または remote を指定し、command は引数を含む 1 つの配列です。
  • Gemini CLI は SSE サーバーに url、streamable HTTP サーバーに httpUrl を使います。
  • Cline は type のないリモートエントリをレガシーの SSE として扱います。推奨のトランスポートを使うには type を streamableHttp に設定します。
  • Copilot cloud agent ではすべてのサーバーに tools 配列が必要で(全ツールには ["*"] を使用)、名前が COPILOT_MCP_ で始まるシークレットと変数だけが設定に渡されます。
  • Zed はサーバーを context_servers 配下に置き、Authorization ヘッダーのないリモートサーバーは標準の MCP OAuth フローを開始します。
  • Codex は JSON ではなく TOML です。サーバーごとに [mcp_servers.NAME] テーブルを 1 つ書きます。

プロジェクト設定、承認、自動承認

  • Claude Code は対話セッションで、.mcp.json のプロジェクトスコープのサーバーを使う前に承認を求めます。
  • Amp では、.amp/settings.json のサーバーを実行する前に amp mcp approve NAME が必要です。グローバル設定のサーバーには承認は不要です。
  • Kiro はワークスペースとユーザーのファイルをマージし、ワークスペースの設定が優先されます。autoApprove には確認なしで実行するツールを列挙し、"*" ですべてを承認します。
  • Gemini CLI:サーバーに trust: true を設定すると、そのサーバーのツール呼び出しの確認がすべてスキップされます。自分で管理するサーバーにのみ使ってください。
  • Cline:autoApprove 配列には、Cline が確認なしで呼び出せるツールを列挙します。安全なツールだけにしましょう。
  • Factory Droid:droid mcp add で追加したサーバーはユーザー設定に入ります。.factory/mcp.json のプロジェクトサーバーは droid mcp remove では削除できないため、ファイルを直接編集します。

サーバーが読み込まれたか確認する

  • Claude Code:/mcp。OAuth サーバーへのサインインもここで行います。
  • Codex:TUI で /mcp を実行すると有効なサーバーが表示されます。codex mcp login NAME で OAuth サーバーにサインインします。
  • Gemini CLI:/mcp で各サーバーの接続状態を表示します。
  • Factory Droid:/mcp で対話型のマネージャーが開きます。
  • Junie CLI:/mcp でサーバーをスコープと状態付きで一覧表示します。
  • Amp:amp mcp doctor。

エージェント別の完全な MCP セットアップガイド

出典

このガイドで確認した公式ドキュメント(英語)です。 英語版の確認日: 2026-10-18

その他の日本語ガイド