Claude Codeに外部ツールを繋ぐMCP: 設定方法と使い方
この記事では、Claude Code に外部ツールを接続するための MCP(Model Context Protocol)について解説します。MCP を使うことで、GitHub や Notion などのサービスと Claude Code が直接やり取りできるようになり、より強力なAI活用が可能になります。
まず、MCP とはオープンソース標準で、AI ツールと外部サービスを繋ぐための仕組みです。Claude Code 自体はファイルの読み書きやターミナルコマンド実行しかできませんが、MCP を使うことで「GitHub の Issue を読む手」「Notion のページを取得する手」「データベースにクエリを投げる手」などの機能を追加できます。
MCP 接続には HTTP方式(URL指定)、stdio方式(ローカルプログラム起動)、SSE方式(古い方式)の3つの方法があります。HTTP方式が最も簡単で、GitHub や Notion など多くのサービスに対応しています。
MCP サーバーを追加するには `claude mcp add` コマンドを使います。--transport オプションで接続方式を選び、サーバー名と URL またはコマンドを指定します。スコープオプションで設定の範囲(個人用、プロジェクト共有など)も指定できます。認証情報は HTTP方式は OAuth 2.0 で自動処理され、stdio方式は環境変数に渡すことで管理します。
MCP を使うには、まず Claude Code を再起動する必要があります。接続状態を確認するには `/mcp` コマンドを使います。設定ファイルの内容を確認したい場合は `claude mcp list` コマンドを使用します。
チームで MCP を共有する場合、プロジェクトルートに `.mcp.json` ファイルを作成して Git にコミットします。認証情報は環境変数を参照するように設定することで、APIキーを直接 .mcp.json に書き込まない安全な方法になります。
MCP は Claude Code の機能を大きく拡張する強力なツールです。GitHub や Notion などのサービスから始め、様々な外部ツールと連携させて AI を活用してみてください。
背景
MCP(Model Context Protocol)は、AI ツールと外部サービスを接続するためのオープンソース標準です。Claude Code は単体でもファイル操作やコマンド実行ができますが、MCP を使うことで GitHub や Notion などのサービスと連携し、より高度なタスクを実行できるようになります。
重要用語解説
**MCP(Model Context Protocol)**: AI ツールと外部サービスを接続するためのオープンソース標準です。
**HTTP方式**: URL を指定して MCP サーバーに接続する方法。最も簡単で多くのサービスに対応しています。
**stdio方式**: ローカルにプログラムを起動して MCP サーバーと直接通信する方法。データベース操作など、ローカルリソースへのアクセスが必要な場合に利用します。
**SSE方式**: 古い方式で、新規では使わないようにしましょう。
**スコープ**: MCP 設定の有効範囲(個人用、プロジェクト共有など)。
**OAuth 2.0**: HTTP方式で認証を行うための標準的な方法。
今後の影響
MCP は Claude Code の機能を大きく拡張し、外部サービスとの連携によりより高度なタスク実行が可能になります。チーム開発においても、共通の MCP 設定を共有することで効率性を向上させることができます。