Setup Your Agent
Install an agent of your choice, connect Cloudflare Skills and MCP servers, and start deploying to Cloudflare from your editor or terminal.
Prerequisites
Make sure you have these installed:
- Node.js 18+ (nodejs.org)
- Wrangler CLI:
npm install -g wrangler - Logged in:
wrangler login
If you need help, ask one of the workshop hosts.
Quick setup
Already have an agent? Paste this into any AI coding agent to install Cloudflare agent tooling in one step:
Fetch https://developers.cloudflare.com/agent-setup/prompt.md
This works with Claude Code, Cursor, Windsurf, GitHub Copilot, OpenCode, and Codex.
Pick your agent
If you don't have an agent yet, pick one below and follow the setup guide on the Cloudflare docs:
Terminal agents
| Agent | Description | Guide |
|---|---|---|
| Claude Code | Terminal-based coding agent by Anthropic. Full codebase understanding, command execution, git operations, multi-file editing. | Setup guide |
| Codex | Lightweight open-source terminal agent by OpenAI. File read/write, command execution, web browsing, sandboxed environment. | Setup guide |
| OpenCode | Open-source terminal agent with a rich TUI that works with 75+ LLMs. Made by Anomaly. | Setup guide |
IDE agents
| Agent | Description | Guide |
|---|---|---|
| Cursor | AI-first IDE built on VS Code with multi-file Composer edits and background agents. | Setup guide |
| Windsurf | Agentic IDE with Cascade context engine and Flows for multi-step tasks. | Setup guide |
| GitHub Copilot | Editor extension and CLI with agent mode, workspace context, and native PR integration. | Setup guide |
Manual MCP setup
If the quick setup doesn't work for your agent, add these MCP servers manually.
Cloudflare API (full platform access)
Gives your agent access to the entire Cloudflare API — over 2,500 endpoints — through search() and execute() tools.
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp"
}
}
}
You'll authorize via OAuth when you first connect.
Cloudflare Documentation
Up-to-date developer docs context for your agent:
{
"mcpServers": {
"cloudflare-docs": {
"url": "https://docs.mcp.cloudflare.com/mcp"
}
}
}
Agents SDK Docs
If you're building an AI agent:
{
"mcpServers": {
"agents-sdk": {
"url": "https://agents.cloudflare.com/mcp"
}
}
}
Other MCP servers
Pick the ones relevant to your build:
| Server | URL | Description |
|---|---|---|
| Workers Bindings | https://bindings.mcp.cloudflare.com/mcp | Build Workers with storage, AI, and compute primitives |
| Workers Builds | https://builds.mcp.cloudflare.com/mcp | Insights and management for Workers Builds |
| Observability | https://observability.mcp.cloudflare.com/mcp | Debug with application logs and analytics |
| Container Sandbox | https://containers.mcp.cloudflare.com/mcp | Spin up a sandbox development environment |
| Browser Rendering | https://browser.mcp.cloudflare.com/mcp | Fetch web pages, convert to markdown, take screenshots |
| AI Gateway | https://ai-gateway.mcp.cloudflare.com/mcp | Search logs, inspect prompts and responses |
For the full list, see Cloudflare's MCP servers in the official docs.
Verify it works
Ask your agent to create and deploy a Hello World Worker:
Create a new Cloudflare Worker that returns "Hello from Immerse!" and deploy it.
If that works, you're ready to build. Head to The Platform to see what's available, or jump straight to Project Ideas.