如何将 Cloudflare AI Gateway 远程 MCP 连接到 Claude Code

约 1 分钟即可把 Cloudflare 的远程 MCP 服务端接入 Claude Code。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~265 tok4 tools
Streamable HTTPhttps://ai-gateway.mcp.cloudflare.com/mcp
claude mcp add --transport http cloudflare-ai-gateway https://ai-gateway.mcp.cloudflare.com/mcp

接入步骤

  1. 执行添加命令 — 运行 claude mcp add --transport http cloudflare-ai-gateway https://ai-gateway.mcp.cloudflare.com/mcp``。
  2. 完成认证 — 首次调用时客户端会打开 Cloudflare 的 OAuth 授权页面——点击允许后工具即可用。在 Claude Code 内运行 /mcp 可触发 OAuth 流程。
  3. 验证状态 — 运行 claude mcp list 应显示已连接。若 OAuth 回调失败,先 claude mcp remove cloudflare-ai-gateway 再重新添加,并确认浏览器能访问回调地址。在 在线 Inspector 中粘贴 https://ai-gateway.mcp.cloudflare.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(4)

ToolSafetyDescriptionParameters
list_gateways
~34 tok
🟢 ReadList AI gateways in your account.—
get_gateway_logs
~84 tok
🟢 ReadQuery request logs for a gateway with filters.gatewayId*: stringtimeRange: stringstatus: string
get_gateway_analytics
~73 tok
🟢 ReadGet usage metrics (requests, tokens, cost) for a gateway.gatewayId*: stringtimeRange: string
get_request_details
~54 tok
🟢 ReadGet full details of a single logged request.logId*: string

更多连接指南