メむンコンテンツぞスキップ
芋出し画像

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 では、有料蚘事が読み攟題になりたす。テンプレヌトや指瀺文をたずめお䜿いたい方はご芧ください。

     
     

    たさグレヌな裏情報発信䞭

     
     
    1日40分の䜜業で、毎日7䞇円。AIで䜜った教材ずXの驚き屋構文で皌いでいたす。note公開65本、Codex゚ラヌ党網矅パック、驚き屋構文セットを販売䞭。　グレヌな裏情報も発信䞭。https://affairist06.gumroad.com

    あなたぞのおすすめ