Cloudflare Agent Setup：一行指令让 AI Agent 帮你配好整个开发环境
昨天逛 Cloudflare 文档，发现了个新页面：Agent Setup。乍一看以为是个普通的配置教程，仔细一读才发现——这玩意是在教 AI Agent 怎么配自己的开发环境，不是教人。
一行指令丢给 Claude Code、Codex、Cursor 任何一个，它就自动把 Cloudflare 的 Skills、5 个 MCP Server 全装好。你什么都不用干。
这思路太超前了。我花了半天时间把每个 Agent 都试了一遍，下面把踩到的坑和使用方法全分享出来。
本文提纲
- 这页面到底干了什么
- 一行指令快速安装（Quick Setup）
- 6 大 Agent 手动配置详解
- 5 个 MCP Server 分别能干什么
- 实测体验和避坑指南
这页面到底干了什么
Cloudflare 做了一件很聪明的事：把配置指令写成一个 .md 文件（prompt.md），这个文件的格式就是 AI Agent 能直接理解和执行的。
核心逻辑就三步：
- 安装 Cloudflare Skills（预定义的工作流模板）
- 注册 5 个 MCP Server（API 网关、文档查询、绑定管理、构建服务、可观测性）
- OAuth 认证在首次使用时自动触发
听起来简单，但它覆盖了 6 个主流 Agent，每个的配置方式都不一样。Cloudflare 把所有差异都抹平了。
一行指令快速安装（Quick Setup）
如果你已经有 Agent 在跑，最快的办法是这样：
把下面这行丢给你的 Agent：
Fetch https://developers.cloudflare.com/agent-setup/prompt.md
Agent 会自动读取这个文件，然后根据自己是什么类型的 Agent，执行对应的安装命令。整个过程你不用敲一个字。
我分别在 Claude Code 和 Codex 上测试过，确实是一个指令就搞定了。Claude Code 的体验最丝滑——两条 plugin 命令执行完，reload 一下就完事。
6 大 Agent 手动配置详解
如果你想了解细节，或者自动安装没成功，这里是每个 Agent 的具体配置方法。
Claude Code（推荐体验最好）
Claude Code 有专门的 plugin 命令，一行搞定 Skills + MCP：
claude plugin marketplace add cloudflare/skills
claude plugin install cloudflare@cloudflare
然后在 Claude Code 里执行 /reload-plugins，新的工具就加载好了。
注意：别用 npx skills 或 claude mcp add，plugin 命令已经把这两步都包了。
Codex（OpenAI 开源 Agent）
Codex 需要手动注册 5 个 MCP Server：
codex mcp add cloudflare --url https://mcp.cloudflare.com/mcp
codex mcp add cloudflare-docs --url https://docs.mcp.cloudflare.com/mcp
codex mcp add cloudflare-bindings --url https://bindings.mcp.cloudflare.com/mcp
codex mcp add cloudflare-builds --url https://builds.mcp.cloudflare.com/mcp
codex mcp add cloudflare-observability --url https://observability.mcp.cloudflare.com/mcp
codex mcp login cloudflare
最后那个 login 会触发 OAuth，浏览器弹个授权窗口就完了。
Cursor
在项目根目录创建 .cursor/mcp.json，加入：
{
"mcpServers": {
"cloudflare": { "url": "https://mcp.cloudflare.com/mcp" },
"cloudflare-docs": { "url": "https://docs.mcp.cloudflare.com/mcp" },
"cloudflare-bindings": { "url": "https://bindings.mcp.cloudflare.com/mcp" },
"cloudflare-builds": { "url": "https://builds.mcp.cloudflare.com/mcp" },
"cloudflare-observability": { "url": "https://observability.mcp.cloudflare.com/mcp" }
}
}
重启 Cursor 就生效。首次使用 Cloudflare 工具时自动弹 OAuth。
GitHub Copilot
跟 Cursor 类似，配置文件位置不同：.vscode/mcp.json。
OpenCode
OpenCode 的配置在 ~/.config/opencode/opencode.jsonc，格式稍有不同——用 "type": "remote" 和 "oauth": {}：
"cloudflare": { "type": "remote", "url": "https://mcp.cloudflare.com/mcp", "enabled": true, "oauth": {} },
"cloudflare-docs": { "type": "remote", "url": "https://docs.mcp.cloudflare.com/mcp", "enabled": true },
"cloudflare-bindings": { "type": "remote", "url": "https://bindings.mcp.cloudflare.com/mcp", "enabled": true, "oauth": {} },
"cloudflare-builds": { "type": "remote", "url": "https://builds.mcp.cloudflare.com/mcp", "enabled": true, "oauth": {} },
"cloudflare-observability": { "type": "remote", "url": "https://observability.mcp.cloudflare.com/mcp", "enabled": true, "oauth": {} }
然后跑一下 opencode mcp auth cloudflare 完成认证。
Windsurf
Windsurf 的配置在 ~/.codeium/windsurf/mcp_config.json，注意字段名是 serverUrl 不是 url：
"cloudflare": { "serverUrl": "https://mcp.cloudflare.com/mcp" },
"cloudflare-docs": { "serverUrl": "https://docs.mcp.cloudflare.com/mcp" },
"cloudflare-bindings": { "serverUrl": "https://bindings.mcp.cloudflare.com/mcp" },
"cloudflare-builds": { "serverUrl": "https://builds.mcp.cloudflare.com/mcp" },
"cloudflare-observability": { "serverUrl": "https://observability.mcp.cloudflare.com/mcp" }
5 个 MCP Server 分别能干什么
| MCP Server | 地址 | 功能 | 需要认证 |
|---|---|---|---|
| cloudflare | mcp.cloudflare.com/mcp |
主 API，部署 Workers、管理 KV/D1/R2 等 | ✅ OAuth |
| cloudflare-docs | docs.mcp.cloudflare.com/mcp |
文档查询，搜索 Cloudflare 全部产品文档 | ❌ 公开的 |
| cloudflare-bindings | bindings.mcp.cloudflare.com/mcp |
管理 Worker 的环境绑定（D1、KV、R2 等） | ✅ OAuth |
| cloudflare-builds | builds.mcp.cloudflare.com/mcp |
构建和部署服务 | ✅ OAuth |
| cloudflare-observability | observability.mcp.cloudflare.com/mcp |
日志、监控、告警等可观测性工具 | ✅ OAuth |
其中 cloudflare-docs 是唯一不需要认证的，直接就能用。其他 4 个首次调用时会自动弹 OAuth 窗口。
这 5 个 Server 合在一起基本覆盖了 Cloudflare 的完整开发工作流：从查文档、部署代码、管理资源绑定、到监控运维，一条龙。
实测体验和避坑指南
那个 prompt.md 到底靠不靠谱
靠谱。它的内容是 Cloudflare 官方维护的，地址是 developers.cloudflare.com/agent-setup/prompt.md，你可以随时重新访问验证。这个文件本质上是一套给 Agent 读的"安装脚本"，不是给人看的教程。
配置字段名注意
这是最容易踩的坑：不同 Agent 的配置字段名不一样。
- Cursor / Copilot 用
"url" - Windsurf 用
"serverUrl" - OpenCode 用
"url"+"type": "remote"+"enabled": true
搞混了的话，MCP Server 注册了但连不上，排查起来很烦。
OAuth 触发时机
除了 cloudflare-docs，其他 4 个 Server 都需要 OAuth 认证。认证不是在配置时触发的，而是在首次使用工具时自动弹出浏览器窗口。所以如果你配好了但没弹 OAuth，别急——等你真正调用 Cloudflare 的工具时它才会出现。
Skills 和 MCP 的区别
Cloudflare 这个体系里有两个东西：
- Skills：预定义的工作流模板，放在 GitHub（
cloudflare/skills），教 Agent 怎么完成特定任务（比如"部署一个 Worker"、"配置 D1 数据库"） - MCP Server：实时 API 网关，Agent 通过它们直接操作 Cloudflare 的资源
Skills 是"知识"，MCP 是"能力"。两个都装上，Agent 才能既知道该干什么，又能真正去干。
Claude Code 的 plugin 生态
Claude Code 的体验最好，因为它有 plugin 系统。一条 plugin marketplace add 就把 Skills 装了，一条 plugin install 就把 MCP 注册了，最后 /reload-plugins 刷新。其他 Agent 都需要手动编辑配置文件。
这页面让我意识到一个趋势：SDK 的分发方式正在从"给人看文档"转向"给 Agent 写指令"。Cloudflare 不是第一个这么做的，但做得最完整——6 个 Agent 全覆盖，配置方式各异但体验统一。
下次有人问你"Cloudflare 怎么配开发环境"，直接丢一行 Fetch 指令过去就行。让 Agent 自己搞定。
作者: itech001
来源: 公众号：AI人工智能时代
主页: https://www.theaiera.cn（每日分享最前沿的AI新闻和技术）
本文首发于 AI人工智能时代，转载请注明出处。