MCP servers (MCP サーバー)

MCP サーバーを接続すると、Claude Code は手元のツール、データベース、API にアクセスできます。Claude は貼り付けられた内容をもとに作業するのではなく、接続先のシステムを直接読み取り、操作します。

接続先の種類によって、追加の方法が分かれます。

• リモートの MCP サーバーへの接続は、HTTP サーバーが推奨の方法です。
• stdio サーバーは手元のマシンでローカルのプロセスとして動き、システムへの直接のアクセスや独自のスクリプトを必要とするツールに向いています。
• WebSocket サーバーは .mcp.json か claude mcp add-json で設定します。
• Anthropic Directory に載っているリモートサーバーは、Claude Code と同じ MCP の基盤を使うため、claude mcp add で追加できます。
• プラグインは MCP サーバーを同梱でき、プラグインを有効にすると Claude Code がその MCP サーバーを自動で起動します。

追加したサーバーは、Claude Code 内の /mcp などで管理し、状態を確認できます。claude mcp list は各サーバーの横に ✔ Connected・! Needs authentication・✘ Failed to connect などの状態を表示します。/mcp パネルでサーバーをオフに切り替えると、設定を残したまま接続を止められます。VS Code 拡張では、MCP servers ダイアログの Add server (サーバー追加) フォームと Remove (削除) 操作で、IDE を離れずにサーバーを追加・削除できます。

また、Claude Code 自体を stdio の MCP サーバーとして動かし、他のアプリケーションから接続させることもできます。

クラウド型の MCP サーバーの多くは認証を必要とし、Claude Code は OAuth 2.0 に対応しています。/mcp から認証するほか、claude mcp login <name> と claude mcp logout <name> で、対話型の /mcp メニューを開かずに CLI から認証を扱えます。

Kerberos、短時間で失効するトークン、社内 SSO など、接続時にヘッダーを生成する必要がある認証には、サーバーの headersHelper にコマンドを設定します。

ヘッドレス環境では、MCP OAuth はブラウザのポップアップを省き、URL を貼り付けるプロンプトに直接進みます。ツール呼び出しの途中でサーバーが追加の OAuth スコープを求めた場合は、再認証を促すプロンプトが表示されます。

• ツール検索 (tool search) は、ツールの定義を Claude が必要とするまで読み込まず、セッション開始時にはツール名とサーバーの指示だけを読み込みます。これにより MCP によるコンテキストの使用量を低く抑えます。サーバー設定の alwaysLoad を true にすると、そのサーバーの全ツールは遅延読み込みを経ずに常に利用可能です。
• 対話型のターミナルセッションでは、接続中のサーバーのツール一覧が変わったという通知を受けると、Claude Code は再接続しなくても更新後の一覧を取得します。
• メインの会話で 2 分を過ぎても実行中の MCP ツール呼び出しは、セッションを止めずにバックグラウンドのタスクに移ります。閾値の変更や無効化は CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS で行います。
• MCP サーバーが公開するリソースは、ファイルと同じように @ メンションで参照できます。プロンプトに @ を入力すると、接続中の全サーバーのリソースがファイルと並んで補完メニューに表示されます。
• サーバーが自力で得られない情報を作業の途中で求める場合 (elicitation)、Claude Code はターミナルに対話型のダイアログを表示し、回答をサーバーに返します。

• 対話セッションでは、.mcp.json のプロジェクトスコープのサーバーを使う前に、セキュリティ上の理由から Claude Code が承認を求めます。
• .mcp.json では環境変数の展開が使えます。マシンごとのパスや API キーのような機密の値を分けたまま、チームで設定を共有できます。
• 管理設定 managedMcpServers で、組織が HTTP/SSE の MCP サーバーを全ユーザーに提供できます。エントリの形は .mcp.json と同じで、実行するコマンドを指定したエントリはスキップされます。
• claude.ai アカウントで Claude Code にログインしている場合、claude.ai で追加したコネクタ (MCP サーバー) が Claude Code でも自動で使えます。Claude Code が取得する claude.ai コネクタは、設定で無効にできます。また、ANTHROPIC_API_KEY・apiKeyHelper・ANTHROPIC_AUTH_TOKEN のいずれかを設定している場合は、Claude.ai へのログインがあっても claude.ai MCP コネクタは無効です。
• Claude Code で設定した MCP サーバーは、クラウドのルーティンに添付できません。
• MCP の接続と OAuth のデバッグ・エラーログでは、サーバーの URL やリクエストヘッダーに含まれる認証情報が伏せ字になります。
• 対象となるプランは、公式のリリースノートには記載がありません。

あらかじめ用意した OAuth アプリの資格情報を使って、リモートの MCP サーバーを追加し認証する流れです。

1. 接続したいサーバーの開発者向けポータルで OAuth アプリを作成し、client ID と client secret を控えます。
2. claude mcp add でサーバーを追加します。--client-id でアプリの client ID を渡し、--client-secret を付けると secret の入力を伏せ字で求められます。
3. Claude Code で /mcp を実行し、ブラウザでのログインの流れに従います。