Claude CodeはMCP(Model Context Protocol)を通じて、GitHubやデータベース、監視ダッシュボードなど数百種類の外部ツールやデータソースに接続できます。別のツールの内容をチャットに貼り付ける代わりに、Claudeがそのシステムを直接読み書きできるようになります。この記事では、MCPサーバーの追加方法、スコープ、設定ファイル、認証の要点を解説します。
MCPとは何か
MCP(Model Context Protocol)は、AIとツールを連携させるためのオープンソース標準です。MCPサーバーを接続すると、Claude Codeにツール・データベース・APIへのアクセスを与えられます。イシュートラッカーや監視ダッシュボードの内容を毎回チャットに貼り付けている場合が、接続を検討するサインです。
接続後は、たとえば次のような指示が可能になります。「JIRAのENG-4521に書かれた機能を実装してGitHubにPRを作成して」「PostgreSQLデータベースからこの機能を使った10人のユーザーのメールを探して」といった、複数ツールをまたぐ作業をClaudeが直接実行できます。
サーバーを追加する
サーバーの追加は claude mcp add コマンドで行います。トランスポート(接続方式)には主に3種類があります。
- stdio: ローカルで起動するコマンド型サーバー。
claude mcp add <name> -- <command> <args> - SSE / HTTP: リモートのURLに接続するサーバー。
claude mcp add --transport http <name> <url>
登録済みサーバーの一覧は claude mcp list、詳細は claude mcp get <name>、削除は claude mcp remove <name> で確認・管理できます。セッション内では /mcp コマンドから接続状態や認証を管理できます。
スコープと.mcp.json
MCPサーバーはスコープ(適用範囲)を指定して登録します。--scope フラグで切り替えます。
- local(既定): そのプロジェクトの自分だけに適用。
- project: プロジェクト直下の
.mcp.jsonに保存され、バージョン管理を通じてチームで共有される。 - user: 自分の全プロジェクトに適用。
project スコープで追加すると、リポジトリのルートに .mcp.json が作られます。これをコミットすることで、チームメンバー全員が同じMCPサーバー構成を共有できます。
認証とセキュリティ
多くのリモートサーバーはOAuthなどの認証を必要とします。/mcp コマンドを実行すると、各サーバーの認証状態を確認し、必要に応じてブラウザ経由で認証フローを開始できます。
プロジェクトの .mcp.json を初めて読み込むときは、信頼するかどうかの確認ダイアログが表示されます。信頼できないサーバーは接続しないでください。サードパーティのMCPサーバーはツール経由でClaudeに指示を与えうるため、出所の確認とアクセス権限の最小化を心がけます。
MCPツールの使い方
接続したサーバーが提供する機能は3種類に分かれます。ツール(Claudeが呼び出せるアクション)、リソース(読み取れるデータ)、プロンプト(定型の指示テンプレート)です。
ツールは通常のツールと同様に、Claudeがタスクに応じて自動的に呼び出します。MCPサーバー由来のプロンプトは / から始まるコマンドとして呼び出せる場合があります。まず1つのサーバーから始め、動作を確認しながら段階的に増やすのがおすすめです。詳細は公式のMCPクイックスタートを参照してください。