Skip to main content

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

AgentDescriptionGuide
Claude CodeTerminal-based coding agent by Anthropic. Full codebase understanding, command execution, git operations, multi-file editing.Setup guide
CodexLightweight open-source terminal agent by OpenAI. File read/write, command execution, web browsing, sandboxed environment.Setup guide
OpenCodeOpen-source terminal agent with a rich TUI that works with 75+ LLMs. Made by Anomaly.Setup guide

IDE agents

AgentDescriptionGuide
CursorAI-first IDE built on VS Code with multi-file Composer edits and background agents.Setup guide
WindsurfAgentic IDE with Cascade context engine and Flows for multi-step tasks.Setup guide
GitHub CopilotEditor 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:

ServerURLDescription
Workers Bindingshttps://bindings.mcp.cloudflare.com/mcpBuild Workers with storage, AI, and compute primitives
Workers Buildshttps://builds.mcp.cloudflare.com/mcpInsights and management for Workers Builds
Observabilityhttps://observability.mcp.cloudflare.com/mcpDebug with application logs and analytics
Container Sandboxhttps://containers.mcp.cloudflare.com/mcpSpin up a sandbox development environment
Browser Renderinghttps://browser.mcp.cloudflare.com/mcpFetch web pages, convert to markdown, take screenshots
AI Gatewayhttps://ai-gateway.mcp.cloudflare.com/mcpSearch 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.