Cloudflare MCP Server (Official)注目

Cloudflare MCP Server (Official) とは？

Cloudflare MCP Server (Official) は、Cloudflare が公式にホストする cloudflare mcp エンドポイント（https://mcp.cloudflare.com/mcp）です。少数の Code Mode ツールを通じて、AI エージェントが Cloudflare API 全体（約 2,500 エンドポイント）と開発者ドキュメントにアクセスできます。

API エンドポイントごとにツールを登録する代わりに、Cloudflare の OpenAPI 仕様をサーバー側に保持し、エージェントが短い JavaScript を書いて仕様を検索し API を呼び出します。cloudflare/mcp の README によると、これによりツール定義は数十万トークンではなく約 1,100 トークンに収まります。プロジェクトは Apache-2.0 ライセンスのオープンソースで、Cloudflare のドキュメントでは、ほとんどのユーザーにとって必要な Cloudflare MCP サーバーはこれだけだと説明されています。

Cloudflare MCP Server (Official) の使い方

前提条件：Cloudflare アカウントと、リモート（Streamable HTTP）サーバーに対応した MCP クライアント。ローカルへのインストールは不要です。

認証方法は 2 つあります。

• OAuth（推奨）： URL に接続すると Cloudflare にリダイレクトされ、認可とエージェントに付与する権限の選択を行います。
• API トークン： CI/CD や自動化向けです。必要な権限を持つ Cloudflare API トークン を作成し、Authorization ヘッダーで bearer トークンとして送信します。ユーザートークンとアカウントトークンの両方に対応しています。アカウントトークンでは、サーバーがアカウント ID を自動検出できるよう Account Resources : Read 権限を含めてください。Client IP Address Filtering を有効にしたトークンは現在サポートされていません。

Cloudflare のドキュメントにある汎用設定：

{
  "mcpServers": {
    "cloudflare-api": {
      "url": "https://mcp.cloudflare.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http cloudflare https://mcp.cloudflare.com/mcp

その後、セッション内で /mcp を実行して OAuth サインインを完了します。Cloudflare は MCP サーバーとスキルをまとめた Claude Code プラグインも公開しています：/plugin marketplace add cloudflare/skills。

Cursor

上記の JSON 設定を Cursor の MCP 設定（mcp.json）に追加します。Cloudflare Skills プラグインは Cursor Marketplace からも入手できます。

VS Code

コマンドパレットを開き、"MCP: Add Server" を実行して HTTP を選び、https://mcp.cloudflare.com/mcp を入力します。

Claude Desktop

https://mcp.cloudflare.com/mcp をカスタムコネクタとして追加するか、リモート MCP の URL を受け付ける任意のクライアントを使います。Cloudflare AI Playground でもサーバー URL を入力できます。

オプションの URL パラメータ

• ?codemode=false：Code Mode ツールの代わりに、API エンドポイントごとに 1 つのツール（例：get_workers_scripts）を登録します。コストが約 244k トークンに増えるため、クライアント自体が code mode を使う場合にのみ利用してください。
• ?truncateToolResult=false：各ツール結果のデフォルト上限（約 6,000 トークン）を無効にします。クライアント側でモデルに渡す量を制限している場合にのみ使ってください。

Cloudflare MCP Server (Official) の主な機能

• Cloudflare 公式・Cloudflare がホスト、ソースは cloudflare/mcp（Apache-2.0）
• Cloudflare API 全体をカバー：Workers、KV、R2、D1、Pages、DNS、Firewall、Load Balancers、Stream、Images、AI Gateway、Vectorize、Access、Gateway など
• Code Mode 設計：生成されたコードは Dynamic Worker Loader API により隔離された Worker で実行され、結果だけがエージェントに返る
• 接続ごとに権限を選べる OAuth と、自動化向けの bearer API トークン
• 同じ execute ツールで Cloudflare の GraphQL Analytics API に対応
• MCP Skills 拡張を通じて Cloudflare のスキル（Wrangler、Durable Objects、Agents SDK、Workers ベストプラクティス）を提供
• Streamable HTTP は /mcp。旧 /sse URL は同じハンドラーのエイリアス

Cloudflare MCP Server (Official) のツール

サーバーが公開するツールは少数で固定です。

• API アクセス： search は spec.paths に対して JavaScript を実行して適切なエンドポイントを探し、execute は見つけたエンドポイントで cloudflare.request() を呼び出す JavaScript を実行します。ユーザートークンでは account_id を渡し、アカウントトークンでは自動検出されます。
• ドキュメント： docs は Cloudflare の開発者ドキュメントを検索します。
• ID： whoami は接続が認証されているユーザーまたはアカウントを返し、クライアントが複数の接続アカウントを区別するのに役立ちます。

?codemode=false の場合も docs と whoami は残り、各 API エンドポイントがそれぞれ独立したツールになります。

Cloudflare MCP Server (Official) のユースケース

• リソースの棚卸し：「すべての Workers と、それぞれの最終デプロイ日時を一覧にして」
• ストレージ管理：「'my-cache' という名前の KV namespace を作成して」
• DNS 編集：「api.example.com に 192.0.2.1 を指す A レコードを追加して」
• 分析データの取得：GraphQL Analytics API で zone のトラフィック（直近 7 日間のリクエスト数やキャッシュバイト数など）を照会する。
• Worker を開発しながら、エディターを離れずに最新ドキュメントに基づいてプラットフォームの疑問に答える。
• スコープを絞った API トークンで、CI パイプラインから Cloudflare の変更を実行する。

Cloudflare MCP Server (Official) と代替ツールの比較

Cloudflare は 2 種類の MCP サーバーを運用しています。幅広くカバーしたい場合は、この API サーバーが推奨です。ドメイン特化型の Cloudflare MCP サーバー（リポジトリ cloudflare/mcp-server-cloudflare）は、Documentation（docs.mcp.cloudflare.com/mcp）、Browser Run（browser.mcp.cloudflare.com/mcp）、Containers（containers.mcp.cloudflare.com/mcp）など、1 つの製品領域ごとに型付きの厳選ツールを提供します。Observability、Workers Bindings、Radar など古いサーバーの一部は非推奨となり、mcp.cloudflare.com への移行が求められています。

Workers 上で独自の MCP サーバーを構築・ホストしたい場合は、Cloudflare のガイド Build a remote MCP server を参照してください。この Cloudflare Workers MCP テンプレート のようなコミュニティのテンプレートも同じ目的に使えます。

Cloudflare MCP Server (Official) のトラブルシューティング

• アカウントトークンでアカウントが見つからない： Account Resources : Read 権限を追加するか、account_id を明示的に渡します。
• API トークンが拒否される： Client IP Address Filtering を有効にしたトークンは未対応です。フィルターなしのトークンを作成してください。
• SSE を強制するクライアントで失敗する： /sse パスは旧来の HTTP+SSE トランスポートではありません。クライアントを Streamable HTTP または自動トランスポート検出に切り替えてください。
• 結果が --- TRUNCATED --- で終わる： 各結果は約 6,000 トークンが上限です。クエリを絞るか、クライアントが出力を制限するなら ?truncateToolResult=false を使います。
• "Claude's response was interrupted"： Cloudflare の MCP リポジトリによると、多数の連続したツール呼び出しでコンテキスト上限に達したことが主な原因です。リクエストを具体的にし、大きなタスクは分割してください。