Source: https://aiprimetech.io/ja/claude-code/mcp/

[ホーム](/ja/) › [Claude Code](/ja/claude-code/) › MCP

[概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース？](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/)

最終更新：2026年10月11日

# Claude CodeのMCP：サーバー接続、スコープ、リモートMCPと実例

MCP（Model Context Protocol）は、Claude Code がリポジトリ内のファイル以外のものにアクセスするための仕組みです。データベース、ブラウザー、GitHub、分析データ、チケット管理ツールなどが対象です。サーバーがツールとリソースを公開し、Claude Code が接続すると、エージェントは組み込みツールと同じようにそれらを利用できます。設定はサーバーごとにコマンドを実行するだけです。

## TLDR
- claude mcp add <name> -- <command> ローカル（stdio）サーバー用。 claude mcp add --transport http <name> <url> リモートサーバー用。
- スコープ：local（自分、このプロジェクト）、project（.mcp.json、リポジトリで共有）、user（自分、すべてのプロジェクト）。
- /mcp をセッション内で実行すると、状態の表示、OAuth サーバーの認証、ツールの一覧表示ができます。
- リソースは @メンションで参照でき、サーバーのプロンプトはスラッシュコマンドとして表示されます。

## サーバーの追加 

```
# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright
```

stdio サーバーは、Claude Code が起動するプログラムです。コミュニティ製サーバーの多くは、この方式で実行する npm または Python パッケージです。リモートサーバーは URL で指定し、OAuth（セッション内で /mcp を実行し、ブラウザーで認証手順を進めます）または追加時に渡すヘッダーで認証します。後者は PostHog の例で示しています。リモートエンドポイントは変更されることがあるため、最新の URL は各ベンダーのドキュメントで確認してください。 

## スコープと .mcp.json 
- local （デフォルト）— ユーザー設定に保存され、このプロジェクトだけで使用されます。個人用の非公開サーバー向けです。
- project (--scope project）— リポジトリのルートにある .mcp.json に書き込まれ、クローンした全員と共有されます。Claude Code は初回に、そのプロジェクトのサーバーを信頼するか確認します。
- user (--scope user）— マシン上のすべてのプロジェクトで利用できます。 

```
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}
```

.mcp.json は環境変数の展開に対応しているため、サーバー定義をリポジトリに含め、各開発者が自分の認証情報を設定できます。 

## セッションでのサーバーの利用 

接続すると、サーバーのツールをそのまま利用できます。「PostHog の過去 24 時間のエラー」を求めると、Claude Code がツールを呼び出します。サーバーが公開するリソースは @メンション（@github:issue://123）で参照でき、必要に応じてコンテキストに取り込まれます。サーバーが定義するプロンプトは、次の配下にスラッシュコマンドとして表示されます： /mcp__<server>__<prompt>. /mcp は接続状態を表示し、再接続や認証を行えるほか、すべてのツールを説明付きで一覧表示します。 

## コピーして使える例 
- PostHog MCP — エージェント内からプロダクト分析を利用できます。「このコードはどの機能フラグで制御されていて、ロールアウト状況はどうなっていますか？」PostHog はリモート MCP サーバーを公開しています。追加には --transport http を使い、個人用 API キーを Bearer ヘッダーとして指定します。
- GitHub — Issue とプルリクエストをコンテキストとして利用できます。GitHub ガイドの Action と組み合わせて、レビューのサイクルを回せます。
- Playwright — エンドツーエンドテストや、変更したばかりの UI の確認に使える実際のブラウザーです。QA 自動化ガイドを参照してください。
- Postgres / SQLite — スキーマを認識したクエリとマイグレーション。書き込みを意図している場合を除き、読み取り専用ユーザーを設定してください。
- リポジトリ外のファイルシステム — --add-dir のほうが、追加のディレクトリを扱うには簡単です。MCP はファイル以外のものを扱うための仕組みです。 

## コストとコンテキスト 

MCP サーバーが返すツールの結果はすべて会話に入り、その後の各ターンで再送信されます。5,000 行を返すサーバーは、コンテキストを爆発的に消費します。件数制限のあるツールを優先し、要約を求め、 /compact を大量の結果を返すクエリの後に実行してください。サーバーはローカルまたはベンダー側で動作し、モデルのエンドポイントを経由しないため、 ANTHROPIC_BASE_URL=https://aiprimetech.io には影響しません。課金されるのは、結果が消費するトークンだけです。

## まずは無料で試す

新規アカウントには $5分の無料APIクレジット を、コード CLAUDECODE で提供します。SonnetでClaude Codeを一晩試すのに十分な額です。その後は額面の7.69231倍のクレジットを利用できます。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[コードCLAUDECODEでアカウントを作成](/register?promo=CLAUDECODE)

## よくある質問

Claude Code に MCP サーバーを追加するにはどうすればよいですか？

ローカルサーバーには `claude mcp add <name> -- <command>`、リモートサーバーには `claude mcp add --transport http <name> <url>` を使います。.mcp.json で共有するには `--scope project` を追加してください。PostHog を Claude Code に接続するにはどうすればよいですか？

PostHog の MCP ドキュメントに記載された URL を使い、`claude mcp add --transport http posthog <url> --header "Authorization: Bearer <api key>"` で PostHog のリモート MCP サーバーを追加します。その後、セッション内でイベント、フラグ、エラーについて質問してください。MCP はゲートウェイ経由でも使えますか？

はい。MCP サーバーはローカルまたはベンダー側で動作し、モデルのエンドポイントから独立しています。ゲートウェイ経由で課金されるのは、その結果が消費するトークンだけです。

## ゲートウェイでClaude Codeを実行

同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードCLAUDECODEで$5分の無料APIクレジット。[APIキーを取得](/register?promo=CLAUDECODE) [無制限プランを見る](/ja/plans/)

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

## その他のClaude Codeガイド

[Claude Code：完全ガイド](/ja/claude-code/)[Claude Codeのインストール方法](/ja/claude-code/install/)[Claude Code CLIドキュメント：コマンドとフラグ](/ja/claude-code/cli/)[Claude Codeの料金と制限を解説](/ja/claude-code/pricing/)[Claude Code SDKからClaude Agent SDKへ](/ja/claude-code/sdk/)[Claude Codeのスキルとプラグイン](/ja/claude-code/skills/)[GitHubでのClaude Code：App、Action、@claude](/ja/claude-code/github/)[Claude Codeにウェブインターフェースはある？ウェブ、デスクトップ、IDEを解説](/ja/claude-code/web-and-desktop/)[Claude Codeが使用するモデルと変更方法](/ja/claude-code/models/)[Claude Codeのエラーと修正方法](/ja/claude-code/errors/)[Claude Codeはオープンソースですか？](/ja/claude-code/open-source/)[Claude Codeチュートリアル：初めての実践セッション](/ja/claude-code/tutorial/)[学生向けClaude：Claude Code、API、教育向け提供で実際に得られるもの](/ja/claude-code/for-students/)[QA自動化にClaude Codeを使う方法](/ja/claude-code/qa-automation/)[Claude CodeとCursorの比較：どちらをいつ使うか、そして両方を併用する方法](/ja/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode：ターミナルエージェントの比較](/ja/claude-code/vs-codex/)[Claude Codeのサブエージェント：仕組み、定義方法、エージェントチーム](/ja/claude-code/subagents/)[Claude Codeのフック：エージェントの動作を決定論的に制御する](/ja/claude-code/hooks/)[Claude Codeのエコシステム：ルーター、フレームワーク、プラグインと、それらをまとめたリスト](/ja/claude-code/ecosystem/)[VS Codeで使うClaude Code：拡張機能、ターミナル経由の利用、エラー](/ja/claude-code/vscode/)[Claude CodeでOpenRouterを使う方法（使わないほうがよい場合も）](/ja/claude-code/openrouter/)[Claudeのレート制限エラー：「API error: rate limit reached」の意味と解決方法](/ja/claude-code/rate-limits/)[Claude Codeの使い方：インストールから日常的な利用まで](/claude-code/zh/)