MCP とは：Claude Code が外部ツールやデータに接続する仕組み
MCP（Model Context Protocol）は、AI アプリケーションを外部ツールやデータソースに接続するためのプロトコルです。Claude Code では、MCP サーバーを設定すると、Claude は会話中に必要に応じてそのサーバーが提供する機能を呼び出せるようになります。たとえば、外部データの検索や特定の操作の実行が可能です。MCP によって Claude が自動的に任意のシステム権限を得るわけではありません。何ができるかは、サーバーが公開するツール、設定された認証情報、および付与したアクセス範囲によって決まります。
MCP 接続は、3つの要素から成ると考えることができます。Claude Code はクライアント、MCP サーバーはツールを提供する役割を担い、ツール呼び出しではセッション内でリクエストと結果がやり取りされます。サーバーはローカルプロセス通信を利用する場合も、HTTP などを介して接続する場合もあります。どの方式を採用するかは、サーバーのデプロイ方法と接続手順によって異なります。
初めて利用する方は、まず重要な点を押さえておきましょう。MCP のインストールは通常、Claude Code のプラグインをインストールすることではなく、Claude Code にサービスの起動方法または接続先を知らせることです。設定が完了すると、Claude Code はサーバーが提供するツールを検出し、必要に応じて呼び出せるようになります。
MCP の初回インストール：接続方法、適用範囲、接続の確認
使用する前に、Claude Code がインストールされており、ターミナルで claude を実行できることを確認してください。初回設定では、サービス提供元のドキュメントに記載された接続コマンドまたは設定例を優先し、起動パラメーター、アドレス、認証方式をむやみに置き換えないでください。サーバーによっては、異なるランタイム、環境変数、認証手順が必要な場合があります。
一般的なインストール方法は、コマンドラインから MCP サーバーを追加することです。以下の例はパラメーターの構成を示しています。<起動コマンド>、<パラメーター>、<サービスアドレス> はすべてプレースホルダーであり、該当するサーバーのドキュメントに記載された実際の内容に置き換える必要があります。
# 添加通过本地进程启动的服务器
claude mcp add --transport stdio --scope user my-server -- <启动命令> <参数>
# 添加通过 HTTP 连接的服务器
claude mcp add --transport http --scope user my-server <服务地址>
--transport は接続タイプを指定し、--scope は設定の適用範囲を指定します。一般的な範囲は次のとおりです。
| 適用範囲 | 用途 |
|---|---|
local | 現在のプロジェクトだけで使用し、設定を他のプロジェクトメンバーと共有しない場合 |
project | 設定をプロジェクトに書き込み、共同作業メンバーと共有できます。コミットする前に、設定に機密情報が含まれていないか確認してください |
user | 現在のユーザーが複数のプロジェクトで使用する場合 |
初めて使用する場合は、個人の認証情報やローカルマシンのパスをプロジェクト設定に書き込まずに済むよう、まず user を検討してください。チームで接続設定を共有する場合は、project を検討できます。ただし、キーは環境変数などの安全な方法で指定し、バージョン管理リポジトリに直接コミットしないでください。
追加後、次のコマンドで設定を確認してから、Claude Code のセッションを開始できます。
claude mcp list
claude mcp get my-server
Claude Code を起動したら、/mcp を使って接続状態を確認してください。サービスによっては OAuth 認証が必要です。画面の案内に従って認証を完了し、接続が正常に表示されたら、範囲が明確で破壊的な操作を伴わないリクエストを試し、対応するツールが検出され、呼び出せるか確認してください。サーバーに特定の環境変数が必要な場合は、追加時にコマンドパラメーターで設定できます。具体的な構文は、使用中のバージョンの claude mcp add --help を確認してください。
MCP 設定の管理：確認、変更、トラブルシューティング、安全上の注意
MCP を管理する際は、まず Claude Code が実際にどの設定を読み込んでいるか確認してください。適用範囲によって設定の保存場所や共有方法が異なり、同じ名前のサーバーが複数の範囲に別々に存在する場合もあります。claude mcp list で登録済みのサーバーを確認し、claude mcp get <名称> で個別項目の設定を確認してから、対象の範囲に応じて変更または再追加してください。ほかのプロジェクトの接続設定を誤って変更しないように注意しましょう。
接続に失敗した場合は、次の順に確認してください。
- サーバーアドレス、起動コマンド、パラメーターがサービスのドキュメントと一致していることを確認します。
- 必要なランタイムがインストールされていることと、現在のターミナルから該当するコマンドを実行できることを確認します。
- 環境変数、アクセストークン、認証状態を確認します。キーを公開ログやコミット記録に貼り付けないでください。
/mcpに表示される状態とエラーメッセージを再確認し、Claude Code が設定を再読み込みしたか確認します。- サービスに接続できてもツールを利用できない場合は、サーバーが実際にツールを公開しているか、現在のリクエストがそのツールで処理できる内容かを確認します。
MCP サーバーは送信されたリクエストを受け取ります。一部のツールは、ファイルの読み取り、データの変更、外部操作の実行を行う場合もあります。追加する前に、サービスの提供元が信頼できること、権限が想定どおりであること、およびアクセス可能なリソースの範囲を確認してください。ファイルアクセスを行うサービスでは、タスクに必要なディレクトリだけを公開するようにしてください。書き込みや実行の機能を持つツールについては、呼び出す前に操作対象と影響を確認しましょう。
アンインストールとクリーンアップ：サーバー設定と関連する認証情報の削除
サーバーが不要になった場合は、次を実行します。
claude mcp remove my-server
同じ名前の項目が複数の適用範囲に存在する場合は、まず claude mcp list で削除対象の設定を確認し、使用中の Claude Code バージョンでサポートされているパラメーターを指定して範囲を選んでください。名前だけで、どの設定が削除されるかを判断しないでください。削除後、リストを再確認し、Claude Code で /mcp を使って接続が表示されなくなったことを確認してください。
設定をアンインストールしても、サーバーソフトウェアや外部の認証情報が必ず削除されるとは限りません。パッケージマネージャー、コンテナー、または単独のプログラムを通じてインストールしたサーバーは、それぞれのドキュメントに従ってアンインストールする必要があります。トークン、環境変数、OAuth 認証を設定したことがある場合は、サービス提供元の手順に従って認証情報を失効またはローテーションしてください。プロジェクト単位の設定についても、バージョン管理の状態を確認し、不要になったファイルや機密情報がリポジトリに残っていないことを確かめてください。
MCP によるコンテキストの使用：ツール定義、呼び出し結果、必要に応じた読み込み
MCP がコンテキストに与える影響は、主にツール定義とツール呼び出しの結果の2つから生じます。ツール定義には通常、名前、用途、パラメーターの説明などが含まれます。サーバーやツールの数が多く、説明が長いほど、利用可能な機能を判断するために Claude が処理する情報も増える可能性があります。ツールを呼び出すと、返されたデータも会話のコンテキストに加わります。一度に大量のログ、ファイル内容、レコードが返されると、ツール定義が短くてもコンテキストの負担が大きくなる場合があります。
必要に応じた読み込みが行われるかどうかは、Claude Code のバージョンとツール検出の仕組みによって異なります。一部のバージョンでは、ツール数が多いときに遅延検出や検索方式を採用し、最初に提示するツール情報を減らすことがあります。ただし、これはツール呼び出しの結果がコンテキストを使用しないという意味ではなく、すべての MCP サーバーが同じ仕組みに対応しているという意味でもありません。ローカルのバージョンでの実際の動作を確認し、「設定しただけで、使用していなければ完全に負荷ゼロ」とは想定しないでください。
/context を使うと、現在のセッションでのコンテキスト使用状況を確認できます。ツールが返す内容が長すぎないかにも注意してください。コンテキストの圧縮や新しいセッションの開始で、蓄積した負荷が軽減されることはありますが、ツール出力を制御する代わりにはなりません。より効果的なのは、不要なサーバーやツールを減らし、クエリの範囲を絞り、タスクの完了に必要な情報だけをツールに返させることです。
実践的な使い方：ツールを選び、出力を制御してワークフローの効率を高める
Claude Code で初めて MCP をインストールする場合は、用途が明確で権限の範囲が小さいサーバーから始めることをおすすめします。まず接続を確認し、次に単一の読み取り専用操作をテストしてから、データを書き込んだり変更したりする可能性のある機能を試してください。こうすることで、問題の原因が設定、認可、それともツール自体にあるのかを切り分けやすくなります。
質問するときは、対象範囲も明確に伝えましょう。たとえば、「データを調べて」とだけ伝えるのではなく、照会対象、期間、必要なフィールド、書き込み操作を許可するかどうかを説明してください。返却内容が多いタスクでは、まず要約を求める、指定したフィールドのみを返すよう依頼する、ページネーションやフィルター条件を指定して照会するといった方法があります。実際に反映されるかどうかは、サーバーのツールが該当するパラメーターを提供しているかどうかによります。
日常的なメンテナンスでは、次の習慣を心がけましょう。
- 作業シーンに応じて必要最小限のサーバーを設定し、「いつか使うかもしれない」という理由で一度に多くのツールを追加しないでください。
- 個人用の設定とチームで共有する設定を分け、ローカルのパスや認証情報がプロジェクトファイルに含まれないようにしてください。
- 書き込み、削除、外部への送信などの操作では、まず Claude に計画を説明させてから、実行を確認してください。
- 接続に問題が起きたら、まず設定と認可を確認してください。キーを何度も貼り付けたり、むやみに再インストールしたりしないでください。
- タスクの終了後、使用しなくなった接続を削除し、無効になったトークンを整理してください。
MCP の価値は、Claude Code を適切な外部機能に接続することにあり、接続数を増やすことではありません。信頼できるサービスと最小限の権限から始め、呼び出し結果とコンテキストの負荷を確認してから段階的に拡張するのが、より安全な始め方です。