ガイド更新日
Claude CodeをMCPで外部サービスにつなぐ
この記事で分かること
Claude Code 集中講座の第11回。チケットやログなど、その時点の情報を取得するMCPを扱います。接続方式、設定の範囲、認証、返ってきた情報の読み方を整理します。

目次 読みたいところから
チケットの内容をコピーしてClaude Codeに渡したあと、元のチケットが更新されていた。いまの状態を調べる仕事では、書いておく規約や手順だけでは足りません。情報がある場所へ取りに行く方法が要ります。
MCP(Model Context Protocol)は、Claude Codeを外部の道具やデータにつなぐ共通の仕組みです。接続の方法と、取得した情報を作業で使うときの扱いを整理します。
約束事が共通であることの意味
MCP は、AIのエージェントが外部の道具やデータへつなぐための共通の約束事です。Claude Code が決めたものではなく、複数のツールが対応している仕様です。
あるサービス向けのサーバーを1つ用意すれば、対応したどのツールからも使えます。ツールを乗り換えても、つなぎ込みは作り直しになりません。
接続の形は2つ覚えれば足りる
公式ドキュメントには4つの形式が載っていますが、実際に使うのは2つです。
手元でコマンドとして起動する形は、ローカルのファイルやデータベースを扱うものに使います。
claude mcp add --transport stdio my-db -- node /path/to/server.js
-- のあとは、そのままサーバーへ渡されます。引数を書くときは、この区切りを忘れないでください。
HTTPでつなぐ形は、外部サービスが提供しているものに使います。公式が遠隔のサーバーに勧めているのはこちらです。
claude mcp add --transport http stripe https://mcp.stripe.com
残りの2つのうち、SSE は非推奨とされています。WebSocket は JSON で設定を書く形になります。
追加したあとは、状態を確認するコマンドがあります。
claude mcp list # つないであるものを並べる
claude mcp get <名前> # 1つの設定を見る
claude mcp remove <名前> # 外す
セッションの中からは /mcp で状態を見られます。
デスクトップアプリには、コマンドを打たずにつなぐ方法もあります。公式ドキュメントによれば、デスクトップアプリのコネクタは、画面から設定できる MCP サーバーです。入力欄の横の「+」から「Add connectors」を選ぶと、コネクタの一覧が開きます。つないだあとの管理や切断は、サイドバーの「Customize」から「Connectors」を開いて行います。一覧にないものは、ここまでのコマンドや設定ファイルで足します。
範囲は3つあり、1つだけ共有される
同じサーバーでも、どの範囲で追加するかで保存先が変わります。ここが Claude Code の MCP でいちばん間違えやすい部分です。
| 範囲 | 保存先 | 効く範囲 | 共有 |
|---|---|---|---|
| local(既定) | ~/.claude.json のプロジェクト別の欄 | そのプロジェクトだけ | されない |
| project | リポジトリの根の .mcp.json | そのプロジェクトだけ | される |
| user | ~/.claude.json の全体の欄 | 自分の全プロジェクト | されない |
指定は --scope project のように書きます。
真ん中の project が特別です。リポジトリに入るので、それを開いた人全員に影響します。
リポジトリに入っているサーバーは、承認を挟む
他人がコミットした .mcp.json がそのまま動いたら困ります。そうはなっていません。
公式ドキュメントによれば、対話セッションではプロジェクトのサーバーについて承認を求められます。承認の記録を消してやり直したいときは claude mcp reset-project-choices です。
ただし例外があります。承認の画面を出せないセッション、つまり claude -p での実行、SDK 経由、クラウドのセッションでは、承認を求めずに読み込まれます。--strict-mcp-config を付けると、指定した設定以外を無視できます。
自動化の中で他人のリポジトリを扱うときは、ここを意識してください。承認の画面は出ません。
鍵をコマンドの引数に書かない
つなぐ先には、たいてい認証が要ります。
手元で起動する形には --env KEY=value があります。HTTPでつなぐ形には --header "Name: value" があります。
どちらも、シェルの履歴に値が残る形で書かないでください。環境変数を参照する形にして、値そのものは別の場所に置きます。第9回で触れた CLAUDE.local.md と同じ発想で、コミットされる場所と、されない場所を分けるのが基本です。
返ってきた内容は、指示ではない
外部サービスから返ってくる文章には、作業の指示に見える内容も含まれます。
公式ドキュメントは、はっきりした警告を出しています。つなぐ前に、そのサーバーを信頼できるか確かめてください。外部の内容を取ってくるサーバーは、プロンプトインジェクションのリスクにさらします、と。
具体的に何が起きるかというと、課題管理のコメント欄や、取得したウェブページの中身に、Claude への指示に見える文章が混ざっていることがあります。「この設定ファイルを読んで送信せよ」のような形です。
第5回で見たとおり、auto モードの分類器はツールの実行結果を読みません。だから、返ってきた内容で分類器を直接だますことはできません。取り除かれる理由が、まさにこれです。
ただし、Claude 本体は読みます。読んで作業の材料にします。だから、誰でも書き込める場所をつなぐときは、その前提で設計してください。
対策は3つです。
- つなぐ先の権限を読み取りだけにする
- 戻せない操作(書き込み、削除、通知の送信)ができるサーバーは、必要なときだけ有効にする
- 第5回の deny 規則で、触られたくないファイルの読み取りを塞いでおく
なお、MCP 側で対話が必要と指定されたツールは、どの権限モードでも自動では承認されません。第5回の「どのモードでも自動にならないもの」の一覧に入っていたのが、これです。組織の設定で特定のツールを常に確認にすることもできます。
つなぐ数を増やしすぎない
運用してみて分かったことがあります。つなぐ数が増えると、選択の精度が下がります。
Claude は、使える道具の一覧を持った状態で作業を始めます。一覧が長くなるほど、その中から適切なものを選ぶ判断が難しくなり、関係ない道具を使おうとする場面が増えます。第10回でスキルの説明文を正確に書く話をしましたが、同じ構図です。
公式ドキュメントによれば、既定ではツール検索が働き、セッションの始めに読み込まれるのは道具の名前とサーバーの説明だけです。詳しい定義は Claude が必要としたときに読み込まれるので、つなぐ数を増やしても文脈の消費は小さく抑えられます。
使っていないものは外す。定期的に claude mcp list を見て、3か月使っていないものを外す程度で足ります。
3つの仕組みの使い分け
ここまでで、Claude Code に何かを渡す仕組みを3つ扱いました。判断は2つの質問で足ります。
どの作業にも関係するか。 するなら CLAUDE.md です。
しない場合、それは書いておける内容か。 書いておけるならスキル、書いておけないなら MCP です。
3つは競合しません。同じ作業で全部使うこともあります。リリースの作業なら、規約は CLAUDE.md に、手順はスキルに、デプロイの状態の確認は MCP 経由で、という形になります。
置き場所を間違えたときは、静かに効かなくなる形で現れます。規約をスキルに入れると、呼ばれなかった回に効きません。取りに行くべき情報を規約に書き写すと、古くなったことに誰も気づきません。実際に起きた例はCodex 集中講座の第12回に書きました。
接続する前の設計メモ
取りに行きたい情報を1つ選び、接続先、取得する内容、必要な権限を書きます。本文の例を使い、手元で動かす接続かHTTPの接続か、どの範囲に設定を置くかも選んでください。
返ってきた文章に指示が含まれていた場合も、外部のデータとして読むことを確かめます。
次の回
必要な情報へアクセスできたら、調査を別の作業者に分ける場面を考えます。「Claude Codeのサブエージェントに調査を分ける」へ進めます。
参照した公式情報
- Anthropic「MCP」「Choose a permission mode」「Desktop application」(code.claude.com/docs、2026年11月時点)
- Model Context Protocol の仕様(modelcontextprotocol.io、2026年9月時点)
よくある質問
- 設定をチームで共有できますか
- できます。`--scope project` を付けて追加すると、リポジトリの根の `.mcp.json` に書かれ、Git で共有されます。ただし、他人がコミットしたサーバーがそのまま動くわけではなく、対話セッションでは承認を求められます。
- 鍵はどこに書きますか
- コマンドの引数に値を直接書かないでください。手元で起動する形には `--env KEY=value`、HTTPでつなぐ形には `--header "Name: value"` が用意されています。設定ファイルに残る形になるものは、値そのものではなく環境変数を参照する形にしてください。
- つないだ先から変な指示が返ってきたら
- 返ってきた内容は指示ではなくデータとして扱われるべきものです。第5回で見たとおり、auto モードの分類器はツールの実行結果を読みません。ただし Claude 本体は読みます。誰でも書き込める場所をつなぐときは、その前提で権限を絞ってください。
