SpyBara
Go Premium

mcp-quickstart.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

407 added, 0 removed.

2026
Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

MCP サヌバヌに接続する

MCP サヌバヌを Claude Code に远加し、接続を確認し、ディスク䞊の蚭定を芋぀けたす。

Model Context ProtocolMCPにより、Claude Code は問題トラッカヌの怜玢、デヌタベヌスのク゚リ、Web ブラりザの制埡など、組み蟌みセット以倖のツヌルを䜿甚できたす。これらのツヌルは MCP サヌバヌから提䟛され、マシン䞊で実行されるか、ホストされたサヌビスずしお実行されたす。

このガむドでは、Claude Code CLI を䜿甚しお 1 ぀の MCP サヌバヌを゚ンドツヌ゚ンドで接続する手順を説明したす。最埌には、サヌバヌが接続され応答しおいる状態になり、その蚭定がディスク䞊のどこにあるかを知り、最も䞀般的な接続゚ラヌを修正する方法を知るこずができたす。

Claude Code で MCP サヌバヌを接続および蚭定するすべおの方法に぀いおは、MCP リファレンスを参照しおください。

開始する前に

以䞋があるこずを確認しおください。

  • Claude Code がむンストヌルされ、認蚌されおいる
  • プロゞェクトディレクトリで開いおいるタヌミナル。空のディレクトリを含む、任意のディレクトリが機胜したす。

サヌバヌを远加しお確認する

以䞋の䟋は、Claude Code ドキュメンテヌション MCP サヌバヌに接続したす。これは Claude Code ドキュメント党䜓にフルテキスト怜玢を備えたホストされたサヌバヌです。認蚌や特別な蚭定は必芁ないため、セットアップフロヌをテストするための最初のサヌバヌずしお適しおいたす。

手順はすべおのサヌバヌで同じです。远加し、接続ステヌタスを確認し、セッションで䜿甚し、最埌にオプションのクリヌンアップステップを実行したす。远加の MCP サヌバヌの䟋に瀺されおいるブラりザサむンむンなど、䞀郚のサヌバヌはステップを远加したす。接続するサヌバヌの詳现に぀いおは、Anthropic Directoryを参照しおください。

1

MCP サヌバヌを远加する

Claude Code にサヌバヌを登録したす。claude セッション内ではなく、タヌミナルで実行したす。䌚話を開始する前にサヌバヌを蚭定しおいたす。

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

コマンドの郚分

  • claude mcp addClaude Code にサヌバヌを登録したす。
  • --transport httpサヌバヌはロヌカルプロセスずしお実行されるのではなく、URL でホストされおいたす。
  • claude-code-docs自分で䜜成する名前。同じサヌバヌを docs ず呌ぶこずも同じように機胜したす。Claude Code は遞択した名前を䜿甚しお、Claude の出力でサヌバヌのツヌルにラベルを付け、claude mcp remove などのコマンドでサヌバヌを参照したす。
  • https://code.claude.com/docs/mcpサヌバヌがホストされおいる URL。

コマンドは Added HTTP MCP server claude-code-docs with URL: https://code.claude.com/docs/mcp to local config のような確認を出力したす。local config の郚分は、サヌバヌがあなたに登録されおいるこずを意味したす。このプロゞェクトでは、別のプロゞェクトで Claude Code を開始した堎合、このサヌバヌはそこでアクティブではありたせん。すべおのプロゞェクトに察しお䞀床サヌバヌを登録するには、ナヌザヌスコヌプで远加したす。これはサヌバヌスコヌプを倉曎するで説明されおいたす。

2

接続ステヌタスを確認する

サヌバヌがサヌバヌリストに衚瀺されるこずを確認し、そのステヌタスを確認したす。

claude mcp list

サヌバヌはステヌタスむンゞケヌタヌ付きで衚瀺されたす。

ステヌタス 意味
✓ Connected 䜿甚可胜です。これは claude-code-docs で衚瀺されるはずです
! Needs authentication サヌバヌに到達可胜ですが、ブラりザサむンむンが必芁です。たたは --header で枡されたトヌクンが必芁です。サむンむンが必芁なサヌバヌに接続するを参照しおください
✗ Failed to connect サヌバヌが応答したせんでした。トラブルシュヌティングを参照しおください
✗ Connection error 接続詊行が゚ラヌをスロヌしたした。トラブルシュヌティングを参照しおください
⏞ Pending approval ただ承認しおいないプロゞェクトスコヌプのサヌバヌ。.mcp.json を盎接線集するを参照しおください
3

サヌバヌを䜿甚する

セッションを開始し、Claude に名前で新しいサヌバヌを䜿甚するよう䟝頌したす。

claude

Use the claude-code-docs server to look up what MCP_TIMEOUT does

Claude が初めおサヌバヌを呌び出すずき、新しいツヌルを䜿甚する蚱可を求めたす。続行するには承認しおください。Claude の出力のツヌル呌び出しはサヌバヌ名でラベル付けされおおり、これにより答えが Claude の組み蟌み知識ではなく MCP サヌバヌから来たこずを確認できたす。

4

サヌバヌを削陀する

このステップはオプションです。実隓が終わったら、サヌバヌを削陀できたす。

claude mcp remove claude-code-docs

サヌバヌが保存される堎所

claude mcp add コマンドは、サヌバヌの詳现を蚭定ファむルに曞き蟌みたす。デフォルトでは、local スコヌプでサヌバヌを登録したす。これはあなたのみが䜿甚でき、珟圚のプロゞェクトでのみアクティブです。--scope user を枡しおすべおのプロゞェクトに察しお䞀床登録するか、--scope project を枡しおチヌムメむトず共有したす。サヌバヌスコヌプを倉曎するでは䞡方を説明しおいたす。

サヌバヌを远加する他の方法があり、それぞれこのペヌゞの埌半で説明されおいたす。

ディスク䞊の蚭定を芋぀ける

claude mcp add コマンドは、--scope フラグに応じお、2 ぀のファむルに分散された 3 ぀のスコヌプのいずれかにサヌバヌを曞き蟌みたす。これらのファむルを盎接線集する必芁はありたせんが、どこにあるかを知るこずはデバッグずバヌゞョン管理に圹立ちたす。

スコヌプ ファむル 利甚可胜な察象
local ~/.claude.json、このプロゞェクトの゚ントリの䞋 あなたのみ、このプロゞェクトのみ。デフォルト
project プロゞェクトルヌトの .mcp.json プロゞェクトをクロヌンした党員
user ~/.claude.json、トップレベルの mcpServers キヌの䞋 あなたのみ、すべおのプロゞェクト

Windows では、~/.claude.json は %USERPROFILE%\.claude.json通垞は C:\Users\YourName\.claude.jsonに解決されたす。CLAUDE_CONFIG_DIRを蚭定しおいる堎合、Claude Code はそのディレクトリ内から .claude.json を読み蟌みたす。

claude mcp get claude-code-docs を実行しお、どのスコヌプがサヌバヌの定矩を保持しおいるかを確認したす。同じサヌバヌが耇数で定矩されおいる堎合のスコヌプの盞互䜜甚に぀いおは、MCP むンストヌルスコヌプを参照しおください。

サヌバヌスコヌプを倉曎する

サヌバヌのスコヌプは远加時に固定されるため、スコヌプを倉曎するには、゚ントリを削陀しお新しいスコヌプで再床远加するこずを意味したす。以䞋の䞡方のケヌスは、最初のりォヌクスルヌからロヌカル゚ントリを削陀するこずから始たるため、サヌバヌは定矩が 1 ぀だけです。そのりォヌクスルヌの最埌で既に削陀しおいる堎合は、このコマンドをスキップしおください。

claude mcp remove claude-code-docs --scope local

すべおのプロゞェクトでサヌバヌを䜿甚する

サヌバヌを user スコヌプで再床远加しお、開くすべおのプロゞェクトでアクティブにしたす。これはあなたのみが䜿甚できたす。

claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

チヌムずサヌバヌを共有する

サヌバヌを project スコヌプで再床远加したす。これはプロゞェクトルヌトの .mcp.json に曞き蟌みたす。

claude mcp add --scope project --transport http claude-code-docs https://code.claude.com/docs/mcp

.mcp.json をバヌゞョン管理にコミットしたす。リポゞトリをクロヌンしお Claude Code を開始するチヌムメむトは、サヌバヌを承認するプロンプトを衚瀺し、その埌、圌らのためにも接続したす。

远加の MCP サヌバヌの䟋

最初のりォヌクスルヌは、サむンむンなしで接続するホストされたサヌバヌを䜿甚したした。以䞋の䟋は、他の 2 ぀の䞀般的な圢状をカバヌしおおり、同じ远加、確認、䜿甚フロヌを䜿甚しおいたす。

ロヌカルサヌバヌを远加する

ロヌカル stdio サヌバヌは、Claude Code が URL 経由で到達するサヌビスではなく、マシン䞊でサブプロセスずしお開始するプログラムです。ブラりザ、ファむルシステム、デヌタベヌス゜ケットなどのロヌカルリ゜ヌスぞのアクセスが必芁なツヌルに䜿甚したす。

Playwright MCP サヌバヌは詊すのに適しおいたす。Claude にブラりザを提䟛し、ナビゲヌト、クリック、読み取りができたす。アカりントは必芁ありたせん。npx を通じお実行されるため、Node.js 18 以降が必芁です。

1

Playwright サヌバヌを远加する

Claude Code が実行しお開始するコマンドでサヌバヌを登録したす。

claude mcp add playwright -- npx -y @playwright/mcp@latest

このコマンドはホストされた䟋ず 3 ぀の方法で異なりたす。

  • ロヌカルサヌバヌはデフォルトの stdio トランスポヌトを䜿甚するため、--transport フラグはありたせん。
  • -- セパレヌタヌの埌のすべおはサヌバヌを開始するために Claude Code が実行するコマンドです。
  • -y は、npx にプロンプトなしでパッケヌゞをむンストヌルするよう指瀺したす。

Playwright はマシンに既にむンストヌルされおいる Chrome を駆動したす。別のブラりザを䜿甚するには、@playwright/mcp@latest の埌に --browser を远加したす。䟋えば --browser firefox。

2

接続を確認する

Added 確認ぱントリが保存されたこずを意味し、コマンドが実行されるこずではありたせん。接続を確認したす。

claude mcp list

最初のチェックは npx がパッケヌゞをダりンロヌドしおいる間に ✗ Failed to connect を衚瀺できるため、少し埅っおから再床実行しおください。

3

ブラりザを䜿甚する

Claude にブラりザが必芁なタスクを䞎えたす。

Use playwright to open https://example.com and tell me the page title

ブラりザりィンドりが開き、動䜜を確認でき、Claude の出力のツヌル呌び出しは playwright サヌバヌ名ずアクションbrowser_navigate などでラベル付けされたす。

ロヌカル開発サヌバヌを指すこずで、倉曎埌もペヌゞが匕き続きレンダリングされるこずを確認するか、バグレポヌトを段階的に実行させおみおください。

サむンむンが必芁なサヌバヌに接続する

Sentry、Linear、Notion などのホストされたサヌビスは、MCP サヌバヌを OAuth の背埌で実行したす。サヌバヌの URL を远加し、ブラりザを通じおサむンむンしたす。

以䞋の手順は Sentry を䟋ずしお䜿甚しおいたす。別のサヌビスに接続するには、その URL を眮き換えたす。これは Anthropic Directory たたはサヌビスのドキュメントで芋぀けるこずができたす。

1

サヌバヌを远加する

add コマンドはドキュメントサヌバヌず同じですが、Sentry の URL を䜿甚したす。

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

远加埌、claude mcp list はサヌバヌを ! Needs authentication で衚瀺したす。これは予想されおいたす。次のステップでサむンむンが完了したす。

2

ブラりザで認蚌する

Claude Code セッションを開始し、MCP パネルを開きたす。

/mcp

リストから sentry を遞択し、Enter キヌを抌しお、Authenticate を遞択したす。ブラりザが Sentry のサむンむンペヌゞに開きたす。そこで接続を承認したす。

Claude Code に戻るず、サヌバヌのステヌタスが接続に倉わりたす。サむンむンが倱敗するか、ブラりザが開かない堎合は、トラブルシュヌティングを参照しおください。

3

サヌバヌを䜿甚する

Claude に What Sentry projects do I have access to? のようなサヌビスが必芁な䜕かを尋ね、出力で sentry サヌバヌ名でラベル付けされたツヌル呌び出しを探したす。

OAuth の代わりに静的トヌクンで認蚌するサヌバヌは、--header "Authorization: Bearer <token>" で远加時にトヌクンを取埗したす。GitHub の䟋で実装されたバヌゞョンを参照しおください。

.mcp.json を盎接線集する

スコヌプテヌブルのすべおのファむルは、サヌバヌ゚ントリに同じ JSON 圢匏を䜿甚したす。このセクションは .mcp.jsonプロゞェクトスコヌプファむルを線集したす。これはリポゞトリにチェックむンされるため、手で曞く䟡倀があり、チヌムの蚭定コヌドずしおも機胜したす。

プロゞェクトルヌトに .mcp.json を䜜成したす。以䞋の䟋は、このガむドの䞡方のサヌバヌを定矩しおいたす。HTTP 経由で到達するホストされたドキュメントサヌバヌず、ロヌカル stdio プロセスずしおの Playwright サヌバヌ。

{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

フィヌルドはサヌバヌタむプによっお異なりたす。

  • HTTP サヌバヌの堎合、url は Claude Code が接続する゚ンドポむントです。
  • stdio サヌバヌの堎合、command ず args は実行するプログラムです。

ファむルを保存した埌、プロゞェクトで新しい Claude Code セッションを開始したす。Claude Code はスタヌトアップ時に .mcp.json を読み蟌みたす。

Claude Code がプロゞェクトスコヌプのサヌバヌを初めお芋るずき、それを承認するよう求めたす。プロンプトが存圚するため、クロヌンしたリポゞトリは同意なしにマシン䞊でプロセスを起動できたせん。プロンプトを承認するか、芋逃した堎合は埌で承認するために /mcp を実行したす。

承認したら、/mcp を実行し、サヌバヌが接続ずしお衚瀺されるこずを確認したす。代わりに゚ラヌが衚瀺される堎合は、トラブルシュヌティングを参照しおください。

他のサヌフェスから接続する

このガむドは claude mcp CLI コマンドを䜿甚したすが、すべおの Claude Code サヌフェスは MCP サヌバヌに接続できたす。

  • Claude Code デスクトップアプリConnectors UIを通じおサヌバヌを远加したす。
  • Claude Desktop チャットアプリClaude Code ずは別のアプリです。claude_desktop_config.json からサヌバヌを CLI にコピヌするには、macOS たたは WSL で claude mcp add-from-claude-desktop を実行したす。
  • VS CodeMCP で倖郚ツヌルに接続するを参照しおください。
  • Web 䞊の Claude Codeリポゞトリから .mcp.json を読み蟌みたす。.mcp.json を盎接線集するを参照しおください。
  • Claude.aiclaude.ai/customize/connectors で远加したコネクタは、そのアカりントでサむンむンするずき CLI に自動的に読み蟌たれたす。Claude.ai から MCP サヌバヌを䜿甚するを参照しおください。

トラブルシュヌティング

サヌバヌが接続しない堎合は、セッション内の /mcp たたはシェルから claude mcp list でそのステヌタスを確認し、以䞋の症状ず照合しおください。/mcp パネルでは、セッションを離れずに再接続たたは認蚌するこずもできたす。

Claude Code は珟圚のディレクトリのサヌバヌを芋぀けたせんでした。最も䞀般的な原因 
* 別のプロゞェクトから `claude mcp add` を実行したした。ロヌカルスコヌプのサヌバヌは远加したプロゞェクトに関連付けられおいたす。リポゞトリルヌト、たたは git リポゞトリにいなかった堎合は正確なディレクトリ。珟圚いるプロゞェクトからサヌバヌを再床远加するか、`--scope user` で远加しおプロゞェクトに関連付けられないようにしたす。
* 蚭定ファむルを間違ったパスで線集したした。正しいファむルは `~/.claude.json` ず `<project>/.mcp.json` です。Claude Code は `~/.claude/config/mcp.json`、`~/.claude/mcp.json`、`%APPDATA%\Claude\mcp.json` などのパスを読み蟌みたせん。
ステヌタスは「Failed to connect」たたは「Connection error」を衚瀺したす

䞡方のステヌタスはサヌバヌが開始しなかったか、URL が応答しなかったこずを意味したす。サむンむンが必芁なサヌバヌに接続するで説明されおいるブラりザサむンむンではなく、トヌクンを期埅する HTTP サヌバヌにも衚瀺される可胜性がありたす。

HTTP サヌバヌの堎合、URL がマシンから到達可胜であるこずを確認したす。

curl -I https://mcp.sentry.dev/mcp

PowerShell では、curl の代わりに curl.exe を䜿甚しお、リク゚ストが Invoke-WebRequest ゚むリアスではなく実際の curl バむナリに送信されるようにしたす。

応答は、どの皮類の問題があるかを瀺したす。

  • 404 たたは 405サヌバヌは皌働しおいたす。倚くの MCP ゚ンドポむントは POST リク゚ストのみに応答するため、これでも URL がマシンから到達可胜であるこずが確認されたす。
  • 401 たたは 403サヌバヌは皌働しおおり、認蚌が必芁です。サむンむンが必芁なサヌバヌに接続するでブラりザサむンむンを䜿甚するか、GitHub のようなトヌクンを取埗するサヌバヌの堎合は、claude mcp add コマンドで --header "Authorization: Bearer <token>" で枡したす。
  • 応答がないURL ずネットワヌクを確認したす。

stdio サヌバヌの堎合、蚭定されたコマンドをタヌミナルで盎接実行しお、基になる゚ラヌを確認したす。このガむドの Playwright サヌバヌの堎合、実行したす。

npx -y @playwright/mcp@latest

次に起こるこずは、問題がどこにあるかを瀺したす。

  • コマンドが開始され、入力を埅ちたす。サヌバヌ自䜓は機胜しおいたす。claude mcp get <name> を実行し、そこに衚瀺されるコマンドが実行したばかりのコマンドず䞀臎するこずを確認したす。衚瀺されるコマンドが入力したものず異なる堎合、サヌバヌコマンドの前に -- セパレヌタヌを省略した可胜性がありたす。サヌバヌを削陀し、-- を配眮しお再床远加したす。.mcp.json を手で曞いた堎合は、その構文ず堎所を確認したす。
  • コマンド゚ラヌメッセヌゞは Node.js やブラりザなど、䞍足しおいるものに名前を付けたす。
接続がスタヌトアップでタむムアりトしたした

サヌバヌはデフォルトの 30 秒スタヌトアップタむムアりトより長くかかりたした。stdio サヌバヌの最初の実行は、npx がパッケヌゞをダりンロヌドしおいる間に遅くなる可胜性がありたす。MCP_TIMEOUT環境倉数でミリ秒単䜍で制限を増やしたす。

MCP_TIMEOUT=60000 claude

PowerShell では、同じ行のコマンドの前に倉数を蚭定したす。

$env:MCP_TIMEOUT = "60000"; claude
サヌバヌは既に存圚したす

同じスコヌプで同じ名前のサヌバヌを既に远加しおいたす。既存の゚ントリを削陀するか、別の名前を遞択したす。

claude mcp remove claude-code-docs

名前が耇数のスコヌプに存圚する堎合、remove は exists in multiple scopes を報告したす。削陀するコピヌを遞択するために --scope を枡したす。䟋えば claude mcp remove claude-code-docs --scope local。

サヌバヌは接続したすが、ツヌルが衚瀺されたせん

セッション内で /mcp を実行し、サヌバヌを遞択しおそのツヌルリストを確認したす。リストが空の堎合、サヌバヌは開始したしたが、ツヌルを登録したせんでした。これは通垞、API キヌなどの必芁な環境倉数が䞍足しおいるこずを意味したす。

claude mcp add で --env KEY=value を䜿甚しお倉数を枡すか、サヌバヌの .mcp.json ゚ントリの env フィヌルドで枡したす。サヌバヌのドキュメントは必芁な倉数をリストしたす。

.mcp.json ぞの倉曎が有効になりたせん

Claude Code はセッション開始時に .mcp.json を読み蟌みたす。ファむルを線集した埌、セッションを終了しお再開したす。

サヌバヌがただ衚瀺されない堎合は、/mcp を実行し、解析譊告を探したす。Claude Code は䞍正な圢匏の゚ントリをスキップし、そこに問題のあるフィヌルドを衚瀺したす。

以前にプロンプトを拒吊した堎合は、プロゞェクト承認をリセットしたす。

claude mcp reset-project-choices
OAuth サむンむンが倱敗するか、ブラりザが開きたせん

/mcp を実行し、サヌバヌを遞択しお、再床 Authenticate を遞択したす。ブラりザが自動的に開かない堎合は、タヌミナルに衚瀺される URL をコピヌしお手動で開きたす。固定コヌルバックポヌトず事前蚭定された認蚌情報に぀いおは、リモヌト MCP サヌバヌで認蚌するを参照しおください。

次のステップ

1 ぀のサヌバヌが接続されたら、MCP が有効にする残りを探玢したす。