Claude Code MCP統合：エージェントにツールを接続する方法

Last updated: June 28, 2026

最初から、Claude Codeはファイルを読み取り編集し、シェルコマンドを実行できます。しかし、GitHubのIssueを読み取ったり、データベースにクエリを発行したり、ブラウザを操作することはできません。Model Context Protocol (MCP) はそのギャップを埋めます。これは、エージェントが外部ツールやデータと通信するための標準プラグです。本ガイドでは、正確な claude mcp add コマンド、ローカルサーバーとリモートサーバーのどちらを選ぶべきか、スコープの仕組み、接続する価値のあるサーバー、そして信頼する前に実行すべきセキュリティチェックについて解説します。

クイックアンサー：Claude CodeにMCPサーバーを追加する方法は？

claude mcp add コマンドを使用してサーバーを登録すると、Claude Codeはそのセッション中にそのツールを呼び出すことができるようになります。

マシン上でプロセスとして実行されるローカルサーバーの場合：

claude mcp add playwright -- npx -y @playwright/mcp@latest

HTTPS経由で到達するリモートサーバーの場合：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

サーバーを追加した後、Claude Code内で /mcp を実行して接続ステータスを確認し、OAuthサインインを完了してください。登録されたことを確認するには claude mcp list を使用します。公式のコマンドリファレンスは Claude Code MCP docs にあります。

MCPとは何か、なぜそれをClaude Codeに接続するのか？

MCPはAnthropicによって最初に公開されたオープンプロトコルであり、AIクライアントとツールサーバーがどのように機能を交換するかを定義しています。サーバーはツール（エージェントが実行できるアクション）、リソース（読み取り可能なデータ）、およびプロンプトを広告します。MCP対応のクライアントであれば、どのMCPサーバーでも使用できます。したがって、GitHubサーバーはカスタムの接着剤なしに、Claude Code、IDE、または別のエージェントで機能します。仕様とサーバーレジストリは modelcontextprotocol.io にあります。

実用的なメリット：Issueの内容をチャットに貼り付ける代わりに、GitHubサーバーを一度接続するだけで、エージェントに直接Issueの読み取り、ラベル付け、応答を依頼できます。プロトコル自体に関するより深い背景については、MCP explainer を参照し、ツール全体をコンテキストで使用する方法については Claude Code ultimate guide をご覧ください。

サーバーは、あなたが書いた小さなstdioスクリプトであることも、Dockerイメージであることも、ベンダーがホストするSaaSエンドポイントであることもあります。Claude Codeは、これらすべてをMCPを話す限り同じように扱います。

どのトランスポートを使用すべきか：ローカルかリモートか？

トランスポートとは、Claude Codeがサーバーに到達する方法です。ローカルサーバーはあなたのマシン上でstdio経由で実行され、リモートサーバーは別の場所で動作し、HTTPまたはSSE経由で応答します。選択は通常、データが存在する場所に依存します。

ツールがラップトップ上のファイルやサービス（例：プロジェクトアセットのフォルダ、localhost上のPostgresインスタンス）を必要とする場合は、ローカルstdioサーバーを使用してください。一方、ベンダーがすでにホストしている場合は、インストールをスキップし、設定に触れることなくアップデートを受け取れるため、リモートHTTPまたはSSEサーバーを使用します。リモートサーバーはほぼ常にOAuthを通じてサインインさせるため、これは/mcpメニューからトリガーします。

スコープの選択：local、project、それともuserか？

スコープは、サーバーを誰が見て、どこに設定が保存されるかを決定します。Claude Codeは3種類をサポートしており、適切なものを選ぶことで、チームと安全なサーバーを共有しながらも、秘密情報をリポジトリから排除できます。

スコープは --scope フラグで設定します。例：claude mcp add --scope project ... 。Project scopeはコミットされた .mcp.json を作成するため、生のトークンをそこに配置することは絶対に避けてください。代わりに環境変数を参照してください。Local scopeがデフォルトであり、共有することを決定する前に新しいサーバーをテストするための最も安全な場所です。また Claude Code skills も構築する場合、チームメイトがリポジトリをプルしたときに動作するように、サーバーのスコープとスキルのスコープを一致させてください。

claude mcp addでサーバーを追加する方法は？

すべてのサーバーについてパターンは同じです：名前、オプションのトランスポートフラグ、そしてコマンドまたはURL。-- 区切り文字はローカルコマンドとその引数の開始を示します。

エージェントが許可されたものしか触れないように、特定のフォルダにスコープを限定したローカルファイルシステムサーバーを追加する例：

claude mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem ~/projects/my-app

秘密情報をハードコーディングする代わりに環境変数として渡す例：

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

トランスポートとURLを持つリモートサーバーを追加する例：

claude mcp add --transport sse linear https://mcp.linear.app/sse

次に、管理を行います。

• claude mcp list は登録されているすべてのサーバーとそのステータスを表示します。
• claude mcp get <name> は特定のサーバーの設定を出力します。
• claude mcp remove <name> で未登録にします。
• /mcp (セッション内で入力) はライブ接続状態を表示し、OAuthを実行します。

フラグの使用法は公式ドキュメントに近づけてください。ベンダーは時々サーバーのパッケージ名やURLを変更するため、推測するのではなく、サーバー自身のREADMEから現在の値のコピーを使用してください。

接続する価値のある一般的なMCPサーバー

実際の面倒な作業を排除できるサーバーから始め、それを証明してから、さらに追加していきます。これらは開発者が最初に手を伸ばすもの、そしてそれぞれが何を提供するのかというものです。

Playwright MCP server はフロントエンド作業において際立っています。エージェントがページを開き、フローをたどり、何が壊れたかをスクリーンショットとともに報告します。データベースサーバーは読み取り専用のスキーマに関する質問に便利ですが、誤ったクエリが書き込みを行わないように、リードレプリカにスコープを設定してください。複数のサーバーを連携させ始める際は、メインセッションが応答性を保てるよう、重い作業をClaude Code subagents を使用して専用のワーカーにルーティングしてください。

シナリオ：GitHub MCPサーバーを接続してPRを開く

エージェントに、一つのリポジトリでIssueのトリアージとプルリクエストのオープンを行わせたいとします。GitHubは公式のリモートMCPサーバーをホストしているため、ローカルでのインストールは不要です。

1. ホストされたサーバーを登録します：

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/
   

2. Claude Code内で /mcp と入力し、github を選択して、ブラウザでOAuthサインインを完了します。トークンはGitHubに残ります。ファイルに貼り付けることはありません。

3. claude mcp list でツールがロードされたことを確認します。

4. 次に、平易な言葉で質問します：

   • 「ラベルが bug のオープンIssueを一覧表示し、上位3つを要約してください。」
   • 「fix/login-redirect から main へと短い説明付きのドラフトPRを開いてください。」
   • 「PR #214 を読み取り、認証に触れているものをフラグ付けしてください。」

エージェントはIssueスレッドを読み取り、PR本文を作成し、適切なIssueへのリンクをすべて行います。すべてターミナルから離れることなく完了します。最初にGitHubアプリに単一のリポジトリへのアクセス権限のみを与え、エージェントが提案する内容を確認してから、フローを信頼できる場合にのみアクセス範囲を広げてください。サーバーの完全なツールリストとセルフホスティングオプションは GitHub MCP server repo に文書化されています。

MCPサーバーを接続するのは安全か？

MCPサーバーは、あなたのマシン上でコードを実行したり、あなたの口座で操作を行ったりするため、それぞれを依存関係のインストールと同じように扱ってください。信頼できるサーバーのみを接続してください。リスクは現実的です。悪意のある、またはバグのあるサーバーがファイルを外部に漏洩させたり、認証情報を使って破壊的なアクションを起こす可能性があるからです。

サーバーを追加する前に、このチェックリストを実行してください：

• ソースを確認する。未知のパッケージよりも、公式ベンダーサーバー（GitHub, Sentry）または公開参照サーバーを優先する。
• どのようなツールを公開しているかを読む。「私のIssueを読み取る」サーバーが、ディスク全体への書き込みアクセスを要求すべきではない。
• スコープを厳密に設定する。ファイルシステムサーバーは単一のプロジェクトフォルダに、データベースサーバーはリードレプリカに指す。
• 秘密情報を .mcp.json から外す。環境変数を使用し、実際のトークンをコミットすることは絶対にしない。
• OAuthで最小権限を与える。信頼するまで、GitHubアプリには組織全体ではなく単一のリポジトリのみを与える。
• 承認前にアクションを確認する。エージェントが提案するPRやクエリを読み取り、新しいサーバーからの書き込みは自動承認しない。

Anthropicは、信頼できないウェブコンテンツを取得するサーバーに対してプロンプトインジェクションのリスクを指摘しているため、任意のページを取り込むすべてのサーバーには特に注意が必要です。現在のセキュリティガイダンスは Claude Code MCP docs にあります。

MCP接続のトラブルシューティング

ほとんどの失敗はプロトコルではなく、設定または認証の問題です。以下の順序で確認してください：

• サーバーがリストにない: claude mcp list を再実行する。もし欠落している場合は、add コマンドが失敗した可能性が高いため、-- 区切り文字やパッケージ名にタイプミスがないか確認してください。

• /mcp でステータスがfailedを示す: プロセスが開始できませんでした。stdioサーバーの場合、生のコマンド（例：npx の行）をターミナルで実行して実際のエラーを確認してください。

• 認証に失敗した: /mcp を開き、サーバーを選択し、OAuthフローをやり直します。トークンベースのサーバーの場合、Claude Codeを起動したシェルで環境変数が設定されていることを確認してください。

• ツールが表示されない: Claude Codeセッションを再起動してサーバー機能がリロードされるようにし、現在のプロジェクトから見えるスコープであることを検証してください。

• スコープが間違っている: --scope local で追加されたサーバーはチームメイトには表示されません。共有する必要がある場合は、--scope project で再追加してください。

リモートサーバーのURLが変更されたり、パッケージ名が変更されたりした場合、保存された設定は古くなります。盲目的に編集するのではなく、サーバー自身のREADMEから現在の値を取得して再追加してください。

要点まとめ

MCPは、Claude Codeをファイルとシェルエージェントから、実際のツールと対話できるエージェントへと変貌させます。claude mcp add でサーバーを追加し、ローカルデータにはstdioを、ホスト型サービスにはHTTP/SSEを選択し、誰が見るべきかによってスコープを設定します。まず一つ役立つサーバーを接続してください。GitHubサーバーは強力な出発点であり、信頼するまですべてのサーバーのソースと権限を確認してください。トークンは環境変数に保持し、ファイルシステムおよびデータベースへのアクセスは狭く限定し、新しいサーバーがその資格を得るまでエージェントのアクションをレビューしてください。