Claude Code MCPとは？仕組み・設定手順とチームで安全に使うための考え方

Claude Code MCPとは何か

MCP（Model Context Protocol）とは、Claudeのようなアシスタントが外部のデータやツールに接続するための共通規格です。Claude Code自体の基本的な使い方をまだ把握していない場合は、先にClaude Codeとは何かを確認しておくと、この先の説明が理解しやすくなります。

MCPの構造は、Host・Client・Serverという3つの要素で説明されます。Host（Claude Code本体）がClientを介して、外部のMCP Serverと通信する形です。Serverが提供する機能は、大きく分けてTools（実行可能な操作）・Resources（参照可能なデータ）・Prompts（あらかじめ定義された指示テンプレート）の3種類です。

この規格はClaude Code専用のものではなく、Claude Desktopなど他のクライアントでも同じ規格が採用されています。ただし、クライアントごとに対応している機能の範囲や設定方法には差があり、ここでは独自の解釈や比喩を加えず、公式に確認できる定義の範囲にとどめます。

MCPで具体的に何ができるようになるか

Claude Codeは素の状態でもファイル操作やコード生成に強みがありますが、外部サービスとのやり取りや、リアルタイムの情報取得はできません。MCPはこの隙間を埋める役割を果たします。用途は大きく3つのカテゴリに整理できます。

情報を取得する: 社内システムやWeb上のデータを参照する。例として、ブラウザ操作を伴うPlaywright系のMCPサーバーが挙げられます。
外部サービスを操作する: コード管理やタスク管理サービスに対して、参照だけでなく更新も行う。例としてGitHub連携のMCPサーバーが該当します。
ドキュメント・仕様を参照する: ライブラリのAPI仕様など、最新のドキュメントを検索して回答に反映する。例としてContext7のようなドキュメント検索系サーバーがあります。

個別サーバーの一覧を網羅することよりも、自分の用途がこの3カテゴリのどれに当たるかを考える方が、長く使える判断軸になります。個別サービスは仕様変更や終了もあり得るため、まずはカテゴリで理解しておくのが実用的です。

導入前に知っておきたい通信方式とスコープの考え方

stdio接続とリモート接続（Streamable HTTP）の違い

MCPサーバーとの通信方式には、大きく分けて2種類あります。1つはstdio接続で、ローカルのプロセスとしてサーバーを起動し、標準入出力を介してやり取りする方式です。もう1つはリモート接続（Streamable HTTPなど）で、ネットワーク越しに動作しているサーバーに、多くの場合OAuthなどの認証を伴って接続します。OAuth認証の具体的な設定手順は公式ドキュメントに譲り、ここでは「ローカルで完結するか、外部の認証を経由するか」という違いだけ押さえておけば十分です。

local / project / user スコープと優先順位

MCPサーバーの設定は、3つのスコープのいずれかに紐づけて登録します。

local: 自分の環境だけで有効になる個人設定
project: プロジェクト内で共有される設定（.mcp.jsonに記録）
user: 自分が使うすべてのプロジェクトに適用される設定

同じ名前のサーバーが複数のスコープで定義された場合、どちらを優先するかはClaude Codeの仕様に従います。実際の優先順位は変更される可能性もあるため、迷った場合は公式ドキュメントの「スコープの優先順位」に関する記載を確認してください。プロジェクト単位の設定ファイルという観点では、CLAUDE.mdの書き方ガイドも合わせて読むと、プロジェクト設定全体の考え方を横断的に把握できます。

ここで重要なのは、localは個人検証向け、projectはチーム共有向け、という使い分けの軸です。この判断が、後述するチーム運用のルール整備にもつながります。

設定の基本手順

コマンドでサーバーを追加する

MCPサーバーを追加する基本コマンドは次の形です。

claude mcp add <サーバー名> -- <起動コマンド>

追加後は、以下のコマンドで登録状況と接続状態を確認します。

claude mcp list

一覧に表示されたサーバーが正しく接続できているかは、Claude Code内でMCP関連の操作を試してみることで確認できます。

`.mcp.json`で設定を管理する

projectスコープで登録したMCPサーバーの設定は、プロジェクトルートの.mcp.jsonに記録されます。このファイルを手動で編集する場合は、JSON構文の誤りやサーバー名の重複に注意してください。個別サーバーの詳細な設定項目まで覚える必要はなく、まずは1つ動かしてみることを優先しましょう。

チームで使うためのガバナンス設計（運用プロセス）

個人での検証が済み、チームで.mcp.jsonを共有する段階に入ると、技術的な設定だけでなく運用ルールを決めておく必要が出てきます。ここで整理する3点は、いずれも「誰が何を決めるか」というプロセスの話であり、次章で扱う技術的なリスク評価とは切り分けて考えます。

どのMCPサーバーを使ってよいか、誰が承認するか

新しいMCPサーバーを使いたいというメンバーが出てきたとき、誰が利用可否を判断するのかをあらかじめ決めておきます。チームリードが判断する、情報システム部門への申請を経る、といった役割分担を明文化しておくことで、判断の属人化を防げます。

`.mcp.json`のGit管理とレビュー体制

プロジェクト共有用の.mcp.jsonをリポジトリに含める場合、通常のコード変更と同様にレビューの対象にします。新しいサーバーの追加や起動コマンドの変更があった際は、何のためにそのサーバーを使うのか、どんな権限を外部に渡すことになるのかをレビュー時に確認する運用にしておきます。

新しいメンバーへの展開と教育

チームにMCPが定着してくると、新しく加わったメンバーへの説明が必要になります。利用可能なサーバーの一覧、新しいサーバーを使いたいときの申請フロー、避けるべき使い方の3点は、オンボーディング資料に最低限含めておきたい内容です。組織全体でのルール整備がまだの場合は、Claude Codeの運用ルールに関する記事で権限設計の考え方を、組織的な展開の実務についてはClaude Code導入における社内稟議の進め方を参考にしてください。

セキュリティ・技術的リスクの考え方

前章が「誰が承認するか」という運用プロセスの話だったのに対し、本章では「MCPサーバーに接続すること自体にどんな技術的リスクがあるか」を扱います。役割が異なる2つの論点として、分けて理解しておくと整理しやすくなります。

信頼できないMCPサーバー接続のリスク

外部のツールやデータに接続するということは、そこから返ってくる情報が意図しない指示を含んでいる可能性(いわゆるプロンプトインジェクション)を考慮する必要があるということでもあります。出所が不明なMCPサーバーや、更新が止まっているサーバーを安易に追加しないことが、基本的な防御になります。

シークレット・認証情報の扱い

APIキーやトークンを.mcp.jsonに直接書き込むと、リポジトリで共有した際にそのまま漏れてしまいます。環境変数を参照する形にする、シークレット管理の仕組みを別途用意するなど、設定ファイルに機微な値を残さない工夫が必要です。セキュリティ要件が厳しい組織では、Claude Codeのエンタープライズセキュリティガイドで体系的な論点を確認することをおすすめします。

つまずきやすいポイントの整理

MCP関連のトラブルは、個別サーバーごとに原因が違うように見えても、確認すべき順序はおおむね共通しています。

設定ファイルの場所を確認する: 意図したスコープ（local/project/user）に設定が入っているか
スコープの優先順位を確認する: 複数のスコープで同名のサーバーが定義され、意図しない設定が読み込まれていないか
接続ログを確認する: claude mcp listなどで、サーバーが起動・接続できているかを確認する

「サーバーが認識されない」「思った設定が反映されない」「認証が途中で切れる」といった症状は、この3段階のどこかで原因が見つかることがほとんどです。この順序で切り分けても解決しない場合は、利用しているMCPサーバー側のログやREADMEも手がかりになります。

個人利用からチーム定着までの進め方

ここまでの内容を踏まえ、自分やチームが今どの段階にいるかをセルフチェックしてみてください。

個人検証段階: MCPの仕組みを理解し、1〜2個のサーバーを自分の環境で試している状態。まずは前述の設定手順に沿って動かしてみることが次の一歩です。
チーム展開検討段階: .mcp.jsonをプロジェクトで共有し始め、承認プロセスや教育の整備が必要になってきた状態。前章のガバナンス設計を参考に、承認フローとレビュー体制を先に固めておくと後戻りが少なくなります。
全社導入検討段階: 複数チームでの利用を前提に、組織全体のルール整備やPoCを検討している状態。内製化を視野に入れる場合はClaude Codeの内製化ガイドも合わせて確認してみてください。

段階に応じて次に読むべき記事が変わるため、今の自分の立ち位置を把握しておくと、遠回りせずに次のアクションへ進めます。

まとめ

MCPは、Host・Client・Serverという構造と、Tools・Resources・Promptsという機能によって、Claude Codeが外部のデータやツールに接続するための共通規格です。個人での設定はclaude mcp addと.mcp.jsonの基本を押さえれば大きく迷うことはありませんが、チームで使い続けるには、承認プロセス・レビュー体制・新メンバーへの教育というガバナンス設計と、プロンプトインジェクションや認証情報の扱いといった技術的リスクへの理解が別途必要になります。

チームでの本格導入や、社内ルール整備の進め方について相談したい場合は、研修に関する情報もあわせてご検討ください。