MCP を使用して Claude Code をツールに接続する

Model Context Protocol を使用して Claude Code をツールに接続する方法を学びます。

Claude Code は、AI ツール統合のためのオープンソース標準である Model Context Protocol (MCP) を通じて、数百の外部ツールとデータソースに接続できます。MCP サーバーは Claude Code にツール、データベース、API へのアクセスを提供します。

別のツール（課題追跡ツールや監視ダッシュボードなど）からチャットにデータをコピーしている場合は、サーバーを接続してください。接続すると、Claude は貼り付けたものから作業する代わりに、そのシステムを直接読み取り、操作できます。

MCP でできること

MCP サーバーが接続されている場合、Claude Code に以下のことを依頼できます：

課題追跡ツールから機能を実装する：「JIRA の課題 ENG-4521 に記載されている機能を追加し、GitHub に PR を作成してください。」
監視データを分析する：「Sentry と Statsig をチェックして、ENG-4521 に記載されている機能の使用状況を確認してください。」
データベースをクエリする：「PostgreSQL データベースに基づいて、ENG-4521 機能を使用した 10 人のランダムなユーザーのメールアドレスを検索してください。」
デザインを統合する：「Slack に投稿された新しい Figma デザインに基づいて、標準メールテンプレートを更新してください。」
ワークフローを自動化する：「新機能に関するフィードバックセッションに招待する 10 人のユーザーに Gmail ドラフトを作成してください。」
外部イベントに対応する：MCP サーバーはチャネルとして機能することもでき、セッションにメッセージをプッシュするため、Claude は離席中に Telegram メッセージ、Discord チャット、または webhook イベントに対応できます。

MCP サーバーを検索してビルドする

Anthropic Directory でレビュー済みのコネクタを参照してください。Directory コネクタは Claude Code と同じ MCP インフラストラクチャを使用しているため、claude mcp add を使用して、そこにリストされているリモートサーバーを追加できます。

独自のサーバーをビルドするには、プロトコルの基礎については MCP サーバーガイドを、認証、テスト、Directory への提出については Claude コネクタビルディングドキュメントを参照してください。

公式の mcp-server-dev プラグインを使用して、Claude にサーバーをスキャフォルドしてもらうこともできます。

プラグインをインストールする

Claude Code セッションで、以下を実行します：

/plugin install mcp-server-dev@claude-plugins-official

次に /reload-plugins を実行して、現在のセッションでアクティブにします。

ビルドスキルを実行する

/mcp-server-dev:build-mcp-server

Claude があなたのユースケースについて質問し、リモート HTTP またはローカル stdio サーバーをスキャフォルドします。

MCP サーバーのインストール

MCP サーバーは、ニーズに応じて 3 つの異なる方法で設定できます：

オプション 1：リモート HTTP サーバーを追加する

HTTP サーバーはリモート MCP サーバーに接続するための推奨オプションです。これはクラウドベースのサービスに最も広くサポートされているトランスポートです。

# 基本的な構文
claude mcp add --transport http <name> <url>

# 実際の例：Notion に接続する
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Bearer トークンを使用した例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

MCP サーバーを .mcp.json、~/.claude.json、または claude mcp add-json で JSON を使用して設定する場合、type フィールドは http のエイリアスとして streamable-http を受け入れます。MCP 仕様ではこのトランスポートに streamable-http という名前を使用しているため、サーバードキュメントからコピーされた設定は変更なしで機能します。

オプション 2：リモート SSE サーバーを追加する

# 基本的な構文
claude mcp add --transport sse <name> <url>

# 実際の例：Asana に接続する
claude mcp add --transport sse asana https://mcp.asana.com/sse

# 認証ヘッダーを使用した例
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

オプション 3：ローカル stdio サーバーを追加する

Stdio サーバーはマシン上でローカルプロセスとして実行されます。システムへの直接アクセスやカスタムスクリプトが必要なツールに最適です。

Claude Code は、生成されたサーバーの環境に CLAUDE_PROJECT_DIR を設定して、プロジェクトルートを指定するため、サーバーは作業ディレクトリに依存することなくプロジェクト相対パスを解決できます。これは hooks が CLAUDE_PROJECT_DIR 変数で受け取るのと同じディレクトリです。サーバープロセス内から読み取ります。例えば、Node では process.env.CLAUDE_PROJECT_DIR、Python では os.environ["CLAUDE_PROJECT_DIR"] です。サーバーは MCP roots/list リクエストを呼び出すこともでき、Claude Code が起動されたディレクトリを返します。

この変数はサーバーの環境に設定され、Claude Code 自体の環境には設定されないため、プロジェクトスコープまたはユーザースコープの .mcp.json command または args で ${VAR} 展開を使用して参照するには、${CLAUDE_PROJECT_DIR:-.} などのデフォルトが必要です。プラグイン提供の MCP 設定は ${CLAUDE_PROJECT_DIR} を直接置換し、デフォルトは必要ありません。

# 基本的な構文
claude mcp add [options] <name> -- <command> [args...]

# 実際の例：Airtable サーバーを追加する
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

サーバーの管理

設定後、これらのコマンドで MCP サーバーを管理できます：

# すべての設定済みサーバーをリストする
claude mcp list

# 特定のサーバーの詳細を取得する
claude mcp get github

# サーバーを削除する
claude mcp remove github

# （Claude Code 内）サーバーのステータスを確認する
/mcp

/mcp パネルは、接続されている各サーバーの横にツール数を表示し、ツール機能をアドバタイズしているが、ツールを公開していないサーバーにフラグを立てます。

サーバー名 workspace は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。

動的ツール更新

Claude Code は MCP list_changed 通知をサポートしており、MCP サーバーが切断して再接続することなく、利用可能なツール、プロンプト、リソースを動的に更新できます。MCP サーバーが list_changed 通知を送信すると、Claude Code はそのサーバーから利用可能な機能を自動的に更新します。

自動再接続

HTTP または SSE サーバーがセッション中に切断された場合、Claude Code は指数バックオフで自動的に再接続します：最大 5 回の試行、1 秒の遅延から始まり、毎回 2 倍になります。サーバーは再接続が進行中の間、/mcp では保留中として表示されます。5 回の失敗した試行の後、サーバーは失敗としてマークされ、/mcp から手動で再試行できます。Stdio サーバーはローカルプロセスであり、自動的には再接続されません。

同じバックオフは、HTTP または SSE サーバーが起動時に初期接続に失敗した場合にも適用されます。v2.1.121 以降、Claude Code は 5xx レスポンス、接続拒否、タイムアウトなどの一時的なエラーで初期接続を最大 3 回再試行し、それでも接続できない場合はサーバーを失敗としてマークします。認証エラーと見つからないエラーは、解決するために設定変更が必要なため、再試行されません。

チャネルでメッセージをプッシュする

MCP サーバーはセッションに直接メッセージをプッシュすることもでき、Claude が CI 結果、監視アラート、チャットメッセージなどの外部イベントに対応できます。これを有効にするには、サーバーが claude/channel 機能を宣言し、起動時に --channels フラグでオプトインします。公式にサポートされているチャネルを使用するにはチャネルを参照するか、独自に構築するにはチャネルリファレンスを参照してください。

Tip

ヒント：

--scope フラグを使用して、設定が保存される場所を指定します：
local（デフォルト）：現在のプロジェクトでのみ利用可能（古いバージョンでは project と呼ばれていました）
project：.mcp.json ファイルを通じてプロジェクト内のすべてのユーザーと共有
user：すべてのプロジェクト全体で利用可能（古いバージョンでは global と呼ばれていました）
--env フラグで環境変数を設定します（例：--env KEY=value）
MCP_TIMEOUT 環境変数を使用して MCP サーバーのスタートアップタイムアウトを設定します（例：MCP_TIMEOUT=10000 claude は 10 秒のタイムアウトを設定します）
Claude Code は MCP ツール出力が 10,000 トークンを超えると警告を表示します。この制限を増やすには、MAX_MCP_OUTPUT_TOKENS 環境変数を設定します（例：MAX_MCP_OUTPUT_TOKENS=50000）
/mcp を使用して、OAuth 2.0 認証が必要なリモートサーバーで認証します

プラグイン提供の MCP サーバー

プラグインは MCP サーバーをバンドルでき、プラグインが有効になると自動的にツールと統合を提供します。プラグイン MCP サーバーはユーザーが設定したサーバーと同じように機能します。

プラグイン MCP サーバーの仕組み：

プラグインはプラグインルートの .mcp.json または plugin.json 内でインラインで MCP サーバーを定義します
プラグインが有効になると、その MCP サーバーが自動的に起動します
プラグイン MCP ツールは手動で設定された MCP ツールと一緒に表示されます
プラグインサーバーはプラグインのインストールを通じて管理されます（/mcp コマンドではありません）

プラグイン MCP 設定の例：

プラグインルートの .mcp.json 内：

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

または plugin.json 内でインライン：

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

プラグイン MCP 機能：

自動ライフサイクル：セッション起動時に、有効なプラグインのサーバーが自動的に接続されます。セッション中にプラグインを有効または無効にする場合は、/reload-plugins を実行して MCP サーバーを接続または切断してください
環境変数：バンドルされたプラグインファイルに ${CLAUDE_PLUGIN_ROOT} を使用し、プラグイン更新を通じて保持される永続的な状態に ${CLAUDE_PLUGIN_DATA} を使用し、安定したプロジェクトルートに ${CLAUDE_PROJECT_DIR} を使用します
ユーザー環境アクセス：手動で設定されたサーバーと同じ環境変数へのアクセス
複数のトランスポートタイプ：stdio、SSE、HTTP トランスポートをサポート（トランスポートサポートはサーバーによって異なる場合があります）

プラグイン MCP サーバーの表示：

# Claude Code 内で、プラグインのものを含むすべての MCP サーバーを表示
/mcp

プラグインサーバーはプラグインから来ていることを示すインジケータ付きでリストに表示されます。

プラグイン MCP サーバーの利点：

バンドル配布：ツールとサーバーが一緒にパッケージ化されます
自動セットアップ：手動の MCP 設定は不要です
チーム一貫性：プラグインがインストールされると、すべてのユーザーが同じツールを取得します

プラグインで MCP サーバーをバンドルする詳細については、プラグインコンポーネントリファレンスを参照してください。

MCP インストールスコープ

MCP サーバーは 3 つのスコープで設定できます。選択するスコープは、サーバーがロードされるプロジェクトと、設定がチームと共有されるかどうかを制御します。管理者は、マネージド設定を通じてエンタープライズレベルでサーバーをデプロイすることもできます。

スコープ	ロード対象	チームと共有	保存場所
ローカル	現在のプロジェクトのみ	いいえ	`~/.claude.json`
プロジェクト	現在のプロジェクトのみ	はい、バージョン管理経由	プロジェクトルートの `.mcp.json`
ユーザー	すべてのプロジェクト	いいえ	`~/.claude.json`

ローカルスコープ

ローカルスコープはデフォルトです。ローカルスコープのサーバーは、追加したプロジェクトでのみロードされ、あなたにプライベートなままです。Claude Code は ~/.claude.json のそのプロジェクトのパスの下に保存するため、同じサーバーは他のプロジェクトに表示されません。個人開発サーバー、実験的な設定、またはバージョン管理に含めたくない認証情報を持つサーバーにはローカルスコープを使用してください。

# ローカルスコープのサーバーを追加する（デフォルト）
claude mcp add --transport http stripe https://mcp.stripe.com

# ローカルスコープを明示的に指定する
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

コマンドは現在のプロジェクトのエントリを ~/.claude.json に書き込みます。以下の例は、/path/to/your/project から実行した場合の結果を示しています：

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

プロジェクトスコープ

プロジェクトスコープのサーバーは、プロジェクトのルートディレクトリの .mcp.json ファイルに設定を保存することで、チーム間のコラボレーションを可能にします。このファイルはバージョン管理にチェックインするように設計されており、すべてのチームメンバーが同じ MCP ツールとサービスにアクセスできることを保証します。プロジェクトスコープのサーバーを追加すると、Claude Code は自動的にこのファイルを作成または更新して、適切な設定構造を使用します。

# プロジェクトスコープのサーバーを追加する
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

結果の .mcp.json ファイルは標準化された形式に従います：

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

セキュリティ上の理由から、Claude Code は .mcp.json ファイルからプロジェクトスコープのサーバーを使用する前に承認を求めます。これらの承認選択をリセットする必要がある場合は、claude mcp reset-project-choices コマンドを使用してください。

ユーザースコープ

ユーザースコープのサーバーは ~/.claude.json に保存され、クロスプロジェクトのアクセス可能性を提供し、マシン上のすべてのプロジェクト全体で利用可能になりながら、ユーザーアカウントにプライベートなままです。このスコープは、個人的なユーティリティサーバー、開発ツール、または異なるプロジェクト全体で頻繁に使用するサービスに適しています。

# ユーザーサーバーを追加する
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

スコープの階層と優先順位

同じサーバーが複数の場所で定義されている場合、Claude Code はそれに 1 回接続し、最も優先度の高いソースからの定義を使用します：

ローカルスコープ
プロジェクトスコープ
ユーザースコープ
プラグイン提供サーバー
claude.ai コネクタ

3 つのスコープは名前で重複を照合します。プラグインとコネクタはエンドポイントで照合するため、上記のサーバーと同じ URL またはコマンドを指すものは重複として扱われます。

`.mcp.json` での環境変数の展開

Claude Code は .mcp.json ファイルの環境変数の展開をサポートしており、チームが設定を共有しながら、マシン固有のパスと API キーなどの機密値の柔軟性を維持できます。

サポートされている構文：

${VAR} - 環境変数 VAR の値に展開されます
${VAR:-default} - VAR が設定されている場合は VAR に展開され、そうでない場合はデフォルトを使用します

展開場所： 環境変数は以下で展開できます：

command - サーバー実行可能ファイルのパス
args - コマンドライン引数
env - サーバーに渡される環境変数
url - HTTP サーバータイプの場合
headers - HTTP サーバー認証の場合

変数展開を使用した例：

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

必要な環境変数が設定されておらず、デフォルト値がない場合、Claude Code は設定の解析に失敗します。

実践的な例

{/* ### 例：Playwright でブラウザテストを自動化する

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

その後、ブラウザテストを作成して実行します：

test@example.com でログインフローが機能するかテストしてください

モバイルでチェックアウトページのスクリーンショットを撮ってください

検索機能が結果を返すことを確認してください
``` */}

### 例：Sentry でエラーを監視する

```bash theme={null}
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Sentry アカウントで認証します：

/mcp

その後、本番環境の問題をデバッグします：

過去 24 時間で最も一般的なエラーは何ですか？

エラー ID abc123 のスタックトレースを表示してください

どのデプロイメントがこれらの新しいエラーを導入しましたか？

例：コードレビューのために GitHub に接続する

GitHub のリモート MCP サーバーは、ヘッダーとして渡される GitHub 個人アクセストークンで認証します。取得するには、GitHub トークン設定を開き、Claude が操作したいリポジトリへのアクセス権を持つ新しいきめ細かいトークンを生成してから、サーバーを追加します：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

その後、GitHub で作業します：

PR #456 をレビューして改善を提案してください

見つけたバグの新しい課題を作成してください

自分に割り当てられているすべてのオープン PR を表示してください

例：PostgreSQL データベースをクエリする

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

その後、データベースを自然に照会します：

今月の総収益はいくらですか？

orders テーブルのスキーマを表示してください

過去 90 日間に購入していない顧客を検索してください

リモート MCP サーバーで認証する

多くのクラウドベースの MCP サーバーは認証が必要です。Claude Code は安全な接続のために OAuth 2.0 をサポートしています。

Claude Code は、サーバーが 401 Unauthorized と認可サーバーを指す WWW-Authenticate ヘッダーで応答するときに、リモートサーバーが認証を必要とするとマークします。その応答を返すカスタムサーバーは、他のリモートサーバーと同じ /mcp 認証フローを取得します。

認証が必要なサーバーを追加する

例：

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

Claude Code 内で /mcp コマンドを使用する

Claude Code で、コマンドを使用します：

/mcp

その後、ブラウザでログインするための手順に従ってください。

固定 OAuth コールバックポートを使用する

一部の MCP サーバーは、事前に登録された特定のリダイレクト URI が必要です。デフォルトでは、Claude Code は OAuth コールバック用にランダムに利用可能なポートを選択します。--callback-port を使用してポートを固定し、http://localhost:PORT/callback の形式の事前登録されたリダイレクト URI と一致させます。

--callback-port を単独で使用できます（動的クライアント登録を使用）、または --client-id と一緒に使用できます（事前設定された認証情報を使用）。

# 動的クライアント登録を使用した固定コールバックポート
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

事前設定された OAuth 認証情報を使用する

一部の MCP サーバーは、Dynamic Client Registration を通じた自動 OAuth セットアップをサポートしていません。「Incompatible auth server: does not support dynamic client registration」のようなエラーが表示される場合、サーバーは事前設定された認証情報が必要です。Claude Code は Client ID Metadata Document（CIMD）を使用するサーバーもサポートしており、これらを自動的に検出します。自動検出に失敗した場合は、まずサーバーの開発者ポータルを通じて OAuth アプリを登録し、サーバーを追加するときに認証情報を提供してください。

サーバーで OAuth アプリを登録する

サーバーの開発者ポータルを通じてアプリを作成し、クライアント ID とクライアントシークレットをメモしてください。

多くのサーバーはリダイレクト URI も必要とします。その場合は、ポートを選択し、http://localhost:PORT/callback の形式でリダイレクト URI を登録してください。次のステップで --callback-port と同じポートを使用してください。

認証情報を使用してサーバーを追加する

次のいずれかの方法を選択してください。--callback-port に使用されるポートは、利用可能な任意のポートにすることができます。前のステップで登録したリダイレクト URI と一致する必要があります。

--client-id を使用してアプリのクライアント ID を渡します。--client-secret フラグはマスクされた入力でシークレットを求めます：

claude mcp add --transport http \
--client-id your-client-id --client-secret --callback-port 8080 \
my-server https://mcp.example.com/mcp

JSON 設定に oauth オブジェクトを含め、--client-secret を別のフラグとして渡します：

claude mcp add-json my-server \
'{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
--client-secret

動的クライアント登録を使用しながらポートを固定するには、クライアント ID なしで --callback-port を使用します：

claude mcp add-json my-server \
'{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

環境変数を通じてシークレットを設定して、対話的なプロンプトをスキップします：

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
--client-id your-client-id --client-secret --callback-port 8080 \
my-server https://mcp.example.com/mcp

Claude Code で認証する

Claude Code で /mcp を実行し、ブラウザのログインフローに従ってください。

OAuth メタデータ検出をオーバーライドする

Claude Code を特定の OAuth 認可サーバーメタデータ URL に指定して、デフォルトの検出チェーンをバイパスします。MCP サーバーの標準エンドポイントがエラーになる場合、または内部プロキシを通じて検出をルーティングしたい場合に設定します。デフォルトでは、Claude Code は最初に RFC 9728 保護リソースメタデータを /.well-known/oauth-protected-resource でチェックし、次に RFC 8414 認可サーバーメタデータを /.well-known/oauth-authorization-server でフォールバックします。

.mcp.json のサーバー設定の oauth オブジェクトに authServerMetadataUrl を設定します：

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

URL は https:// を使用する必要があります。authServerMetadataUrl には Claude Code v2.1.64 以降が必要です。メタデータ URL の scopes_supported は、アップストリームサーバーがアドバタイズするスコープをオーバーライドします。

OAuth スコープを制限する

oauth.scopes を設定して、認可フロー中に Claude Code がリクエストするスコープをピン留めします。これは、アップストリーム認可サーバーがより多くのスコープをアドバタイズする場合に、MCP サーバーをセキュリティチームが承認したサブセットに制限するサポートされた方法です。値は RFC 6749 §3.3 の scope パラメータ形式と一致する単一のスペース区切り文字列です。

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

oauth.scopes は authServerMetadataUrl と /.well-known でサーバーが検出するスコープの両方に優先します。MCP サーバーがリクエストするスコープセットを決定するようにするには、設定を解除したままにしてください。

認可サーバーが scopes_supported で offline_access をアドバタイズする場合、Claude Code はそれをピン留めされたスコープに追加して、新しいブラウザサインインなしでアクセストークンを更新できるようにします。

サーバーが後で insufficient_scope の 403 を返す場合、Claude Code は同じピン留めされたスコープで再認証します。必要なツールが pin の外側のスコープを必要とする場合は、oauth.scopes を拡張してください。

カスタム認証用の動的ヘッダーを使用する

MCP サーバーが OAuth 以外の認証スキーム（Kerberos、短期トークン、内部 SSO など）を使用する場合、headersHelper を使用して接続時にリクエストヘッダーを生成します。Claude Code はコマンドを実行し、その出力を接続ヘッダーにマージします。

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

コマンドはインラインにすることもできます：

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

要件：

コマンドは文字列キーと値のペアの JSON オブジェクトを stdout に書き込む必要があります
コマンドは 10 秒のタイムアウト付きのシェルで実行されます
動的ヘッダーは同じ名前の静的 headers をオーバーライドします

ヘルパーは各接続時に実行されます（セッション開始時と再接続時）。キャッシングはないため、スクリプトはトークンの再利用を担当します。

Claude Code は、ヘルパーを実行するときにこれらの環境変数を設定します：

変数	値
`CLAUDE_CODE_MCP_SERVER_NAME`	MCP サーバーの名前
`CLAUDE_CODE_MCP_SERVER_URL`	MCP サーバーの URL

これらを使用して、複数の MCP サーバーに対応する単一のヘルパースクリプトを作成できます。

JSON 設定から MCP サーバーを追加する

MCP サーバーの JSON 設定がある場合は、直接追加できます：

JSON から MCP サーバーを追加する

# 基本的な構文
claude mcp add-json <name> '<json>'

# 例：JSON 設定を使用して HTTP サーバーを追加する
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# 例：JSON 設定を使用して stdio サーバーを追加する
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# 例：事前設定された OAuth 認証情報を使用して HTTP サーバーを追加する
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

サーバーが追加されたことを確認する

claude mcp get weather-api

Claude Desktop から MCP サーバーをインポートする

Claude Desktop で MCP サーバーを既に設定している場合は、それらをインポートできます：

Claude Desktop からサーバーをインポートする

# 基本的な構文 
claude mcp add-from-claude-desktop

インポートするサーバーを選択する

コマンドを実行した後、インポートするサーバーを選択できる対話的なダイアログが表示されます。

サーバーがインポートされたことを確認する

claude mcp list

Claude.ai から MCP サーバーを使用する

Claude.ai アカウントで Claude Code にログインしている場合、Claude.ai で追加した MCP サーバーは Claude Code で自動的に利用可能です：

Claude.ai で MCP サーバーを設定する

claude.ai/customize/connectors でサーバーを追加します。Team および Enterprise プランでは、管理者のみがサーバーを追加できます。

MCP サーバーを認証する

Claude.ai で必要な認証ステップを完了します。

Claude Code でサーバーを表示および管理する

Claude Code で、以下のコマンドを使用します：

/mcp

Claude.ai サーバーはリストに表示され、Claude.ai から来ていることを示すインジケータが付きます。

Claude Code で追加したサーバーは、同じ URL を指す claude.ai コネクタより優先されます。この場合、/mcp はコネクタを非表示としてリストし、代わりにコネクタを使用する場合は重複を削除する方法を表示します。

Claude Code で claude.ai MCP サーバーを無効にするには、ENABLE_CLAUDEAI_MCP_SERVERS 環境変数を false に設定します：

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

Claude Code を MCP サーバーとして使用する

Claude Code 自体を MCP サーバーとして使用でき、他のアプリケーションが接続できます：

# Claude を stdio MCP サーバーとして起動する
claude mcp serve

これを Claude Desktop で使用するには、この設定を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

Warning

実行可能ファイルパスの設定：command フィールドは Claude Code 実行可能ファイルを参照する必要があります。claude コマンドがシステムの PATH にない場合は、実行可能ファイルへの完全なパスを指定する必要があります。

完全なパスを見つけるには：

which claude

その後、設定で完全なパスを使用します：

{
"mcpServers": {
"claude-code": {
"type": "stdio",
"command": "/full/path/to/claude",
"args": ["mcp", "serve"],
"env": {}
}
}
}

正しい実行可能ファイルパスがないと、spawn claude ENOENT のようなエラーが発生します。

MCP 出力制限と警告

MCP ツールが大きな出力を生成する場合、Claude Code はトークン使用量を管理して、会話コンテキストが圧倒されるのを防ぐのに役立ちます：

出力警告閾値：Claude Code は MCP ツール出力が 10,000 トークンを超えると警告を表示します
設定可能な制限：MAX_MCP_OUTPUT_TOKENS 環境変数を使用して、許可される最大 MCP 出力トークンを調整できます
デフォルト制限：デフォルトの最大値は 25,000 トークンです
スコープ：環境変数は独自の制限を宣言しないツールに適用されます。anthropic/maxResultSizeChars を設定するツールは、MAX_MCP_OUTPUT_TOKENS が何に設定されているかに関わらず、テキストコンテンツにその値を使用します。画像データを返すツールは引き続き MAX_MCP_OUTPUT_TOKENS の対象です

大きな出力を生成するツールの制限を増やすには：

export MAX_MCP_OUTPUT_TOKENS=50000
claude

これは特に以下を行う MCP サーバーで役立ちます：

大規模なデータセットまたはデータベースをクエリする
詳細なレポートまたはドキュメントを生成する
広範なログファイルまたはデバッグ情報を処理する

特定のツールの制限を引き上げる

MCP サーバーを構築している場合、ツールの tools/list 応答エントリで _meta["anthropic/maxResultSizeChars"] を設定することで、個々のツールがデフォルトの永続化ディスク閾値より大きい結果を返すことを許可できます。Claude Code はそのツールの閾値を注釈付き値に引き上げます。最大 500,000 文字のハードシーリングまで。

これは、データベーススキーマまたは完全なファイルツリーなど、本質的に大きいが必要な出力を返すツールに役立ちます。注釈がない場合、デフォルト閾値を超える結果はディスクに永続化され、会話内のファイル参照に置き換えられます。

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

注釈はテキストコンテンツの MAX_MCP_OUTPUT_TOKENS とは独立して適用されるため、ユーザーは注釈を宣言するツールのために環境変数を引き上げる必要はありません。画像データを返すツールは引き続きトークン制限の対象です。

MCP 応答要求に対応する

MCP サーバーはタスク中に構造化された入力をあなたに要求するための応答要求を使用できます。サーバーが独自に取得できない情報が必要な場合、Claude Code は対話的なダイアログを表示し、あなたの応答をサーバーに返します。設定は不要です。応答要求ダイアログはサーバーが要求したときに自動的に表示されます。

サーバーは 2 つの方法で入力を要求できます：

フォームモード：Claude Code はサーバーで定義されたフォームフィールド（例：ユーザー名とパスワードプロンプト）を含むダイアログを表示します。フィールドに入力して送信します。
URL モード：Claude Code はブラウザ URL を開いて認証または承認を行います。ブラウザでフローを完了し、CLI で確認します。

応答要求に自動応答するには、Elicitation フックを使用してください。

MCP サーバーを構築していて応答要求を使用する場合は、MCP 応答要求仕様を参照してプロトコルの詳細とスキーマの例を確認してください。

MCP リソースを使用する

MCP サーバーはリソースを公開でき、ファイルを参照する方法と同様に @ メンションを使用して参照できます。

MCP リソースを参照する

利用可能なリソースをリストする

プロンプトで @ を入力して、接続されているすべての MCP サーバーから利用可能なリソースを表示します。リソースはオートコンプリートメニューのファイルと一緒に表示されます。

特定のリソースを参照する

@server:protocol://resource/path の形式を使用してリソースを参照します：

@github:issue://123 を分析して修正を提案できますか？

@docs:file://api/authentication の API ドキュメントをレビューしてください

複数のリソース参照

1 つのプロンプトで複数のリソースを参照できます：

@postgres:schema://users と @docs:file://database/user-model を比較してください

MCP ツール検索でスケーリングする

ツール検索は MCP コンテキスト使用量を低く保つことで、ツール定義をオンデマンドで遅延させます。セッション開始時にはツール名のみがロードされるため、より多くの MCP サーバーを追加してもコンテキストウィンドウへの影響は最小限です。

仕組み

ツール検索はデフォルトで有効です。MCP ツールは事前にコンテキストにロードされるのではなく、遅延されます。Claude はタスクが必要な場合、検索ツールを使用して関連する MCP ツールを検出します。Claude が実際に使用するツールのみがコンテキストに入ります。あなたの視点からは、MCP ツールは以前と同じように機能します。

しきい値ベースのロードを優先する場合は、ENABLE_TOOL_SEARCH=auto を設定して、コンテキストウィンドウの 10% 以内に収まる場合はスキーマを事前にロードし、オーバーフローのみを遅延させます。すべてのオプションについては、ツール検索の設定を参照してください。

MCP サーバー作成者向け

MCP サーバーを構築している場合、ツール検索が有効になっているとサーバー命令フィールドがより有用になります。サーバー命令は、スキルの仕組みと同様に、Claude がいつサーバーのツールを検索するかを理解するのに役立ちます。

明確で説明的なサーバー命令を追加して、以下を説明します：

ツールが処理するタスクのカテゴリ
Claude がツールを検索すべき場合
サーバーが提供する主な機能

Claude Code はツール説明とサーバー命令を各 2KB で切り詰めます。切り詰めを避けるために簡潔に保ち、重要な詳細を最初に配置してください。

ツール検索を設定する

ツール検索はデフォルトで有効です：MCP ツールは遅延され、オンデマンドで検出されます。Vertex AI ではデフォルトで無効です。これは tool_reference ブロックを受け入れないためです。ANTHROPIC_BASE_URL が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは tool_reference ブロックを転送しないためです。プロキシが tool_reference ブロックを転送する場合は、ENABLE_TOOL_SEARCH を明示的に設定してフォールバックをオーバーライドしてください。この機能には、tool_reference ブロックをサポートするモデルが必要です：Sonnet 4 以降、または Opus 4 以降。Haiku モデルはツール検索をサポートしていません。

ENABLE_TOOL_SEARCH 環境変数でツール検索の動作を制御します：

値	動作
（未設定）	すべての MCP ツールが遅延され、オンデマンドでロードされます。Vertex AI または `ANTHROPIC_BASE_URL` が非ファーストパーティホストの場合はアップフロントロードにフォールバック
`true`	すべての MCP ツールが遅延。Claude Code は Vertex AI およびプロキシ経由でもベータヘッダーを送信します。バックエンドが `tool_reference` ブロックをサポートしない場合、リクエストは失敗します
`auto`	しきい値モード：ツールがコンテキストウィンドウの 10% 以内に収まる場合はアップフロントロード、そうでない場合は遅延
`auto:<N>`	カスタムパーセンテージ付きしきい値モード。`<N>` は 0-100（例：5% の場合は `auto:5`）
`false`	すべての MCP ツールがアップフロントロード、遅延なし

# カスタム 5% しきい値を使用する
ENABLE_TOOL_SEARCH=auto:5 claude

# ツール検索を完全に無効にする
ENABLE_TOOL_SEARCH=false claude

または、settings.json env フィールドで値を設定します。

ToolSearch ツールを特別に無効にすることもできます：

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

サーバーを遅延から除外する

サーバーのツールが検索ステップなしで常に Claude に表示される場合は、そのサーバーの設定で alwaysLoad を true に設定します。そのサーバーのすべてのツールは、ENABLE_TOOL_SEARCH 設定に関係なく、セッション開始時にコンテキストにロードされます。これは、Claude がすべてのターンで必要とする少数のツールに使用してください。各アップフロントツールはコンテキストを消費するため、会話に利用可能なコンテキストが減少します。

次の .mcp.json エントリは、1 つの HTTP サーバーを除外し、他のサーバーは遅延したままにします：

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

alwaysLoad フィールドはすべてのサーバータイプで利用可能で、Claude Code v2.1.121 以降が必要です。MCP サーバーは、ツールの _meta オブジェクトに "anthropic/alwaysLoad": true を含めることで、個別のツールを常にロードとしてマークすることもできます。これはそのツールのみに同じ効果があります。

alwaysLoad: true を設定すると、サーバーが接続されるまでスタートアップもブロックされます。これは標準的な 5 秒の接続タイムアウトでキャップされます。これは MCP_CONNECTION_NONBLOCKING=1 が設定されている場合でも適用されます。ツールは最初のプロンプトが構築されるときに存在する必要があるためです。他のサーバーは、ノンブロッキングが有効な場合、バックグラウンドで接続し続けます。

MCP プロンプトをコマンドとして使用する

MCP サーバーはプロンプトを公開でき、Claude Code でコマンドとして利用可能になります。

MCP プロンプトを実行する

利用可能なプロンプトを検出する

/ を入力して、MCP サーバーからのプロンプトを含むすべての利用可能なコマンドを表示します。MCP プロンプトは /mcp__servername__promptname の形式で表示されます。

引数なしでプロンプトを実行する

/mcp__github__list_prs

引数を使用してプロンプトを実行する

多くのプロンプトは引数を受け入れます。コマンドの後にスペース区切りで渡します：

/mcp__github__pr_review 456

/mcp__jira__create_issue "ログインフローのバグ" high

管理対象 MCP 設定

MCP サーバーの集中管理が必要な組織の場合、Claude Code は 2 つの設定オプションをサポートしています：

managed-mcp.json による排他的制御：ユーザーが変更または拡張できない固定の MCP サーバーセットをデプロイします
許可リスト/拒否リストによるポリシーベースの制御：ユーザーが独自のサーバーを追加できるようにしますが、許可されているサーバーを制限します

これらのオプションにより、IT 管理者は以下を実行できます：

従業員がアクセスできる MCP サーバーを制御する：組織全体で承認された MCP サーバーの標準化されたセットをデプロイします
不正な MCP サーバーを防止する：ユーザーが未承認の MCP サーバーを追加するのを制限します
MCP を完全に無効にする：必要に応じて MCP 機能を完全に削除します

オプション 1：`managed-mcp.json` による排他的制御

managed-mcp.json ファイルをデプロイすると、すべての MCP サーバーに対して排他的な制御が行われます。ユーザーはこのファイルで定義されているもの以外の MCP サーバーを追加、変更、または使用することはできません。これは、完全な制御を望む組織にとって最も単純なアプローチです。

システム管理者は、設定ファイルをシステム全体のディレクトリにデプロイします：

macOS：/Library/Application Support/ClaudeCode/managed-mcp.json
Linux および WSL：/etc/claude-code/managed-mcp.json
Windows：C:\Program Files\ClaudeCode\managed-mcp.json

managed-mcp.json ファイルは標準的な .mcp.json ファイルと同じ形式を使用します：

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

オプション 2：許可リストと拒否リストによるポリシーベースの制御

排他的な制御を行う代わりに、管理者はユーザーが独自の MCP サーバーを設定できるようにしながら、許可されているサーバーに制限を適用できます。このアプローチは、管理対象設定ファイルの allowedMcpServers と deniedMcpServers を使用します。

制限オプション

許可リストまたは拒否リストの各エントリは、3 つの方法でサーバーを制限できます：

サーバー名による （serverName）：設定されたサーバーの名前と一致します
コマンドによる （serverCommand）：stdio サーバーを起動するために使用される正確なコマンドと引数と一致します
URL パターンによる （serverUrl）：ワイルドカードサポート付きのリモートサーバー URL と一致します

重要：各エントリは serverName、serverCommand、または serverUrl のいずれか 1 つだけを持つ必要があります。

設定例

{
  "allowedMcpServers": [
    // サーバー名で許可
    { "serverName": "github" },
    { "serverName": "sentry" },

    // 正確なコマンドで許可（stdio サーバーの場合）
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },

    // URL パターンで許可（リモートサーバーの場合）
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ],
  "deniedMcpServers": [
    // サーバー名でブロック
    { "serverName": "dangerous-server" },

    // 正確なコマンドでブロック（stdio サーバーの場合）
    { "serverCommand": ["npx", "-y", "unapproved-package"] },

    // URL パターンでブロック（リモートサーバーの場合）
    { "serverUrl": "https://*.untrusted.com/*" }
  ]
}

コマンドベースの制限の仕組み

完全一致：

コマンド配列は完全に一致する必要があります。コマンドと正しい順序のすべての引数
例：["npx", "-y", "server"] は ["npx", "server"] または ["npx", "-y", "server", "--flag"] と一致しません

Stdio サーバーの動作：

許可リストに任意の serverCommand エントリが含まれている場合、stdio サーバーはそれらのコマンドの 1 つと一致する必要があります
Stdio サーバーはコマンド制限が存在する場合、名前だけでは通過できません
これにより、管理者は実行が許可されているコマンドを強制できます

非 stdio サーバーの動作：

リモートサーバー（HTTP、SSE、WebSocket）は、許可リストに serverUrl エントリが存在する場合、URL ベースのマッチングを使用します
URL エントリが存在しない場合、リモートサーバーは名前ベースのマッチングにフォールバックします
コマンド制限はリモートサーバーには適用されません

URL ベースの制限の仕組み

URL パターンは * を使用してワイルドカードをサポートし、任意の文字シーケンスと一致します。これはドメイン全体またはサブドメイン全体を許可するのに役立ちます。

ワイルドカード例：

https://mcp.company.com/* - 特定のドメイン上のすべてのパスを許可
https://*.example.com/* - example.com の任意のサブドメインを許可
http://localhost:*/* - localhost 上の任意のポートを許可

ホスト名マッチングは大文字と小文字を区別せず、末尾の FQDN ドットを無視し、DNS セマンティクスと一致します。*://Mcp.Example.com/* のようなパターンは https://mcp.example.com/api と一致し、https://mcp.example.com. は https://mcp.example.com と同じように扱われます。スキームとパスは大文字と小文字を区別します。

リモートサーバーの動作：

許可リストに任意の serverUrl エントリが含まれている場合、リモートサーバーはそれらの URL パターンの 1 つと一致する必要があります
リモートサーバーは URL 制限が存在する場合、名前だけでは通過できません
これにより、管理者は許可されているリモートエンドポイントを強制できます

例：URL のみの許可リスト

{
"allowedMcpServers": [
{ "serverUrl": "https://mcp.company.com/*" },
{ "serverUrl": "https://*.internal.corp/*" }
]
}

結果：

https://mcp.company.com/api の HTTP サーバー：✅ 許可（URL パターンと一致）
https://api.internal.corp/mcp の HTTP サーバー：✅ 許可（ワイルドカードサブドメインと一致）
https://external.com/mcp の HTTP サーバー：❌ ブロック（URL パターンと一致しない）
任意のコマンドの Stdio サーバー：❌ ブロック（一致する名前またはコマンドエントリがない）

例：コマンドのみの許可リスト

{
"allowedMcpServers": [
{ "serverCommand": ["npx", "-y", "approved-package"] }
]
}

結果：

["npx", "-y", "approved-package"] の Stdio サーバー：✅ 許可（コマンドと一致）
["node", "server.js"] の Stdio サーバー：❌ ブロック（コマンドと一致しない）
「my-api」という名前の HTTP サーバー：❌ ブロック（一致する名前エントリがない）

例：混合名とコマンド許可リスト

{
"allowedMcpServers": [
{ "serverName": "github" },
{ "serverCommand": ["npx", "-y", "approved-package"] }
]
}

結果：

「local-tool」という名前で ["npx", "-y", "approved-package"] の Stdio サーバー：✅ 許可（コマンドと一致）
「local-tool」という名前で ["node", "server.js"] の Stdio サーバー：❌ ブロック（コマンドエントリが存在しますが一致しない）
「github」という名前で ["node", "server.js"] の Stdio サーバー：❌ ブロック（stdio サーバーはコマンドエントリが存在する場合、コマンドと一致する必要があります）
「github」という名前の HTTP サーバー：✅ 許可（名前と一致）
「other-api」という名前の HTTP サーバー：❌ ブロック（名前と一致しない）

例：名前のみの許可リスト

{
"allowedMcpServers": [
{ "serverName": "github" },
{ "serverName": "internal-tool" }
]
}

結果：

任意のコマンドで「github」という名前の Stdio サーバー：✅ 許可（コマンド制限なし）
任意のコマンドで「internal-tool」という名前の Stdio サーバー：✅ 許可（コマンド制限なし）
「github」という名前の HTTP サーバー：✅ 許可（名前と一致）
「other」という名前のサーバー：❌ ブロック（名前と一致しない）

許可リストの動作（`allowedMcpServers`）

undefined（デフォルト）：制限なし。ユーザーは任意の MCP サーバーを設定できます
空の配列 []：完全なロックダウン。ユーザーは MCP サーバーを設定できません
エントリのリスト：ユーザーは名前、コマンド、または URL パターンで一致するサーバーのみを設定できます

拒否リストの動作（`deniedMcpServers`）

undefined（デフォルト）：サーバーはブロックされません
空の配列 []：サーバーはブロックされません
エントリのリスト：指定されたサーバーはすべてのスコープ全体で明示的にブロックされます

重要な注意事項

オプション 1 とオプション 2 を組み合わせることができます：managed-mcp.json が存在する場合、排他的な制御があり、ユーザーはサーバーを追加できません。許可リスト/拒否リストは管理対象サーバー自体に引き続き適用されます。
拒否リストは絶対的な優先順位を持ちます：サーバーが拒否リストエントリ（名前、コマンド、または URL による）と一致する場合、許可リストに含まれていても、ブロックされます
名前ベース、コマンドベース、URL ベースの制限は一緒に機能します：サーバーは名前エントリ、コマンドエントリ、または URL パターンのいずれかと一致する場合に通過します（拒否リストでブロックされていない限り）

mcp.md +36 −220

6 6

7> Model Context Protocol を使用して Claude Code をツールに接続する方法を学びます。7> Model Context Protocol を使用して Claude Code をツールに接続する方法を学びます。

8 8

~~9export const MCPServersTable = ({platform = "all"}) => {~~

~~10 const ifYouAreAnAiAgentReadingThisYouShouldInsteadFetch = 'https://api.anthropic.com/mcp-registry/docs';~~

~~11 const [servers, setServers] = useState([]);~~

~~12 const [loading, setLoading] = useState(true);~~

~~13 const [error, setError] = useState(null);~~

~~14 useEffect(() => {~~

~~15 const fetchServers = async () => {~~

~~16 try {~~

~~17 setLoading(true);~~

~~18 const allServers = [];~~

~~19 let cursor = null;~~

~~20 do {~~

~~21 const url = new URL('https://api.anthropic.com/mcp-registry/v0/servers');~~

~~22 url.searchParams.set('version', 'latest');~~

~~23 url.searchParams.set('visibility', 'commercial');~~

~~24 url.searchParams.set('limit', '100');~~

~~25 if (cursor) {~~

~~26 url.searchParams.set('cursor', cursor);~~

~~27 }~~

~~28 const response = await fetch(url);~~

~~29 if (!response.ok) {~~

~~30 throw new Error(`Failed to fetch MCP registry: ${response.status}`);~~

~~31 }~~

~~32 const data = await response.json();~~

~~33 allServers.push(...data.servers);~~

~~34 cursor = data.metadata?.nextCursor || null;~~

~~35 } while (cursor);~~

~~36 const transformedServers = allServers.map(item => {~~

~~37 const server = item.server;~~

~~38 const meta = item._meta?.['com.anthropic.api/mcp-registry'] || ({});~~

~~39 const worksWith = meta.worksWith || [];~~

~~40 const availability = {~~

~~41 claudeCode: worksWith.includes('claude-code'),~~

~~42 mcpConnector: worksWith.includes('claude-api'),~~

~~43 claudeDesktop: worksWith.includes('claude-desktop')~~

~~44 };~~

~~45 const remotes = server.remotes || [];~~

~~46 const httpRemote = remotes.find(r => r.type === 'streamable-http');~~

~~47 const sseRemote = remotes.find(r => r.type === 'sse');~~

~~48 const preferredRemote = httpRemote || sseRemote;~~

~~49 const remoteUrl = preferredRemote?.url || meta.url;~~

~~50 const remoteType = preferredRemote?.type;~~

~~51 const isTemplatedUrl = remoteUrl?.includes('{');~~

~~52 let setupUrl;~~

~~53 if (isTemplatedUrl && meta.requiredFields) {~~

~~54 const urlField = meta.requiredFields.find(f => f.field === 'url');~~

~~55 setupUrl = urlField?.sourceUrl || meta.documentation;~~

~~56 }~~

~~57 const urls = {};~~

~~58 if (!isTemplatedUrl) {~~

~~59 if (remoteType === 'streamable-http') {~~

~~60 urls.http = remoteUrl;~~

~~61 } else if (remoteType === 'sse') {~~

~~62 urls.sse = remoteUrl;~~

~~63 }~~

~~64 }~~

~~65 let envVars = [];~~

~~66 if (server.packages && server.packages.length > 0) {~~

~~67 const npmPackage = server.packages.find(p => p.registryType === 'npm');~~

~~68 if (npmPackage) {~~

~~69 urls.stdio = `npx -y ${npmPackage.identifier}`;~~

~~70 if (npmPackage.environmentVariables) {~~

~~71 envVars = npmPackage.environmentVariables;~~

~~72 }~~

~~73 }~~

~~74 }~~

~~75 return {~~

~~76 name: meta.displayName || server.title || server.name,~~

~~77 description: meta.oneLiner || server.description,~~

~~78 documentation: meta.documentation,~~

~~79 urls: urls,~~

~~80 envVars: envVars,~~

~~81 availability: availability,~~

~~82 customCommands: meta.claudeCodeCopyText ? {~~

~~83 claudeCode: meta.claudeCodeCopyText~~

~~84 } : undefined,~~

~~85 setupUrl: setupUrl~~

~~86 };~~

~~87 });~~

~~88 setServers(transformedServers);~~

~~89 setError(null);~~

~~90 } catch (err) {~~

~~91 setError(err.message);~~

~~92 console.error('Error fetching MCP registry:', err);~~

~~93 } finally {~~

~~94 setLoading(false);~~

~~95 }~~

~~96 };~~

~~97 fetchServers();~~

~~98 }, []);~~

~~99 const generateClaudeCodeCommand = server => {~~

100 if (server.customCommands && server.customCommands.claudeCode) {

101 return server.customCommands.claudeCode.replace('--transport streamable-http', '--transport http');

102 }

103 const serverSlug = server.name.toLowerCase().replace(/[^a-z0-9]/g, '-');

104 if (server.urls.http) {

105 return `claude mcp add ${serverSlug} --transport http ${server.urls.http}`;

106 }

107 if (server.urls.sse) {

108 return `claude mcp add ${serverSlug} --transport sse ${server.urls.sse}`;

109 }

110 if (server.urls.stdio) {

111 const envFlags = server.envVars && server.envVars.length > 0 ? server.envVars.map(v => `--env ${v.name}=YOUR_${v.name}`).join(' ') : '';

112 const baseCommand = `claude mcp add ${serverSlug} --transport stdio`;

113 return envFlags ? `${baseCommand} ${envFlags} -- ${server.urls.stdio}` : `${baseCommand} -- ${server.urls.stdio}`;

114 }

115 return null;

116 };

117 if (loading) {

118 return <div>Loading MCP servers...</div>;

119 }

120 if (error) {

121 return <div>Error loading MCP servers: {error}</div>;

122 }

123 const filteredServers = servers.filter(server => {

124 if (platform === "claudeCode") {

125 return server.availability.claudeCode;

126 } else if (platform === "mcpConnector") {

127 return server.availability.mcpConnector;

128 } else if (platform === "claudeDesktop") {

129 return server.availability.claudeDesktop;

130 } else if (platform === "all") {

131 return true;

132 } else {

133 throw new Error(`Unknown platform: ${platform}`);

134 }

135 });

136 return <>

137 <style jsx>{`

138 .cards-container {

139 display: grid;

140 gap: 1rem;

141 margin-bottom: 2rem;

142 }

143 .server-card {

144 border: 1px solid var(--border-color, #e5e7eb);

145 border-radius: 6px;

146 padding: 1rem;

147 }

148 .command-row {

149 display: flex;

150 align-items: center;

151 gap: 0.25rem;

152 }

153 .command-row code {

154 font-size: 0.75rem;

155 overflow-x: auto;

156 }

157 `}</style>

~~158~~

159 <div className="cards-container">

160 {filteredServers.map(server => {

161 const claudeCodeCommand = generateClaudeCodeCommand(server);

162 const mcpUrl = server.urls.http || server.urls.sse;

163 const commandToShow = platform === "claudeCode" ? claudeCodeCommand : mcpUrl;

164 return <div key={server.name} className="server-card">

165 <div>

166 {server.documentation ? <a href={server.documentation}>

167 <strong>{server.name}</strong>

168 </a> : <strong>{server.name}</strong>}

169 </div>

~~170~~

171 <p style={{

172 margin: '0.5rem 0',

173 fontSize: '0.9rem'

174 }}>

175 {server.description}

176 </p>

~~177~~

178 {server.setupUrl && <p style={{

179 margin: '0.25rem 0',

180 fontSize: '0.8rem',

181 fontStyle: 'italic',

182 opacity: 0.7

183 }}>

184 Requires user-specific URL.{' '}

185 <a href={server.setupUrl} style={{

186 textDecoration: 'underline'

187 }}>

188 Get your URL here

189 </a>.

190 </p>}

~~191~~

192 {commandToShow && !server.setupUrl && <>

193 <p style={{

194 display: 'block',

195 fontSize: '0.75rem',

196 fontWeight: 500,

197 minWidth: 'fit-content',

198 marginTop: '0.5rem',

199 marginBottom: 0

200 }}>

201 {platform === "claudeCode" ? "Command" : "URL"}

202 </p>

203 <div className="command-row">

204 <code>

205 {commandToShow}

206 </code>

207 </div>

208 </>}

209 </div>;

210 })}

211 </div>

212 </>;

213};

~~214~~

215Claude Code は、AI ツール統合のためのオープンソース標準である [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) を通じて、数百の外部ツールとデータソースに接続できます。MCP サーバーは Claude Code にツール、データベース、API へのアクセスを提供します。9Claude Code は、AI ツール統合のためのオープンソース標準である [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) を通じて、数百の外部ツールとデータソースに接続できます。MCP サーバーは Claude Code にツール、データベース、API へのアクセスを提供します。

216 10

217別のツール（課題追跡ツールや監視ダッシュボードなど）からチャットにデータをコピーしている場合は、サーバーを接続してください。接続すると、Claude は貼り付けたものから作業する代わりに、そのシステムを直接読み取り、操作できます。11別のツール（課題追跡ツールや監視ダッシュボードなど）からチャットにデータをコピーしている場合は、サーバーを接続してください。接続すると、Claude は貼り付けたものから作業する代わりに、そのシステムを直接読み取り、操作できます。

227* **ワークフローを自動化する**：「新機能に関するフィードバックセッションに招待する 10 人のユーザーに Gmail ドラフトを作成してください。」21* **ワークフローを自動化する**：「新機能に関するフィードバックセッションに招待する 10 人のユーザーに Gmail ドラフトを作成してください。」

228* **外部イベントに対応する**：MCP サーバーは [チャネル](/ja/channels) として機能することもでき、セッションにメッセージをプッシュするため、Claude は離席中に Telegram メッセージ、Discord チャット、または webhook イベントに対応できます。22* **外部イベントに対応する**：MCP サーバーは [チャネル](/ja/channels) として機能することもでき、セッションにメッセージをプッシュするため、Claude は離席中に Telegram メッセージ、Discord チャット、または webhook イベントに対応できます。

229 23

230## 人気のある MCP サーバー24## MCP サーバーを検索してビルドする

231 25

232Claude Code に接続できる一般的に使用される MCP サーバーをいくつか紹介します：26[Anthropic Directory](https://claude.ai/directory) でレビュー済みのコネクタを参照してください。Directory コネクタは Claude Code と同じ MCP インフラストラクチャを使用しているため、`claude mcp add` を使用して、そこにリストされているリモートサーバーを追加できます。

233 27

234<Warning>28<Warning>

235 サードパーティの MCP サーバーは自己責任で使用してください。Anthropic はこれらすべてのサーバーの正確性またはセキュリティを検証していません。29 接続する前に、各サーバーを信頼していることを確認してください。外部コンテンツを取得するサーバーは、[プロンプトインジェクションリスク](/ja/security#protect-against-prompt-injection)にさらされる可能性があります。

236 インストールする MCP サーバーを信頼していることを確認してください。

237 信頼できないコンテンツを取得する可能性のある MCP サーバーを使用する場合は特に注意してください。これらはプロンプトインジェクションのリスクにさらされる可能性があります。

238</Warning>30</Warning>

239 31

240<MCPServersTable platform="claudeCode" />32独自のサーバーをビルドするには、プロトコルの基礎については [MCP サーバーガイド](https://modelcontextprotocol.io/docs/develop/build-server) を、認証、テスト、Directory への提出については [Claude コネクタビルディングドキュメント](https://claude.com/docs/connectors/building) を参照してください。

241 33

242<Note>34公式の [`mcp-server-dev` プラグイン](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/mcp-server-dev) を使用して、Claude にサーバーをスキャフォルドしてもらうこともできます。

243 **特定の統合が必要ですか？** [GitHub で数百以上の MCP サーバーを検索](https://github.com/modelcontextprotocol/servers)するか、[MCP SDK](https://modelcontextprotocol.io/quickstart/server) を使用して独自のサーバーを構築してください。35

244</Note>36<Steps>

37 <Step title="プラグインをインストールする">

38 Claude Code セッションで、以下を実行します：

40 ```

41 /plugin install mcp-server-dev@claude-plugins-official

42 ```

44 次に `/reload-plugins` を実行して、現在のセッションでアクティブにします。

45 </Step>

47 <Step title="ビルドスキルを実行する">

48 ```

49 /mcp-server-dev:build-mcp-server

50 ```

52 Claude があなたのユースケースについて質問し、リモート HTTP またはローカル stdio サーバーをスキャフォルドします。

53 </Step>

54</Steps>

245 55

246## MCP サーバーのインストール56## MCP サーバーのインストール

247 57

287 97

288Stdio サーバーはマシン上でローカルプロセスとして実行されます。システムへの直接アクセスやカスタムスクリプトが必要なツールに最適です。98Stdio サーバーはマシン上でローカルプロセスとして実行されます。システムへの直接アクセスやカスタムスクリプトが必要なツールに最適です。

289 99

100Claude Code は、生成されたサーバーの環境に `CLAUDE_PROJECT_DIR` を設定して、プロジェクトルートを指定するため、サーバーは作業ディレクトリに依存することなくプロジェクト相対パスを解決できます。これは hooks が `CLAUDE_PROJECT_DIR` 変数で受け取るのと同じディレクトリです。サーバープロセス内から読み取ります。例えば、Node では `process.env.CLAUDE_PROJECT_DIR`、Python では `os.environ["CLAUDE_PROJECT_DIR"]` です。サーバーは MCP `roots/list` リクエストを呼び出すこともでき、Claude Code が起動されたディレクトリを返します。

101

102この変数はサーバーの環境に設定され、Claude Code 自体の環境には設定されないため、プロジェクトスコープまたはユーザースコープの `.mcp.json` `command` または `args` で `${VAR}` 展開を使用して参照するには、`${CLAUDE_PROJECT_DIR:-.}` などのデフォルトが必要です。プラグイン提供の MCP 設定は `${CLAUDE_PROJECT_DIR}` を直接置換し、デフォルトは必要ありません。

103

290```bash theme={null}104```bash theme={null}

291# 基本的な構文105# 基本的な構文

292claude mcp add [options] <name> -- <command> [args...]106claude mcp add [options] <name> -- <command> [args...]

404**プラグイン MCP 機能**：218**プラグイン MCP 機能**：

405 219

406* **自動ライフサイクル**：セッション起動時に、有効なプラグインのサーバーが自動的に接続されます。セッション中にプラグインを有効または無効にする場合は、`/reload-plugins` を実行して MCP サーバーを接続または切断してください220* **自動ライフサイクル**：セッション起動時に、有効なプラグインのサーバーが自動的に接続されます。セッション中にプラグインを有効または無効にする場合は、`/reload-plugins` を実行して MCP サーバーを接続または切断してください

407* **環境変数**：バンドルされたプラグインファイルに `${CLAUDE_PLUGIN_ROOT}` を使用し、プラグイン更新を通じて保持される [永続的な状態](/ja/plugins-reference#persistent-data-directory) に `${CLAUDE_PLUGIN_DATA}` を使用します221* **環境変数**：バンドルされたプラグインファイルに `${CLAUDE_PLUGIN_ROOT}` を使用し、プラグイン更新を通じて保持される [永続的な状態](/ja/plugins-reference#persistent-data-directory) に `${CLAUDE_PLUGIN_DATA}` を使用し、安定したプロジェクトルートに `${CLAUDE_PROJECT_DIR}` を使用します

408* **ユーザー環境アクセス**：手動で設定されたサーバーと同じ環境変数へのアクセス222* **ユーザー環境アクセス**：手動で設定されたサーバーと同じ環境変数へのアクセス

409* **複数のトランスポートタイプ**：stdio、SSE、HTTP トランスポートをサポート（トランスポートサポートはサーバーによって異なる場合があります）223* **複数のトランスポートタイプ**：stdio、SSE、HTTP トランスポートをサポート（トランスポートサポートはサーバーによって異なる場合があります）

410 224

644 458

645多くのクラウドベースの MCP サーバーは認証が必要です。Claude Code は安全な接続のために OAuth 2.0 をサポートしています。459多くのクラウドベースの MCP サーバーは認証が必要です。Claude Code は安全な接続のために OAuth 2.0 をサポートしています。

646 460

461Claude Code は、サーバーが `401 Unauthorized` と認可サーバーを指す `WWW-Authenticate` ヘッダーで応答するときに、リモートサーバーが認証を必要とするとマークします。その応答を返すカスタムサーバーは、他のリモートサーバーと同じ `/mcp` 認証フローを取得します。

462

647<Steps>463<Steps>

648 <Step title="認証が必要なサーバーを追加する">464 <Step title="認証が必要なサーバーを追加する">

649 例：465 例：

689 505

690### 事前設定された OAuth 認証情報を使用する506### 事前設定された OAuth 認証情報を使用する

691 507

692一部の MCP サーバーは自動 OAuth セットアップをサポートしていません。「Incompatible auth server: does not support dynamic client registration」のようなエラーが表示される場合、サーバーは事前設定された認証情報が必要です。Claude Code は Client ID Metadata Document（CIMD）を使用するサーバーもサポートしており、これらを自動的に検出します。自動検出に失敗した場合は、まずサーバーの開発者ポータルを通じて OAuth アプリを登録し、サーバーを追加するときに認証情報を提供してください。508一部の MCP サーバーは、Dynamic Client Registration を通じた自動 OAuth セットアップをサポートしていません。「Incompatible auth server: does not support dynamic client registration」のようなエラーが表示される場合、サーバーは事前設定された認証情報が必要です。Claude Code は Client ID Metadata Document（CIMD）を使用するサーバーもサポートしており、これらを自動的に検出します。自動検出に失敗した場合は、まずサーバーの開発者ポータルを通じて OAuth アプリを登録し、サーバーを追加するときに認証情報を提供してください。

693 509

694<Steps>510<Steps>

695 <Step title="サーバーで OAuth アプリを登録する">511 <Step title="サーバーで OAuth アプリを登録する">

1137 953

1138### ツール検索を設定する954### ツール検索を設定する

1139 955

1140ツール検索はデフォルトで有効です：MCP ツールは遅延され、オンデマンドで検出されます。Vertex AI ではデフォルトで無効です。これは `tool_reference` ブロックを受け入れないためです。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明示的に設定してオプトインしてください。この機能には、`tool_reference` ブロックをサポートするモデルが必要です：Sonnet 4 以降、または Opus 4 以降。Haiku モデルはツール検索をサポートしていません。956ツール検索はデフォルトで有効です：MCP ツールは遅延され、オンデマンドで検出されます。Vertex AI ではデフォルトで無効です。これは `tool_reference` ブロックを受け入れないためです。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH` を明示的に設定してフォールバックをオーバーライドしてください。この機能には、`tool_reference` ブロックをサポートするモデルが必要です：Sonnet 4 以降、または Opus 4 以降。Haiku モデルはツール検索をサポートしていません。

1141 957

1142`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します：958`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します：

1143 959

1144| 値 | 動作 |960| 値 | 動作 |

1145| :--------- | :------------------------------------------------------------------------------------------------------- |961| :--------- | :------------------------------------------------------------------------------------------------------------------- |

1146| （未設定） | すべての MCP ツールが遅延され、オンデマンドでロードされます。Vertex AI または `ANTHROPIC_BASE_URL` が非ファーストパーティホストの場合はアップフロントロードにフォールバック |962| （未設定） | すべての MCP ツールが遅延され、オンデマンドでロードされます。Vertex AI または `ANTHROPIC_BASE_URL` が非ファーストパーティホストの場合はアップフロントロードにフォールバック |

mcp.md 2026-05-11 23:00 UTC to 2026-05-12 22:57 UTC

MCP を使用して Claude Code をツールに接続する

MCP でできること

MCP サーバーを検索してビルドする

プラグインをインストールする

ビルドスキルを実行する

MCP サーバーのインストール

オプション 1：リモート HTTP サーバーを追加する

オプション 2：リモート SSE サーバーを追加する

オプション 3：ローカル stdio サーバーを追加する

サーバーの管理

動的ツール更新

自動再接続

チャネルでメッセージをプッシュする

プラグイン提供の MCP サーバー

MCP インストールスコープ

ローカルスコープ

プロジェクトスコープ

ユーザースコープ

スコープの階層と優先順位

.mcp.json での環境変数の展開

実践的な例

例：コードレビューのために GitHub に接続する

例：PostgreSQL データベースをクエリする

リモート MCP サーバーで認証する

認証が必要なサーバーを追加する

Claude Code 内で /mcp コマンドを使用する

固定 OAuth コールバックポートを使用する

事前設定された OAuth 認証情報を使用する

サーバーで OAuth アプリを登録する

認証情報を使用してサーバーを追加する

Claude Code で認証する

OAuth メタデータ検出をオーバーライドする

OAuth スコープを制限する

カスタム認証用の動的ヘッダーを使用する

JSON 設定から MCP サーバーを追加する

JSON から MCP サーバーを追加する

サーバーが追加されたことを確認する

Claude Desktop から MCP サーバーをインポートする

Claude Desktop からサーバーをインポートする

インポートするサーバーを選択する

サーバーがインポートされたことを確認する

Claude.ai から MCP サーバーを使用する

Claude.ai で MCP サーバーを設定する

MCP サーバーを認証する

Claude Code でサーバーを表示および管理する

Claude Code を MCP サーバーとして使用する

MCP 出力制限と警告

特定のツールの制限を引き上げる

MCP 応答要求に対応する

MCP リソースを使用する

MCP リソースを参照する

利用可能なリソースをリストする

特定のリソースを参照する

複数のリソース参照

MCP ツール検索でスケーリングする

仕組み

MCP サーバー作成者向け

ツール検索を設定する

サーバーを遅延から除外する

MCP プロンプトをコマンドとして使用する

MCP プロンプトを実行する

利用可能なプロンプトを検出する

引数なしでプロンプトを実行する

引数を使用してプロンプトを実行する

管理対象 MCP 設定

オプション 1：managed-mcp.json による排他的制御

オプション 2：許可リストと拒否リストによるポリシーベースの制御

制限オプション

設定例

コマンドベースの制限の仕組み

URL ベースの制限の仕組み

許可リストの動作（allowedMcpServers）

拒否リストの動作（deniedMcpServers）

重要な注意事項

`.mcp.json` での環境変数の展開

オプション 1：`managed-mcp.json` による排他的制御

許可リストの動作（`allowedMcpServers`）

拒否リストの動作（`deniedMcpServers`）