MCPとは?

Model Context Protocol(MCP)は、AIアシスタントがサーバーを通じてツールやデータを利用できるようにするオープン標準です。サーバーには、アシスタントがコンピューター上で起動し、標準入出力(stdio)で通信するローカルプログラムと、アシスタントがHTTP経由で接続するリモートサーバーの2種類があります。アシスタントはそれぞれ独自の設定ファイルにサーバーを登録しており、ファイルの書き方も少しずつ異なります。

使い方

  1. クライアント(使用しているアシスタントまたはエディター)を選びます。
  2. 英字、数字、ハイフン、アンダースコアを使って、サーバーに名前を付けます。
  3. ローカルサーバーの場合は、サーバーを起動するコマンド(npx、uvx、dockerなど)と、その引数を1行に1つずつ入力し、APIキーなどの環境変数があればKEY=valueの形式で入力します。コマンド欄にコマンドライン全体を貼り付けた場合は、欄内の分割ボタンを押すと、最初の単語より後ろがすべて引数に移動します。
  4. リモートサーバーの場合は、リモートURLを選び、サーバーのURLと、Authorization: Bearer <token>などのヘッダーを入力します。
  5. 設定をコピーして設定先に表示されたファイルに貼り付けるか、ダウンロードします。ファイルにすでにサーバーがある場合は、ファイル全体を置き換えるのではなく、mcpServers(Codexでは[mcp_servers])の中の既存のエントリーの隣に新しいエントリーを追加します。
  6. アプリを再起動するか、MCPサーバーを再読み込みします。

Claude Code、Codex CLI、Gemini CLI、VS Codeの場合は、コマンド欄に、サーバーを追加するためのターミナルコマンドも表示されます。

クライアント

クライアント 設定ファイル 補足
Claude Desktop claude_desktop_config.json ローカルサーバーのみを登録できます。リモートサーバーは、アプリの「設定 > コネクター > カスタムコネクターを追加」から追加します。
Claude Code プロジェクトのルートにある.mcp.json claude mcp addを使うと、代わりに~/.claude.jsonにサーバーが保存され、自分だけが使えるようになります。
Cursor プロジェクト内の.cursor/mcp.json、または~/.cursor/mcp.json
VS Code(GitHub Copilot) ワークスペースのルートにある.mcp.json、または~/.copilot/mcp-config.json .vscode/mcp.jsonの古いservers形式は、VS Codeの非推奨となったローカルハーネス専用です。
Codex CLI ~/.codex/config.toml TOMLファイルです。リモートサーバーのヘッダーは、codex mcp addでは設定できず、ファイルでのみ設定できます。
Gemini CLI プロジェクト内の.gemini/settings.json、または~/.gemini/settings.json リモートサーバーにはhttpUrlを使います。
Devin Desktop(Windsurf) ~/.config/devin/mcp_config.json、または.devin/mcp_config.json WindsurfはDevin Desktopに名称が変わりました。個人用のキーは、バージョン管理の対象外となる.devin/mcp_config.local.jsonに書きます。

Chromeは.mcp.jsonという名前のダウンロードをmcp.jsonとして保存するため、所定の場所に移動するときに先頭のドットを付け直してください。

キーを安全に保つ

設定ファイルには、APIキーがプレーンテキストで保存されます。実際のキーを含むプロジェクトファイルを、共有リポジトリにコミットしないでください。ほとんどのクライアントは、ファイルの代わりに環境変数からキーを読み取れます。構文はクライアントごとに異なり、各クライアントのドキュメントで説明されています。

すべてブラウザー内で組み立てられるため、入力したコマンド、URL、キーがどこかに送信されることはありません。