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

サーバーの追加

# 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 には影響しません。課金されるのは、結果が消費するトークンだけです。

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

よくある質問

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