How to add Cloudflare Documentation MCP (Remote) to Windsurf

Cloudflare's hosted remote MCP server for searching Cloudflare developer docs; no auth required. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 3.1k★ · http · no auth · official

Windsurf config for Cloudflare Documentation MCP (Remote)

Add remote URL https://docs.mcp.cloudflare.com/mcp to your MCP client

{
  "mcpServers": {
    "cloudflare-documentation-mcp-remote": {
      "serverUrl": "https://docs.mcp.cloudflare.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Cloudflare Documentation MCP (Remote) config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Cloudflare Documentation MCP (Remote)'s tools become available to Cascade.

Before you start

An MCP client that supports remote/HTTP MCP servers (e.g. Claude Desktop, Cursor, VS Code), OR Node.js 18+ to run the `mcp-remote` proxy for clients without native remote support
No Cloudflare account, API token, or authentication of any kind — the docs server reads only public documentation

What Cloudflare Documentation MCP (Remote) can do in Windsurf

search_cloudflare_documentation

Search the Cloudflare developer docs and return synthesized, citation-backed answers across Workers, Pages, R2, Zero Trust, DNS and more.

migrate_pages_to_workers_guide

Returns the step-by-step guide for migrating a Cloudflare Pages project to Workers, including requirements and common pitfalls.

Security

The documentation server is read-only and unauthenticated, so risk is minimal; Cloudflare's storage/compute remotes (e.g. Workers Bindings) require a scoped API token and can modify R2/KV/D1 resources. Use a least-privilege token for those.

Cloudflare Documentation MCP (Remote) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Cloudflare Documentation MCP (Remote) config there under the "mcpServers" key and restart the client.

Is Cloudflare Documentation MCP (Remote) safe to use with Windsurf?

Does the Cloudflare Documentation MCP server require authentication?

No. It serves only public documentation, so there is no API token, OAuth, or login step — just point your client at the URL.

How is this different from Cloudflare's other MCP servers?

The other servers in the same repo (Workers Bindings, Observability, Logpush, AI Gateway, etc.) act on your account and require a Cloudflare API token with the right scopes. The Documentation server only reads published docs and needs no auth.

My client doesn't support remote MCP servers — can I still use it?

Yes. Run it through the mcp-remote proxy: configure a stdio command server with `npx mcp-remote https://docs.mcp.cloudflare.com/mcp`, which requires Node.js 18+.

View repo Full Cloudflare Documentation MCP (Remote) page