ガイド
あらゆる 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 セットアップガイド
- Claude Code:claude mcp add、.mcp.json、スコープ
- Cursor:mcp.json、環境変数の展開、OAuth
- Codex:codex mcp add と config.toml の [mcp_servers]
- Gemini CLI:gemini mcp add と settings.json の mcpServers
- GitHub Copilot:VS Code の mcp.json と cloud agent
- OpenCode:opencode.json のローカル・リモートサーバー
- Cline:cline_mcp_settings.json
- Amp:amp mcp add とワークスペースの承認
- Kiro:.kiro/settings/mcp.json、autoApprove、OAuth
- Factory Droid:droid mcp add と mcp.json の配置場所
- Junie:.junie/mcp/mcp.json と /mcp
- Zed:context_servers とツール権限
- goose:config.yaml の extensions
- 80 以上の公式 MCP サーバーをインストールスニペット付きで見る
出典
このガイドで確認した公式ドキュメント(英語)です。 英語版の確認日: 2026-10-18
その他の日本語ガイド
- あらゆる AI コーディングエージェントで全コマンドを許可する方法:Cursor、Claude Code、Codex、Gemini CLI、Copilot CLI ほか 7 ツール(2026)
- あらゆる AI コーディングエージェントのルール・指示ファイル:.cursor/rules、CLAUDE.md、AGENTS.md、GEMINI.md、Copilot instructions など(2026)
- あらゆる AI コーディングエージェントの設定ファイルの場所:Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Qwen Code、Amp、Factory Droid(2026)
- あらゆる AI コーディングエージェントの hook:Claude Code、Cursor、Gemini CLI、GitHub Copilot、Kiro、Factory Droid(2026)
- あらゆる AI コーディングエージェントの Agent Skills(SKILL.md):Claude Code、Codex、Cline、Amp、OpenHands(2026)
- Claude Code の権限: allow・ask・deny ルール、ルール構文、許可ツール
- Claude Code にすべてのコマンドを実行させる方法: 権限モード、allow ルール、権限スキップ
- Cursor にすべてのコマンドを実行させる方法: Run Everything、allowlist、sandbox
- Cursor ルールの設定: Project・User・Team Rules、.mdc frontmatter、globs、AGENTS.md
- Claude Code に MCP サーバーを追加する(claude mcp add、.mcp.json、スコープ)
- サブエージェントとカスタムエージェントの比較: Claude Code vs Codex vs Cursor vs Gemini CLI vs GitHub Copilot(2026)