3行でいうと

  • 呼び出しの口は、REST API、Workersのバインディング、OpenAI互換のエンドポイントの3つが公式に書かれています。AI Gatewayを間に置くこともできます。
  • 公式のリモートMCPサーバーは、https://mcp.cloudflare.com/mcp（Cloudflare API）が「推奨」です。公式のGitHubのREADMEは、AI Gateway用、AutoRAG用、Workers Bindings用など10個のサーバーを「非推奨」としています。
  • 自分でMCPサーバーを作る公式のガイドは、新しい作り方として createMcpHandler() を勧め、McpAgent は「非推奨」と書いています。ただし、すぐ使えるテンプレートは今も McpAgent を使っている、と同じページに書かれています。
  • AI Gatewayを経由して、OpenAIやAnthropicなど別の提供元に送った内容は、その提供元が、その会社の規約で扱う可能性がある、とWorkers AIの公式ページは書いています。

この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。URLやコマンドは公式の表記を写していますが、動作確認はしていません。公式ページは要約として取得したため、読めていない箇所は「公式の資料では確認できていない」と書きます。

先に結論

前提：用語をそろえる

たとえ話：合鍵、受付の記録、よその店への取り次ぎ

自分のアプリからCloudflareのAIを呼ぶのは、ビルの調理機械を使う「入館証」を作ることです（APIトークン）。外のAIがCloudflareのアカウントを操作するのは、アシスタントに「合鍵」を預けることで、MCPの接続では、渡す鍵の範囲を選びます。AI Gatewayは、「受付」が、よその店（OpenAIなど）への注文を取り次いで記録することです。取り次いだ先の店の中で何が起きるかは、その店のルール次第です。これは僕らのたとえで、公式の表現ではありません。

向き1：自分のアプリからCloudflareのAIを呼ぶ（公式が運営）

Workers AIの3つの口

口 公式の説明 確かめた場所
REST API https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/run/{model} に、Authorization: Bearer {API_TOKEN} をつけて送る 「Get started: REST API」
Workersのバインディング 設定に "ai": {"binding": "AI"}、コードで env.AI.run(...) 「Get started: Workers and Wrangler」
OpenAI互換 ベースURL https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1。Chat Completions、Embeddings、Responses（GPT-OSSのみ、ストリーミングなし）の口がある 「OpenAI-compatible API endpoints」

APIトークンの作り方は、公式によると、ダッシュボードのWorkers AIのページで「Use REST API」を選び、「Create a Workers AI API Token」から作ります。自分で作る場合は、「Workers AI - Read」と「Workers AI - Edit」の両方の権限が要る、と書かれています。

公式のWorkers AIの設定の欄には、ほかに、Pi AI、Vercel AI SDK、Hugging Face Chat UIが、つなぎ方として並んでいます。これらの名前は確かめましたが、中身は読めていません。

AI Gatewayを間に置く

公式の「Get started」によると、ゲートウェイは、ダッシュボードの「AI > AI Gateway」で「Create Gateway」から作ります。つなぎ方は2つです。

提供元へのログインの方法は、3つです。Unified Billing（前払いのクレジット）、BYOK（自分のキーを預ける）、リクエストのヘッダーに自分のキーをつける、です。Unified Billingで使える提供元（HTTP API）は、OpenAI、Anthropic、Google AI Studio、Google Vertex AI、xAI、Groqと書かれています。

AI Searchのつなぎ口

公式のAI Searchのドキュメントの一覧には、Workers binding、REST API、Python SDK、CLI（Wrangler）の入口と、「Agents」の欄（Agents SDK、AI SDK、LangChain）が並んでいます。これらの中身は読めていません。

読めたのはMCPの口です。公式の「MCP」のページによると、インスタンスごとに https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/mcp のようなURLで、MCPの口が持てます。ツールは search の1つです。公開するには、ダッシュボードの「Settings > Public Endpoint」で「Enable Public Endpoint」を入れます。この既定のホスト名は、認証なしで答える、と書かれています。認証つきにしたいときは、自分のドメインを付けて、Cloudflare Accessを前に置き、サービストークンを使います。そのとき default_domain_enabled を false にしないと、既定のホスト名が開いたままになる、とも書かれています。

AI Searchの内部では、公式によると、文章生成やクエリの言い換えなどに、設定できるモデルが使われます。公式の更新履歴（2025年9月25日）には、AI Gatewayに他社のキーを登録し、それをAI Searchにつなぐと、OpenAIやAnthropicのモデルも選べる、と書かれています。

向き2：外のAIがCloudflareを操作する（公式のリモートMCPサーバー）

推奨されているもの

公式の「Cloudflare's own MCP servers」のページとGitHubのREADMEによると、次のサーバーがあります。接続先はすべて /mcp で終わるStreamable HTTPです。

サーバー 用途（公式の説明） URL
Cloudflare API（推奨） Cloudflare APIの全体と開発者向けドキュメントを、search()、execute()、docs() の3つのツールで扱う https://mcp.cloudflare.com/mcp
Documentation Cloudflareの参考情報 https://docs.mcp.cloudflare.com/mcp
Container サンドボックスの開発環境 https://containers.mcp.cloudflare.com/mcp
Browser Run ページの取得、Markdownへの変換、スクリーンショット https://browser.mcp.cloudflare.com/mcp
Digital Experience Monitoring 重要なアプリの状況 https://dex.mcp.cloudflare.com/mcp
Cloudflare One CASB SaaSの設定ミスの発見 https://casb.mcp.cloudflare.com/mcp
Agents SDK Documentation Agents SDKのドキュメントの検索 https://agents.cloudflare.com/mcp
Cloudflare Blog（READMEのみ） ブログの検索と閲覧 https://blog.mcp.cloudflare.com/mcp

公式のドキュメントのページは、「Cloudflare API」のサーバーを、Cloudflareで作業するのに必要な唯一のMCPサーバーと位置づけ、ほかは製品別の任意のもの、と書いています。READMEには、上の表のほかに Demo Day のサーバー（https://demo-day.mcp.cloudflare.com/mcp）も有効なものとして並んでいますが、用途は読めていません。また、READMEは、Cloudflare APIのサーバー自体は、このリポジトリではなく cloudflare/mcp で管理されている、と書いています。なお、ドキュメントの「Cloudflare's own MCP servers」のページには、2026年10月24日の再確認で、非推奨の表示は見つかりませんでした。非推奨の10個はREADMEの記述です。ほかの製品別のサーバーの接続の細部は、GitHubを見るよう書かれていて、僕らも読めていません。

非推奨のもの

公式のGitHubのREADMEは、次の10個を「非推奨」にして、Cloudflare APIのサーバーへ移るよう書いています。AI Gateway、Audit Logs、AutoRAG、DNS Analytics、GraphQL、Logpush、Observability、Radar、Workers Bindings、Workers Builds。AI GatewayやAutoRAGの名前がある点は、このガイドの範囲と重なるので、古い解説に注意してください。READMEは、リポジトリがアーカイブされているとは書いていません（読んだ範囲）。

つなぎ方（公式の説明）

クライアントの設定に、次の形で書きます（公式の例）。

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

つなぐと、CloudflareにOAuthの認可の画面が出て、許可する権限を選びます。自動化では、APIトークン（ユーザーかアカウントのもの）を、Authorization のヘッダーにBearerとして渡せます。READMEによると、OpenAIのResponses APIから使うときは、そのサーバーに必要な権限だけを持つAPIトークンを作ります。Cloudflare AI Playgroundも、サーバーのURLを受け付けます。公式のページは、サポートするMCPの仕様として「2026-07-28」を挙げています。

READMEには注意も書かれています。「Claude's response was interrupted」という表示が出ることがあり、多くは長いツールの連鎖で起き、質問を短くしたり分けたりすると良い、とあります。一部の機能は、有料のWorkersプランが要る、とも書かれています。

向き3：自分でMCPサーバーを作って公開する（公式のガイド）

公式の「Building and Deploying a Remote MCP Server on Cloudflare Workers」によると、新しい、状態を持たないサーバーには createMcpHandler() が勧められています。McpAgent は「非推奨」とされ、ページ内の「すぐ使えるテンプレートは、まだ非推奨の McpAgent の方法を使っている」と書かれています。新しく作るなら、mcp-worker の例から始めるよう書かれています。

認証なしのテンプレートの作り方は、npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless です。公開後の口は https://<worker-name>.<account>.workers.dev/mcp の形です。試す方法は、MCP Inspector、AI Playground（playground.ai.cloudflare.com）、Claude Codeの claude mcp add --transport http ... の例が書かれています。

認証の選択肢は、公式では2つです。Cloudflare Access（自分のIDプロバイダーでログイン）と、第三者のOAuth 2.0（GitHub、Google、Slack、Stytch、Auth0、WorkOSなど）。テンプレートには、認証なしのものと、GitHubのOAuthを使うものの両方があります。どちらにするか、公開するURLでどのツールを出すかは、作る人が決めることになります（これは僕らの見立てで、公式の文章ではありません）。

公式が運営するものと、第三者のもの

分類 例 運営
公式（Cloudflareが運営） Workers AI、AI Gateway、AI Search、Agents SDK、mcp.cloudflare.com などのMCPサーバー、cloudflare/mcp-server-cloudflare のリポジトリ Cloudflare
第三者（モデルの提供元） OpenAI、Anthropic、Google（AI Studio、Vertex AI）、xAI、Groq、AWS Bedrock、Azure OpenAI、Replicate 各社。AI Gatewayから送ると、その会社が扱う
第三者（MCPクライアント、ライブラリ） Claude、OpenAI Responses API、MCP Inspector、LangChain、Vercel AI SDK、Hugging Face Chat UI 各社・各コミュニティ。Cloudflareの資料に名前が出る範囲で記載
第三者（認証） GitHub、Google、Slack、Stytch、Auth0、WorkOS（OAuthの例） 各社
コミュニティの一覧サイトや解説 検索の結果に、MCPの一覧サイトなどが出た 公式ではないので、読んでいない・根拠にしていない

データはどこへ流れるか

気をつけること

出典