结论先说
- Cloudflare 官方现在主推单一统一端点
https://mcp.cloudflare.com/mcp,连上这一个地址即可覆盖全量 2,500 多个 API 端点(含 Workers、KV、D1、R2、DNS、Zero Trust)以及官方开发文档。 - 采用 Code Mode(代码模式)大幅省上下文:服务端只暴露
search()、execute()和docs()工具,初始仅占约 1,000 tokens,避免传统全量 Schema 吃掉百万级上下文。 - 本地客户端直接走 OAuth 网页授权并勾选权限范围;自动化流水线则可在请求头传入最小权限的 Cloudflare API Token。
- 除了单配 MCP,还可搭配官方
cloudflare/skills插件,把 MCP 连接与 Workers 最佳实践规则一起装进编程助手。 - 主力模型订阅与账号配套入口:跑通 MCP 工具链与多文件智能体编码依赖稳定的底层大模型配额,国内免境外卡自助开通可见本站 Claude Code 订阅页、ChatGPT Plus 充值页 与 AI 会员充值总览。

图:本站根据 Cloudflare 开发者文档:Cloudflare's own MCP servers 整理的示意图
本文根据 Cloudflare 开发者文档《Cloudflare's own MCP servers》及 Claude Code 文档整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Cloudflare 或 Anthropic 官方网站。
适用于谁
- 想在 Claude Code、Cursor 或 Codex 里直接查询 Cloudflare Workers 运行状态、操作 KV / D1 / R2 资源或检索官方文档的开发者;
- 以前装过四五个拆分的 Cloudflare 子服务 MCP 导致上下文爆满,想升级到官方统一端点的人;
- 需要弄清浏览器 OAuth 交互授权与 CI 自动化 API Token 权限控制的工程师。
一、为什么只需连 https://mcp.cloudflare.com/mcp 一个地址
早期社区里常见按产品拆分的多个远程地址(如单独的文档服、Bindings 服、日志观测服),同时开启十几个工具集很容易拖慢编辑器响应。
按 Cloudflare 官方文档现行架构,https://mcp.cloudflare.com/mcp 用 Code Mode(先搜索再沙箱执行) 解决了工具膨胀问题:
| 实现方式 | 暴露工具数量 | 初始上下文占用估算 |
|---|---|---|
| 传统全量挂载完整 Schema | 2,594 个 | 约 1,170,000 tokens |
| 传统仅挂载必填参数 | 2,594 个 | 约 244,000 tokens |
| 官方现行 Code Mode | 核心 search / execute + docs | 约 1,000 tokens |
模型接到你的指令后,先调 docs() 查最新语法或调 search() 在类型化 OpenAPI 规范里找对应接口,再生成针对性 JavaScript 代码放进隔离的 Dynamic Worker 沙箱通过 execute() 安全调用。关于本地与远程 Streamable HTTP 的协议背景见 MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别。
二、在主流客户端添加与账号授权
1. Claude Code 与 Cursor 手动添加
在 Claude Code 终端运行:
bash
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp
随后进入会话运行 /mcp 完成网页登录。若在 Cursor 等支持标准 JSON 的客户端中配置,直接写入 mcp.json:
json
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp"
}
}
}
首次连接时浏览器会跳转到 Cloudflare 授权页面,让你确认账号并勾选授予该 Agent 的具体权限范围。客户端详细配置位置见 Claude Code MCP 配置教程 与 Cursor MCP 配置教程。如果平时用 Claude Code 全栈开发边缘应用消耗额度较快,可在本站查看 Claude Code 订阅充值。
2. 一键安装 Cloudflare Skills 插件套装
如果你使用支持 Agent Skills 标准的客户端(Claude Code、Cursor、Codex 等),官方还提供了打包 MCP 与开发规则的 cloudflare/skills 插件。例如在 Claude Code 内可直接运行 /plugin marketplace add cloudflare/skills,有关技能与 MCP 的分工可参考 Skill 和 MCP 的区别是什么。
3. CI/CD 与无浏览器环境使用 API Token
在自动化环境无法完成网页 OAuth 时,前往 Cloudflare 控制台创建仅含所需权限的用户令牌(User token)或账户令牌(Account token),通过请求头传入:
json
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp",
"headers": {
"Authorization": "Bearer 你的_CLOUDFLARE_API_TOKEN"
}
}
}
}
编程订阅与高配额省心方案:在 Cursor、Claude Code 或 Codex 里挂载外部工具做长链路开发时,固定月费订阅通常比纯按量 API 更易控成本。本站支持支付宝、微信支付与 AlipayHK 免密自助兑换 Claude Pro、Claude Max 与 ChatGPT Pro,团队协作亦可定制 ChatGPT Business 团队版。
三、查 Workers 日志、KV / D1 数据库与文档检索实战
连接成功后,可以在同一个对话里组合完成三类高频任务:
- 查 Workers 报错与观测日志:直接提问「查询我账号下
api-gatewayWorker 最近 1 小时的错误日志与状态码分布,定位 500 报错原因」; - 读写 KV 命名空间与 D1 数据库:让助手「列出当前账号下的所有 D1 数据库并查看
users表结构,不要修改现有记录」,或核对某个 Worker 绑定的 KV 键值配置; - 实时检索官方最新文档:写配置前要求「先调
docs工具查 Cloudflare Workers 最新wrangler.jsonc里 D1 绑定的标准写法,再帮我改配置文件」,避免模型凭旧训练记忆编造过时字段。

图:本站根据 Cloudflare 开发者文档:Cloudflare's own MCP servers 整理的示意图
四、权限控制与常见问题排查
- 提示无权访问某个域名(Zone)或存储桶:OAuth 授权页或 API Token 配置里漏勾了对应产品的读权限,重新授权或收窄/补齐对应资源的 Read 权限即可。
- 防止误删 DNS 解析或线上绑定:
execute()具备调用写接口的能力,日常排障建议在授权时只给只读(Read)权限,且不在客户端对execute工具开启免确认自动执行。
常见问题
问:还需要单独配 docs.mcp.cloudflare.com 吗?
答:如果只需要免登录查文档、完全不想关联自己的 Cloudflare 账号,可以单独配文档端点;但只要连了 https://mcp.cloudflare.com/mcp,里面已经内置了 docs() 文档搜索工具,无需重复挂载两个服务器。
问:名下有多个 Cloudflare 账户(Account)怎么指定查哪一个?
答:在提示词里直接说明目标 Account 名称或 Account ID,或者使用仅限单一账户范围的 Account API Token,避免模型在多团队账号间查混资源。
问:怎么撤销已经授出去的 Cloudflare MCP 权限?
答:OAuth 登录可在客户端断开并在 Cloudflare 账户授权管理页移除对应应用;若是 Bearer Token 方式,直接去控制台 API Tokens 页面执行吊销(Roll / Revoke)即可立即失效。
问:配置好开发环境后,国内没有外币卡怎么开通 Claude 或 ChatGPT 编程订阅?
答:可在 本站充值中心 自助选购卡密开通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程无需交出账号密码,支持开具增值税发票;实时价格与售后边界(封号不在质保范围)以对应商品页为准。
相关教程
- Claude Code MCP 配置教程:claude mcp add、配置文件位置与常用 MCP
- Cursor MCP 配置教程:mcp.json 写法、项目与全局位置、OAuth 与连接失败排查
- Skill 和 MCP 的区别是什么:再加上子代理、Hook、CLAUDE.md,到底该选哪个
- MCP 的 stdio、SSE 和 Streamable HTTP 有什么区别
参考资料
- Cloudflare 开发者文档:Cloudflare's own MCP servers — https://developers.cloudflare.com/agents/model-context-protocol/cloudflare/servers-for-cloudflare/
- Claude Code 官方文档:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
0 条评论
还没有评论,来抢沙发~