Sets up your AI agent for Cloudflare

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 │
│ ✓ MCPs │
│ │
│ ⚡ 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.