本文へスキップ
Kitbay

MCPサーバーをClaude、ChatGPT、Cursorに接続する方法

Kitbay編集部 ·

MCPサーバーを接続するには、自分のコンピューター上でサーバーを起動するコマンド(ローカルサーバー)か、オンラインでホストされているサーバーのURL(リモートサーバー)のどちらかをAIクライアントに渡します。この設定を置く場所はクライアントごとに異なります。Claude CodeとCodexではターミナルのコマンド、Claude Desktop、Cursor、VS CodeではJSONファイル、ChatGPTでは設定画面です。

このガイドでは、各クライアントがこの設定をどこに保存するかを説明します。基本についてはMCPサーバーとはを参照してください。

まずローカルかリモートかを決める

ローカルサーバー リモートサーバー
動作場所 自分のコンピューター(クライアントが起動する) プロバイダーのインフラ
トランスポート stdio(標準入出力) Streamable HTTP
用意するもの コマンド、その引数、必要な環境変数 URL(通常はその後にログイン)
アクセス範囲 自分のファイルとプログラム。権限は自分のユーザーアカウントと同じ サインインしたアカウントで許可されている範囲

MCPのドキュメントによると、ローカルのstdioサーバーは通常1つのクライアントだけに対応し、リモートサーバーは一般に多数のクライアントに対応します。サーバーがどちらの形式で提供されているかは、プロジェクトのREADMEに書かれています。Kitbayの設定ビルダーを使うと、1組の情報から複数のクライアント向けのスニペットを作成できます。

Claude Code

Claude Codeでは、ターミナルからサーバーを追加します。

# remote server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# local server; everything after -- is the server's own command
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

サーバーにはそれぞれスコープがあります。

  • local(デフォルト):自分だけが、このプロジェクトだけで使います。~/.claude.jsonに保存されます。
  • project:プロジェクトルートの.mcp.jsonを通じて共有します。このファイルはコミットします。Claude Codeは、このファイルにあるサーバーを使う前に承認を求めます。
  • user:自分だけが、すべてのプロジェクトで使います。~/.claude.jsonに保存されます。

スコープを変えるには--scope projectまたは--scope userを付けます。セッション内では、/mcpで状態を確認でき、認証が必要なリモートサーバーのOAuthサインインもここから始められます。一覧の管理にはclaude mcp listとclaude mcp remove <name>を使います。

Claude Desktop

Claude Desktopでは、ローカルサーバーとリモートサーバーを別々の場所で設定します。

ローカルサーバーはclaude_desktop_config.jsonに書きます。このファイルは、Settingsを開き、DeveloperタブでEdit Configを選ぶと開けます。

OS パス
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

保存したら、アプリを完全に終了してから再起動してください。パスは絶対パスで書きます。サーバーが表示されないときはログを確認してください。mcp.logとmcp-server-NAME.logは、macOSでは~/Library/Logs/Claudeに、WindowsとLinuxでは設定ファイルと同じ場所にあるlogsフォルダにあります。

リモートサーバーは、カスタムコネクタとして追加します。SettingsでConnectorsを開き、Add custom connectorを選んでURLを貼り付け、サインインを済ませます。同じ画面で、ツールを1つずつオン・オフすることもできます。

ChatGPT

ChatGPTが接続できるのは、ネットワーク経由でアクセスできるサーバーだけです。OpenAIのドキュメントでは、Web版のChatGPTでの手順を次のように説明しています。

  1. Pluginsページを開いてプラスボタンを選び、Add custom MCP serverを選びます。
  2. 名前とサーバーのURLを入力します。プライベートなサーバーの場合はトンネルを選びます。
  3. 認証方式を、OAuth、なし、ログインなしのフォールバック付きOAuthから選びます。
  4. リスクに関する警告を読んでからプラグインを作成し、インストールします。
  5. チャットで@を使ってサーバーをメンションすると、そのサーバーを使えます。

対応しているトランスポートはSSEとストリーミングHTTPです。ChatGPTはデフォルトで書き込み操作の前に確認を求め、サーバーが読み取り専用と示していないツールはすべて書き込み操作として扱います。ワークスペースの権限が適用され、使えるかどうかはプランによって異なる場合があります。現在の対象プランはOpenAIのページで確認できなかったため、ご自身のアカウント設定で確認してください。

Cursor

Cursorは2つのJSONファイルを読み込みます。

  • プロジェクト内の.cursor/mcp.json:そのプロジェクトだけで使うサーバー
  • ホームフォルダの~/.cursor/mcp.json:すべてのプロジェクトで使うサーバー
{
  "mcpServers": {
    "local-example": { "command": "npx", "args": ["-y", "some-mcp-server"], "env": { "API_KEY": "${env:API_KEY}" } },
    "remote-example": { "url": "https://example.com/mcp" }
  }
}

Cursorはstdio、SSE、Streamable HTTPに対応し、リモートサーバーではOAuthも使えます。デフォルトでは、MCPツールを実行する前に確認を求めます。確認画面を展開すると引数も確認できます。

VS Code

VS Codeでは、コマンドパレットからMCP: Add Serverを実行し、HTTPかstdioのコマンドを選んで、保存先を決めます。ファイルによってメインのキーが異なります。

ファイル メインのキー
.vscode/mcp.json(ワークスペース)またはプロファイルのmcp.json servers
ワークスペースのルートにある.mcp.json mcpServers
~/.copilot/mcp-config.json(ユーザー) mcpServers

VS Codeのリファレンスでは、エディターが管理するserversのファイルは旧来のハーネス向けとされ、新しくCopilotを設定する場合はmcpServersのファイルを使うよう案内されています。シークレットは共有ファイルに書き込まず、inputs機能(serversのファイルで使えます)で入力を求めるようにしてください。macOSとLinuxでは、"sandboxEnabled": trueを指定するとstdioサーバーをサンドボックス内で実行できます。

Codex

Codexは、サーバーの設定を~/.codex/config.tomlに保存します。信頼済みのプロジェクトでは、プロジェクト内の.codex/config.tomlにも保存できます。

codex mcp add context7 -- npx -y @upstash/context7-mcp
[mcp_servers.example]
url = "https://example.com/mcp"

codex mcp login <name>でOAuthを開始でき、ターミナルのインターフェースで/mcpを実行すると有効なサーバーの一覧が表示されます。ChatGPTのデスクトップアプリ、Codex CLI、IDE拡張機能は、この設定を共有しています。

その他のクライアント

Gemini CLIは、~/.gemini/settings.jsonまたは.gemini/settings.jsonのmcpServersブロックを使い、gemini mcp addコマンドも用意しています。trust: trueオプションを付けるとすべての確認が省略されるので、自分で管理しているサーバーだけに使ってください。Windsurf、Cline、Zedにはそれぞれ独自の設定があります。各クライアントのページを参照してください。

安全上の注意

ローカルサーバーは自分のユーザーアカウントの権限で動作し、自分がファイルに対してできることは何でもできます。リモートサーバーは、サインインしたアカウントの権限で動作します。ソースを確認したサーバーだけをインストールし、キーは共有ファイルではなく環境変数で管理してください。インストールの前に、MCPのセキュリティに関するチェックポイントにも目を通しておきましょう。

クライアント別にサーバーを探す

Kitbayの各MCPサーバーの掲載には、プロジェクト自身のドキュメントでどのクライアントへの対応が記載されているかを表示しています。自分でサーバーを作るなら、MCPサーバーの作り方を参照してください。

よくある質問

Claude DesktopにMCPサーバーを追加するには?
ローカルサーバーの場合は、Settings、Developer、Edit Configの順に開き、claude_desktop_config.jsonのmcpServersにサーバーを追加して、アプリを再起動します。リモートサーバーの場合は、SettingsのConnectorsで、サーバーのURLを指定してカスタムコネクタを追加します。
ChatGPTでローカルのMCPサーバーを使えますか?
OpenAIのドキュメントでは、URLかSecure MCP Tunnelを使ってサーバーを追加する方法が説明されています。そのため、自分のコンピューター上だけで動いているサーバーには、トンネルか公開されたHTTPSのアドレスが必要です。Web版のChatGPTは、ローカルのCodexの設定を読み込みません。
CursorのMCP設定ファイルはどこにありますか?
Cursorは、プロジェクト内の.cursor/mcp.jsonからそのプロジェクト用のサーバーを、ホームフォルダの~/.cursor/mcp.jsonからすべての場所で使えるサーバーを読み込みます。
Codex CLIとCodexのIDE拡張機能はMCPの設定を共有しますか?
はい。OpenAIのドキュメントによると、ChatGPTのデスクトップアプリ、Codex CLI、IDE拡張機能は同じMCPの設定を共有しており、デフォルトでは~/.codex/config.tomlに保存されます。

出典

ほかのガイド