
MCPとは?Claude Codeにつなぐ方法|claude mcp addの書き方・設定ファイル・安全に使う注意を、実際に動かして解説【2026年10月】
「MCP って最近よく聞くけど、結局なに?」「Claude Code に MCP を入れると何ができるの?」。この記事は、そんな疑問に向けた MCP の入門です。
この記事を読むと、MCP とは何か、Claude Code に追加する方法(コマンドと設定ファイル)、追加した MCP を確かめたり消したりする方法、そして入れる前に知っておきたい安全の話まで、一通り分かります。
私は Claude Code と Codex を毎日使って、教材づくり、note・Gumroad への出品、画像づくりを自動化しています。自分の環境にも、MCP を使っています。コードの構造を調べるためにパソコンの中で動く MCP と、デザインツールにつなぐ外のサービスの MCP です。
この記事のコマンドは、読み物のために書き写したものではありません。Windows 11 の Claude Code で、MCP サーバーを実際に追加し、一覧で接続を確かめ、Claude に「ツールを使って」と頼んで呼び出されるところまで確かめました。全文無料です。
この記事で分かること
MCP とは何か。なぜ必要なのか
Claude Code に MCP を追加する3つの方法(HTTP・stdio・SSE)
claude mcp add の書き方と、順序で間違えやすい所
3つのスコープ(local・project・user)と、.mcp.json
追加した MCP の確認・削除、OAuth での認証
出力の上限、ツールが増えたときの「ツール検索」
入れる前に知っておきたい安全の話
先に結論
MCP は、AI が外のツールやデータを使うための共通の接続規格です。Claude Code に MCP サーバーをつなぐと、Claude が「ツール」として呼び出せるようになります
つなぎ方は3種類。HTTP(公式が推奨)、パソコンの中で動かす stdio、古い SSE(非推奨)
追加は claude mcp add の1行です。-- の前後が大事で、サーバーに渡す引数は -- の後ろに置きます
設定は「自分だけ(local・user)」か「チームで共有(project の .mcp.json)」を選べます
信頼できるサーバーだけをつなぐ。外のページや文章を取ってくる MCP は、そこに書かれた悪意ある指示に影響される危険があります
使うほど便利ですが、使わない MCP は外しておくのが基本です
MCPとは
MCP は、Model Context Protocol の略です。AI が、外のツールやデータとやりとりするための、共通の約束事です。
AI だけでは、手元のファイルも、社内のシステムも、Notion のメモも見られません。そこで「このツールには、この名前でこう頼むと、こう返してくれる」という約束事を決めておき、AI がツールを呼べるようにします。この約束事が MCP です。
たとえば、パソコンの USB の差し込み口を思い浮かべてください。差し込み口の形が決まっているから、マウスもキーボードもメモリも、同じ口につなげます。MCP は、AI の「差し込み口」にあたります。ツールを作る人が MCP の形に合わせておけば、Claude Code でも他の対応した AI でも、同じツールを使えます。
Claude Code では、3つのものが使える
Claude Code に MCP サーバーをつなぐと、次のものが使えるようになります(公式のドキュメントで確かめました)。
ツール:Claude が呼び出して、何かをしてもらう。たとえば「この Issue を読む」「このデータベースを検索する」
リソース:@ で参照できる資料。ファイルを指定するように、サーバーのデータを指定できる
プロンプト:/ から呼べるコマンド。サーバーが用意した定型の頼み方
いちばん使うのは、ツールです。Claude に頼むと、Claude が必要に応じて MCP のツールを選んで呼びます。
どんなサーバーがあるか
公式のドキュメントでは、次のような例が挙がっています。
Notion(メモ・データベース)
Sentry(エラーの監視)
Airtable(表形式のデータベース)
データベースにつなぐサーバー(Bytebase の dbhub など)
ほかにも、GitHub、Slack、デザインツール、ブラウザの操作など、多くのサーバーが公開されています。自分で作ることもできます。
追加する3つの方法
Claude Code が MCP サーバーとつながる方法は、3種類あります。
1. HTTP:外のサービスにつなぐ(推奨)
インターネット上にあるサービスにつなぐ方法です。公式のドキュメントでは、"HTTP servers are the recommended option"(HTTP が推奨)と書かれています。
claude mcp add --transport http notion https://mcp.notion.com/mcp書式は claude mcp add --transport http <名前> <URL> です。認証のトークンが必要なサーバーは、--header を付けます。
claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer your-token"2. stdio:パソコンの中で動かす
サーバーのプログラムを、自分のパソコンの中で動かす方法です。npx で起動するサーバーが多く、次のように書きます。例は、MCP のプロジェクトが公開している試験用のサーバー(@modelcontextprotocol/server-everything)です。私の Windows 11 で、実際に追加して試しました。
claude mcp add --transport stdio everything -- npx -y @modelcontextprotocol/server-everythingここで一番大事なのが、-- の位置です。公式のドキュメントには、こう書かれています。
the -- (double dash) separates Claude's own options from the command and arguments
-- の前は Claude Code 自身のオプション(--transport、--env、--scope など)、-- の後ろは、サーバーを起動するコマンドそのものです。-y のような、サーバーに渡したい引数を -- の前に書くと、Claude Code が自分のオプションだと勘違いします。サーバーを起動するコマンドは、まるごと -- の後ろに置くと覚えてください。
3. SSE:古い方法(非推奨)
--transport sse で指定する方法です。公式のドキュメントでは、"The SSE ... transport is deprecated"(非推奨)と書かれています。新しく追加するなら、HTTP を選びます。
環境変数(APIキーなど)を渡す
サーバーが API キーを必要とするときは、--env で渡します。
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server公式の注意があります。--env の直後にサーバーの名前を置くと、名前が別の KEY=value として読まれてエラーになります。上の例のように、--transport stdio など、別のオプションを挟んでください。
そして、キーを設定ファイルに直接書かないことを勧めます。次の節の .mcp.json では、${VAR}(環境変数)で値を渡せます。

3つのスコープ:誰のどこに設定するか
MCP の設定は、「どの範囲で有効にするか」を選べます。--scope(短縮形 -s)で指定します。
local(既定):いまのプロジェクトだけ・自分だけ。保存先は ~/.claude.json
project:いまのプロジェクト。チームで共有できる。保存先はプロジェクト直下の .mcp.json
user:自分の全プロジェクトで使う。保存先は ~/.claude.json
同じ名前のサーバーが複数のスコープにあるときは、local が最優先で、次が project、user の順です。
.mcp.json(チームで共有する設定)
--scope project で追加すると、プロジェクトの直下に .mcp.json が作られます。私の環境で、次のコマンドを実行しました。
claude mcp add --transport stdio --scope project everything -- npx -y @modelcontextprotocol/server-everything画面には、次のように返ってきました。
Added stdio MCP server everything with command: npx -y @modelcontextprotocol/server-everything to project config
File modified: (プロジェクトのフォルダ)\.mcp.jsonできたファイルは、次のとおりです。
{
"mcpServers": {
"everything": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-everything"
],
"env": {}
}
}
}このファイルを Git に入れれば、同じプロジェクトを開いた人が、同じ MCP を使えます。値の中では、${VAR} や ${VAR:-既定値} で環境変数を展開できます(command・args・env・url・headers)。API キーは、ここに環境変数の名前だけを書いて、実際の値は各自の環境に置きましょう。
プロジェクトの .mcp.json にあるサーバーは、使う前に承認を求められます(対話のセッションの場合)。承認の選択をやり直したいときは、claude mcp reset-project-choices を実行します。
確認・削除する
追加したあとは、次のコマンドで状態を確かめられます。
claude mcp list:登録済みの一覧と、接続の状態
claude mcp get <名前>:1つの詳細
claude mcp remove <名前>:削除
私の環境で claude mcp list を実行すると、次のように出ました(一部)。
Checking MCP server health...
Canva: https://mcp.canva.com/mcp (HTTP) - ✓ Connected
everything: npx -y @modelcontextprotocol/server-everything - ✓ Connected✓ Connected が、つながっている印です。認証が必要なサーバーは「Needs authentication」と出ます。
claude mcp get everything では、次のような詳細が出ました。
everything:
Scope: Project config (shared via .mcp.json)
Status: ✓ Connected
Type: stdio
Command: npx
Args: -y @modelcontextprotocol/server-everythingClaude Code の会話の中でも、/mcp と入力すると、接続の確認・認証・無効化・再接続ができます。つながらなくなったサーバーは、/mcp reconnect all でまとめて再接続できます。
実際に呼ばれるか確かめる
追加しただけでは、使えているかは分かりません。私は、次のように頼んで確かめました。
MCP サーバー everything の echo ツールを使って、message に「こんにちは」を渡し、返ってきた文をそのまま1行で書いてください。返ってきた答えは「Echo: こんにちは」でした。使われたツールの名前は mcp__everything__echo と表示されました。
MCP のツールの名前は、mcp__<サーバー名>__<ツール名> の形になります。この名前は、あとで「このツールだけ許可する」「このツールだけ禁止する」と権限を決めるときに使います。
認証(OAuth)の流れ
ログインが必要なサービスの MCP は、OAuth で認証します。公式のドキュメントの流れは、次のとおりです。
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp のように追加する
Claude Code の中で /mcp を実行し、ブラウザの案内に沿ってログインする
認証情報は保存され、自動で更新される
ターミナルから claude mcp login <名前> でも認証できます。ブラウザを開けない環境(SSH など)では、URL が表示されるので、リダイレクト先の URL を貼り戻します。
気をつけたいのは、自動実行(claude -p)や Agent SDK では、OAuth のログインそのものができないことです(公式のドキュメントに書かれています)。裏で Claude Code を自動で動かす場合は、先に、対話のセッションでサインインしておく必要があります。私も、Claude Code を自動で動かしているので、この点は気にしています。
ツールが増えたとき:ツール検索と出力の上限
ツール検索(既定で有効)
MCP のサーバーを増やすと、ツールの数が増えます。ツールの説明を全部読み込むと、会話の記憶(コンテキスト)を圧迫します。そこで Claude Code は「ツール検索」を使います。公式のドキュメントによると、最初に読み込むのはツールの名前とサーバーの説明だけで、必要になったときに詳細を読み込みます。サーバーを増やしても、影響が小さくなる仕組みです。
必要なら、環境変数 ENABLE_TOOL_SEARCH で調整できます。false なら全部を最初から読み込みます。auto:5 のように書くと、ツール定義がコンテキストの5%に達したときだけ後回しにします。
出力の上限
MCP のツールが大きな結果を返すと、会話が一気に長くなります。公式のドキュメントでは、次のように決まっています。
ツールの出力が10,000トークンを超えると、警告が出る
既定の上限は25,000トークン。環境変数 MAX_MCP_OUTPUT_TOKENS で変えられる(例:50000)
上限を超えた成功の結果は、ファイルに保存され、会話にはそのパスが置かれる
大きなデータを返す MCP は、「全部を会話に入れず、必要な所だけ返す」作りのほうが、使いやすくなります。
安全に使うために
MCP は、AI に「手」を渡す仕組みです。便利な分、慎重さも要ります。
公式のドキュメントには、はっきりこう書かれています。
Verify you trust each server before connecting it. Servers that fetch external content can expose you to prompt injection risk.
つまり、つなぐ前に、そのサーバーを信頼できるか確かめること。そして、外のページや文章を取ってくるサーバーは、プロンプトインジェクション(文章の中に紛れ込んだ悪意ある指示に、AI が従ってしまうこと)の危険があります。
私が気をつけていることを書きます。
出どころの分からないサーバーは入れない。公式・提供元が明確なものだけを使う
権限は最小にする。データベースにつなぐなら、読み取り専用のアカウントを渡す
鍵を設定ファイルに書かない。.mcp.json は Git に入る。値は環境変数で渡す
使わない MCP は外す。つなぎっぱなしにしない(claude mcp remove)
新しい .mcp.json を見たら中身を読む。他人のリポジトリを開いたとき、設定されているサーバーは、承認の確認が出たら内容を確かめてから進める
公式のドキュメントでも、プロジェクトの .mcp.json のサーバーは、承認と信頼の確認を通してから使われると説明されています。クローンしたリポジトリに入っている設定だけで、勝手に承認されることはありません。それでも、承認するのは自分ですから、中身を見る習慣が大切です。
よくある疑問
Q. MCP とスキル・フックは、何が違いますか?
役割が違います。MCP は、外のツールにつなぐもの。スキルは、手順書(こう頼まれたらこう進める、という説明)。フックは、決まったタイミングで自動で動く処理です。たとえば、「Notion のデータを読む」のが MCP、「議事録を書くときの型」がスキル、「ファイルを編集したら必ず整形する」のがフックです。
Q. MCP サーバーは、自分で作れますか?
作れます。Claude Code に頼んで作らせることもできます。たとえば、エクスポート機能のない社内システムのデータを取り出す MCP サーバーを作る事例を、有料記事(¥100)にまとめています。
Q. 追加したのに、つながっていません
まず claude mcp list で、状態を見てください。「Needs authentication」なら、/mcp で認証します。「Failed」のようなときは、コマンドを直接ターミナルで実行して、エラーが出ないか確かめます。claude --debug で起動すると、詳しいログが出ます。
Q. MCP を入れたら、動作が遅くなりませんか?
ツール検索が既定で有効なので、サーバーを増やしても、最初に読み込むのは名前だけです。ただ、サーバーの起動には時間がかかります。使わないサーバーは外すほうが、軽く保てます。
注意点
この記事のコマンドは、2026年10月15日の Claude Code の公式ドキュメントと、私の Windows 11 の環境で確かめたものです。コマンドやオプションは、版が上がると変わることがあります。迷ったら claude mcp --help と、公式の MCP のページを見てください
出力の上限などの数字は、公式のドキュメントに書かれた値です。今後変わる可能性があります
OAuth のサーバーを自動実行で使う場合は、先に対話のセッションで認証しておく必要があります
まとめ
MCP は、AI が外のツールやデータを使うための共通の接続規格。Claude Code では、ツール・リソース(@)・プロンプト(/)が使える
つなぎ方は HTTP(推奨)・stdio(パソコンの中)・SSE(非推奨)の3つ
claude mcp add は、サーバーを起動するコマンドをまるごと -- の後ろに置く。--env の直後にサーバー名を置かない
スコープは local(既定)・project(.mcp.json で共有)・user(全プロジェクト)。優先は local → project → user
claude mcp list・get・remove と、会話の中の /mcp で管理する。ツール名は mcp__<サーバー名>__<ツール名>
OAuth の認証は対話のセッションで行う。claude -p では、ログインそのものはできない
ツール検索は既定で有効。出力は 25,000 トークンが既定の上限
信頼できるサーバーだけをつなぎ、権限は最小に。鍵は設定ファイルに直接書かない
次の一歩は、claude mcp list で、いま自分の環境に何がつながっているかを見ることです。そして、使っていないものがあれば、外してみてください。
次に読む
Claude Codeの使い方・始め方入門(無料):インストールから最初の依頼まで
AIエージェントとは(無料):コードを書いて、動かして、直すAIの考え方
エクスポート機能のない社内システムからデータを抜く(¥100):HARファイル×Claude Code×MCPで、小さな業務ツールを作る
Claude Codeを“社員”にする自動実行ボードの設計図(¥1,280):claude -p を並列で回す仕組みの作り方
このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。
この先で分かること(今後の有料記事)
自分専用の MCP サーバーを作る手順(設計・テスト・権限の決め方)
MCP のツールだけを許可する・禁止する、権限の設定の実例
受託やテンプレート販売につなげる、小さな業務ツールの作り方
まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。