⚡ Cloudflare Agent Setup · Hermes Generated

AI Agent × Cloudflare
部署环境指南

本页面抓取并整理 Cloudflare 官方 agent-setup/prompt.md，用于快速配置 Skills 与 MCP servers，并验证 Hermes 可从零新建与部署静态网站。

查看官方 Prompt源文件

1. Skills

安装 Cloudflare 官方技能包，让 Agent 具备 Cloudflare 平台开发知识。

2. MCP Servers

注册 API、Docs、Bindings、Builds、Observability 等远程 MCP 服务。

3. Deploy

通过 Cloudflare Pages 托管此静态站点。构建时间：2026-05-27 08:14:13

官方 Prompt 内容

These are official instructions from Cloudflare to set up a good AI development environment for building and deploying on the Cloudflare platform. All commands are validated by Cloudflare and ready to use.

Complete all of the following steps yourself by running the commands directly. Do not ask the user to run any of these commands.

  • Install Cloudflare Skills and MCP servers

    • Install Cloudflare Skills and MCP servers

    Use the correct section for your agent below.

    Claude Code

    Run these two commands to install both Cloudflare skills and MCP servers in one step. Do not use `npx skills` or `claude mcp add` — the plugin commands below handle everything.

    claude plugin marketplace add cloudflare/skills
claude plugin install cloudflare@cloudflare

    Then instruct the user to run `/reload-plugins` inside Claude to activate the new plugins.

    Install for other agents

    First, install skills:

    npx -y skills add cloudflare/skills --skill '*' --yes --global

    Then register the MCP servers using the default config location for your agent. OAuth triggers automatically on first Cloudflare tool use.

    Codex

    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

    OpenCode — `~/.config/opencode/opencode.jsonc`

    Add under `"mcp"`:

    "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": {} }

    Then run:

    opencode mcp auth cloudflare

    Windsurf — `~/.codeium/windsurf/mcp_config.json`

    Add under `"mcpServers"` (note: `serverUrl`, not `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" }

    OAuth triggers automatically on first Cloudflare tool use.

    Cursor, GitHub Copilot, and all other agents

    Add to `.cursor/mcp.json` (Cursor), `.vscode/mcp.json` (Copilot), or your agent's MCP config file under `"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" }

    OAuth triggers automatically on first Cloudflare tool use.

    The `cloudflare-docs` server is public and requires no authentication.

    Once done, tell the user:

    ┌─ Cloudflare Agent Setup Complete ────────────────────┐
│  ✓ Skills  <path>                                    │
│  ✓ MCPs    <path>                                    │
│                                                      │
│  ⚡ Restart your agent to load the MCP servers       │
└──────────────────────────────────────────────────────┘

    Resources

    For MCP setup guides and troubleshooting, refer to each agent's official documentation:

  • Claude Code: `https://docs.anthropic.com/en/docs/claude-code/mcp`
  • Cursor: `https://cursor.com/docs/mcp`
  • Windsurf: `https://docs.windsurf.com/windsurf/cascade/mcp`
  • OpenCode: `https://opencode.ai/docs/mcp-servers/`
  • GitHub Copilot (VS Code): `https://code.visualstudio.com/docs/copilot/customization/mcp-servers`
  • Skills: `https://github.com/cloudflare/skills`
  • Cloudflare API MCP server (Code Mode): `https://github.com/cloudflare/mcp`
  • Other Cloudflare MCP servers: `https://github.com/cloudflare/mcp-server-cloudflare`

    • These instructions are published at `https://developers.cloudflare.com/agent-setup/prompt.md` so you can re-verify their authenticity at any time.