メインコンテンツへスキップ
見出し画像

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-everything

    Claude Code の会話の中でも、/mcp と入力すると、接続の確認・認証・無効化・再接続ができます。つながらなくなったサーバーは、/mcp reconnect all でまとめて再接続できます。

    実際に呼ばれるか確かめる

    追加しただけでは、使えているかは分かりません。私は、次のように頼んで確かめました。

    MCP サーバー everything の echo ツールを使って、message に「こんにちは」を渡し、返ってきた文をそのまま1行で書いてください。

    返ってきた答えは「Echo: こんにちは」でした。使われたツールの名前は mcp__everything__echo と表示されました。

    MCP のツールの名前は、mcp__<サーバー名>__<ツール名> の形になります。この名前は、あとで「このツールだけ許可する」「このツールだけ禁止する」と権限を決めるときに使います。

    認証(OAuth)の流れ

    ログインが必要なサービスの MCP は、OAuth で認証します。公式のドキュメントの流れは、次のとおりです。

    1. claude mcp add --transport http sentry https://mcp.sentry.dev/mcp のように追加する

    2. Claude Code の中で /mcp を実行し、ブラウザの案内に沿ってログインする

    3. 認証情報は保存され、自動で更新される

    ターミナルから 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 や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    この先で分かること(今後の有料記事)

    • 自分専用の MCP サーバーを作る手順(設計・テスト・権限の決め方)

    • MCP のツールだけを許可する・禁止する、権限の設定の実例

    • 受託やテンプレート販売につなげる、小さな業務ツールの作り方

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。

    あなたへのおすすめ