Claude CodeのMCP（Model Context Protocol）連携を非エンジニア目線で解説。MCPの概要、できること、claude mcp add と /mcp での追加方法、Notion・DB連携などの活用例、スコープや注意点まで、公式ドキュメントに沿って整理しました。
MCP（Model Context Protocol）は、Claude Codeを外部サービスに繋ぐオープン標準です。接続すると、NotionやデータベースなどをClaudeが直接読み書きできるようになります。追加はターミナルの claude mcp add コマンド、管理はセッション内の /mcp で行います。
この記事は、コードを書けない私が実際にClaude Codeでサイトやツールを作ってきた経験をふまえ、MCP連携を「非エンジニアでも分かる言葉」で整理したものです。
「MCP連携」と聞くと難しそうですが、要はClaudeに外部サービスへの“手足”を持たせる仕組みです。この一点を押さえると、一気に分かりやすくなります。
この記事の要点
- MCPは、Claude Codeを課題管理・DB・デザインツールなどの外部データ源に繋ぐオープン標準。
- 追加は
claude mcp add —transport http <名前> <URL>の形、管理は/mcpコマンド。 - スコープ（local / project / user）で使える範囲と共有先を切り替えられる。
実体験メモ
正直に言うと、最初は「MCP」という略語だけで身構えました。でも一度つないでしまえば、「Claudeに、いつも使っているサービスの中身を見せてあげる」だけの話でした。非エンジニアの私でも claude mcp add を一度打ってしまえば、あとは日本語で「あのメモを読んで」と頼めるようになります。ハードルの大半は「言葉の難しさ」で、作業自体はコマンド1行だった、というのが率直な感想です。
そもそもMCPとは？
MCP（Model Context Protocol）は、AIツールを外部データ源やサービスに繋ぐためのオープン標準です。Claude Code自体は、あなたのパソコン上のファイルを読んだり編集したりコマンドを実行したりできますが、そのままでは「別のクラウドサービスの中身」までは知りません。
MCPサーバーを接続すると、その壁を越えて、Claudeが外部サービスを直接読み書きできるようになります。公式ドキュメントでは、次のような連携が例として挙げられています。
- 課題管理ツールのissueから、コードのPR（プルリクエスト）を作成する
- エラー監視ツールで、発生中のエラー状況を確認する
- データベースに対して照会（クエリ）を投げる
- デザインツールと連携してデザイン情報を扱う
💡 ポイントは「Claudeが自分でコピペしなくても、サービスの中身を見に行けるようになる」こと。あなたが毎回情報を貼り付ける手間が減ります。
MCPでできること
MCPをつなぐと、Claude Codeの守備範囲が「手元のコード」から「日常使っているサービス群」へと広がります。イメージしやすいよう、代表的な連携先を整理します。
| 連携先の種類 | できることの例 |
|---|---|
| 課題管理・タスク | issueやチケットを読み、内容をふまえて作業する |
| エラー監視 | 発生しているエラーの状況を確認する |
| データベース | データを照会し、内容を要約・確認する |
| ドキュメント・メモ | メモやドキュメントを読み込み、下敷きにする |
| デザインツール | デザイン情報を参照して実装につなげる |
※接続できるサービスや対応状況は変わっていきます。最新の対応先や機能は公式ドキュメントで確認してください。
MCPサーバーの追加方法（claude mcp add / /mcp）
MCPの追加は、ターミナルでの claude mcp add コマンドが基本です。接続方式（トランスポート）によって書き方が少し変わります。以下は公式ドキュメントの表記に沿ったものです。
HTTP接続の場合
claude mcp add --transport http <名前> <URL>たとえばNotionを追加する例は次のとおりです。
claude mcp add --transport http notion https://mcp.notion.com/mcpSSE接続の場合
claude mcp add --transport sse <名前> <URL>ローカル（stdio）で動かす場合
自分のパソコン上でサーバープログラムを起動して繋ぐ形です。-- 以降が、そのサーバーを起動するコマンドになります。
claude mcp add [オプション] <名前> -- <起動コマンド> [引数...]追加したあとの管理は /mcp
追加できたら、Claude Codeのセッション内で次のスラッシュコマンドを使います。
/mcp… 接続状態の確認、OAuth認証、サーバーの有効／無効の管理claude mcp list… 追加済みサーバーの一覧表示（ターミナル）claude mcp get <名前>… 特定サーバーの詳細確認（ターミナル）
サービスによっては、初回接続時にブラウザでのOAuth認証（ログイン許可）を求められます。その承認も /mcp から進められます。
認証情報の入力や許可の付与は、あなた自身が内容を確認したうえで行ってください。身に覚えのないサーバーURLは追加しないのが安全です。
スコープを理解する（local / project / user）
MCPを追加するとき、-s（—scope）で設定をどこに保存し、誰が使えるかを選べます。ここは最初につまずきやすいので、表で整理します。
| スコープ | 使える範囲 | 共有 | 保存先の目安 |
|---|---|---|---|
local（既定） | 自分のみ・現在のプロジェクト | しない | ~/.claude.json |
project | プロジェクトのメンバー | する（VCS管理） | リポジトリ直下の .mcp.json |
user | 自分の全プロジェクト | しない | ~/.claude.json |
- 自分だけで試すなら … 既定の
localのままでOK。 - チームで同じMCPを共有したいなら …
projectにすると.mcp.jsonがリポジトリに書き出され、Gitなどで共有できます。 - どのプロジェクトでも使いたいなら …
userを選びます。
活用例（非エンジニア目線で）
私自身の使い方に近い、身近な活用イメージを挙げます。難しい開発でなくても役立ちます。
- メモ・ドキュメントを下敷きに作業：ドキュメント系サービスをつなぎ、「あのページの内容をもとに文章を整えて」と頼む。毎回コピペしなくて済む。
- タスクの内容をふまえて着手：課題管理ツールをつなぎ、issueの中身をClaudeに読ませてから作業に入る。
- データの中身を確認：データベースをつなぎ、「この表の件数を数えて」といった照会を日本語で頼む。
いずれも共通するのは、「Claudeが自分で情報を取りに行ける」ことで、あなたの手間が減るという点です。まずは普段いちばん多くコピペしているサービスを1つだけ繋いでみるのがおすすめです。
サブエージェントとの組み合わせ
MCPはサブエージェント（役割特化の分身AI）とも組み合わせられます。サブエージェントのツール許可では mcp__<サーバー名> という形式で、MCPサーバー単位の許可・拒否を指定できます。たとえば「調査担当のサブエージェントにはドキュメント系のMCPサーバーだけ許可する」といった形で、外部サービスへのアクセス範囲を役割ごとに絞れるので、安全に運用しやすくなります。
注意点とつまずきやすいところ
- まず1つだけ繋ぐ：一度にたくさん追加せず、使うものから。挙動確認もしやすい。
- 文脈の圧迫は気にしすぎない：MCPツール定義は既定で遅延読み込み（tool search）され、使うまで文脈を大きく消費しない設計。重く感じたら
/contextで使用量を確認。 - 繋がらない時は
/mcpで状態確認：接続やOAuthのエラーはここで見える。設定の切り分けにはclaude —safe-mode（全カスタマイズ無効化）も有効。 - 信頼できるサーバーだけ：外部サービスに読み書きを許すので、提供元とURLを必ず確認する。
- 仕様は変わる：コマンド名や対応サービスは更新されるため、最新は公式ドキュメントで確認する。
MCPが効かない・繋がらない、といった具体的なトラブルは、Claude Codeのエラー・不具合の対処 もあわせてどうぞ。
まとめ
- MCP（Model Context Protocol）は、Claude Codeを外部サービスに繋ぐオープン標準。Claudeに外部への手足を持たせるイメージ。
- 追加は
claude mcp add —transport http <名前> <URL>などのコマンド、管理はセッション内の/mcp。 - スコープ（local / project / user）で、使える範囲とチーム共有の有無を選べる。
- 非エンジニアでも「よく使うサービスを1つ繋ぐ」だけで手間が減る。最新のコマンドや対応先は公式ドキュメントで確認を。
公式情報は Claude Code公式ドキュメント（MCP） を参照してください（公式ドキュメントは code.claude.com に移転しています）。
関連記事：Claude Codeの全体像は Claude Codeとは？、AIへの指示をまとめるファイルは CLAUDE.mdの書き方、セッション内で使う命令は スラッシュコマンド一覧、MCPを役割ごとに絞って任せるなら サブエージェントと自動化、繋がらない時は エラー・不具合の対処 をどうぞ。カテゴリ一覧は AI活用・ノウハウ へ。
よくある質問（FAQ）
MCPとは何ですか？
MCP（Model Context Protocol）は、AIツールを外部データ源やサービスに繋ぐためのオープン標準です。Claude Codeに接続すると、課題管理・監視・データベース・デザインツールなどをClaudeが直接読み書きできるようになります。要は「Claudeに外部サービスへの手足を持たせる仕組み」です。
MCPサーバーはどうやって追加しますか？
ターミナルで claude mcp add コマンドを使います。HTTP接続なら claude mcp add --transport http <名前> <URL> の形です。追加後は接続状態やOAuth認証をセッション内の /mcp コマンドで管理します。詳細な最新手順は公式ドキュメントで確認してください。
MCPを追加するとコンテキスト（文脈）を圧迫しませんか？
MCPツールの定義は既定で遅延読み込み（tool search）され、実際に使うまでは文脈をあまり消費しない設計です。とはいえ多数のサーバーを常時つなぐと影響は出るため、使うものだけを接続するのが無難です。挙動が重い時は /context で使用量を確認できます。
追加したMCPをチームで共有できますか？
できます。追加時にスコープを project にすると設定が .mcp.json としてリポジトリ直下に書き出され、バージョン管理を通じてチームで共有されます。自分だけで使うなら既定の local スコープ、全プロジェクトで使うなら user スコープを選びます。
サブエージェントにMCPのツールを使わせられますか？
使わせられます。サブエージェントのツール許可では mcp__<サーバー名> という形式で、MCPサーバー単位の許可・拒否を指定できます。たとえば調査用のサブエージェントには特定のMCPサーバーだけを許可する、といった絞り込みが可能です。詳細な書き方は公式ドキュメントで確認してください。