Claude Code の MCP：サーバーの追加方法と設定の保存場所

Claude Code に MCP サーバーを追加する方法

1. トランスポートを選ぶ

   クラウドでホストされたリモートサーバーには HTTP を使います。これが推奨のトランスポートで、サーバーが非推奨の SSE トランスポートしか提供していない場合、Claude Code は SSE にフォールバックします。ローカルプロセスとして動くサーバーには stdio を使います。stdio では、-- より後ろはすべてそのままサーバーに渡されます。

   # Remote HTTP server (recommended for cloud services)
   claude mcp add --transport http notion https://mcp.notion.com/mcp
   
   # With a bearer token
   claude mcp add --transport http secure-api https://api.example.com/mcp \
     --header "Authorization: Bearer your-token"
   
   # Local stdio 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

2. スコープを選ぶ

   --scope を付けなければ、サーバーは local スコープになります（自分だけ、このプロジェクトだけ）。--scope project を付けるとチーム用に .mcp.json に書き込まれ、--scope user を付けると自分のすべてのプロジェクトで使えます。詳しくは下の表を参照してください。

3. 必要ならサインインする

   多くのリモートサーバーは OAuth を使います。Claude Code の中で /mcp を実行して認証するサーバーを選ぶか、シェルで claude mcp login <name> を実行します。ヘッドレスの -p 実行ではサインインフローを開けないので、先に対話モードでサインインしておきましょう。

4. 接続を確認する

   /mcp で各サーバーの状態とツールを確認し、シェルでは claude mcp list を実行します。そのうえで、ツール名を指定して Claude に使ってもらいます。

5. サーバーを管理する

   コマンドラインからサーバーの一覧表示、詳細確認、削除、インポートができます。あまり使わないサーバーは削除せず、/mcp から無効化できます。

   claude mcp list            # every configured server
   claude mcp get notion      # one server's details
   claude mcp remove notion   # remove it (run claude mcp logout notion first to revoke tokens)
   claude mcp add-from-claude-desktop   # import from Claude Desktop (macOS, WSL)

出典：Claude Code ドキュメント、Connect Claude Code to tools via MCP

MCP のスコープと設定ファイルの場所

Claude Code は MCP の設定を次の場所に保存します。MCP の local スコープは .claude/settings.local.json ではなく ~/.claude.json に保存される点に注意してください。

.mcp.json でサーバーを共有する

.mcp.json を使えば、チーム全員が同じサーバーを使えます。シークレットは環境変数でファイルの外に出しておきましょう。${VAR} は変数の値に展開され、${VAR:-default} は変数が未設定のときデフォルト値を使います。展開は command、args、env、url、headers で有効です。

1. シークレットの代わりに変数を参照する

   .mcp.json のプロジェクトサーバーは、初回に各メンバーへ承認を求めます。claude mcp reset-project-choices でその回答をリセットできます。url を持つ JSON エントリには、http などの type も必要です。

   {
     "mcpServers": {
       "api-server": {
         "type": "http",
         "url": "${API_BASE_URL:-https://api.example.com}/mcp",
         "headers": {
           "Authorization": "Bearer ${API_KEY}"
         }
       }
     }
   }

優先順位、コネクタ、その他の細かい点

• 同じサーバーが 2 回定義されている場合、Claude Code は 1 回だけ接続し、local、project、user、プラグイン、claude.ai コネクタの順で最初に見つかったものを使います。エントリはマージされません。組織の管理対象サーバーはこれらすべてより優先されます。
• claude.ai アカウントで Claude Code にサインインしていれば、claude.ai で追加したコネクタが自動で表示されます。
• Claude Code 自体も MCP サーバーになれます。claude mcp serve で、Claude Desktop などほかのクライアントにツールを公開できます。
• サーバーはスラッシュコマンドとして表示されるプロンプトを提供することもあります。Claude Code のスラッシュコマンドを参照してください。
• リモートサーバーを削除すると、Claude Code が保存したトークンは消えますが、失効はしません。失効させるには、先に claude mcp logout <name> を実行します。

MCP とトークン使用量

ツール定義はデフォルトで遅延読み込みされます。Claude がツールを使うまで、コンテキストに入るのはツール名とサーバーの説明だけなので、サーバーを多数並べても以前ほどコストはかかりません。それでもサーバーごとに少しずつ増えるので、使わないものは /mcp で無効化し、gh、aws、gcloud のような CLI があればそちらを優先しましょう。CLI ならツール一覧はまったく増えません。詳しくは Claude Code のトークン使用量を減らす方法をご覧ください。

トラブルシューティング：サーバーがつながらないとき

• 認証が必要と表示される：/mcp を開いて Re-authenticate を選ぶか、claude mcp login <name> を実行します。
• "has a url but no type" と出る：JSON エントリに "type": "http"（または sse、ws）を追加します。type がないと Claude Code は stdio として扱います。
• stdio サーバーのフラグが消えた：サーバーのコマンドの前に -- を置き、Claude Code が自分のフラグとして解釈しないようにします。
• claude mcp list に変数がないという警告が出る：その変数を設定するか、:-default でデフォルト値を与えます。
• プロジェクトサーバーが claude -p で読み込まれない：ヘッドレスでは承認プロンプトが出ないので、設定を確認するか、--mcp-config と --strict-mcp-config でサーバーを明示的に渡します。
• claude mcp で追加するサーバー名には、英字、数字、ハイフン、アンダースコアしか使えません。

AI 社員にも、あなたと同じツールを

Claude Code が issue トラッカーやデータベース、分析ツールにアクセスする手段が MCP です。Crewmark は、Claude Code、Codex、DeepSeek Harness、OpenCode のセッションを、職種・目標・勤務時間を持つ AI 社員に変え、ハートビートで起こしてボードから次の issue を取らせます。プロジェクトの MCP サーバーも使える状態です。

1. .mcp.json をコミットする

   project スコープのサーバーは、あなたのセッションと同じように社員のセッションでも読み込まれます。OAuth が必要なサーバーは、一度だけ対話モードでサインインしておきます。

2. ハートビートで仕事を始めさせる

   勤務時間中、社員は 15 分、30 分、60 分ごとに同じ会話の中で起きます。Claude Code を能動的に動かす方法を参照してください。

3. 職種ごとに必要なものだけを渡す

   SEO 担当の社員には Search Console を、プログラマーには GitHub と Sentry を。AI 社員とはをお読みください。

Claude Code の MCP のよくある質問