Cloudflare Agent Setup：一行指令让 AI Agent 帮你配好整个开发环境

昨天逛 Cloudflare 文档，发现了个新页面：Agent Setup。乍一看以为是个普通的配置教程，仔细一读才发现——这玩意是在教 AI Agent 怎么配自己的开发环境，不是教人。

一行指令丢给 Claude Code、Codex、Cursor 任何一个，它就自动把 Cloudflare 的 Skills、5 个 MCP Server 全装好。你什么都不用干。

这思路太超前了。我花了半天时间把每个 Agent 都试了一遍，下面把踩到的坑和使用方法全分享出来。

本文提纲

1. 这页面到底干了什么
2. 一行指令快速安装（Quick Setup）
3. 6 大 Agent 手动配置详解
4. 5 个 MCP Server 分别能干什么
5. 实测体验和避坑指南

这页面到底干了什么

Cloudflare 做了一件很聪明的事：把配置指令写成一个 .md 文件（prompt.md），这个文件的格式就是 AI Agent 能直接理解和执行的。

核心逻辑就三步：

1. 安装 Cloudflare Skills（预定义的工作流模板）
2. 注册 5 个 MCP Server（API 网关、文档查询、绑定管理、构建服务、可观测性）
3. 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 分别能干什么

其中 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人工智能时代，转载请注明出处。