概要
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a template to get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login. It integrates with the Model Context Protocol (MCP) and is intended for developers who want to host MCP tools on the Cloudflare edge network.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect via the MCP Inspector by selecting SSE transport and entering http://localhost:8787/sse. For deployment, create a KV namespace (npx wrangler kv namespace create OAUTH_KV), add its ID to wrangler.jsonc, then run npm run deploy. Use the resulting workers.dev/sse URL to connect remote clients.
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers edge network
- Built‑in OAuth login for authentication
- Uses SSE (Server‑Sent Events) as the transport
- Local development with MCP Inspector
- Direct integration with Claude Desktop via
mcp-remoteproxy - One‑command deployment with Wrangler CLI
Use cases of Remote MCP Server on Cloudflare
- Host a secure, remote MCP server with OAuth authentication
- Connect AI assistants like Claude to custom tools over HTTP
- Develop and test MCP tools locally before deploying to production
- Provide a math tool (e.g., addition) accessible from any remote MCP client
- Share MCP tools across teams or applications via a public endpoint
FAQ from Remote MCP Server on Cloudflare
How do I set up OAuth?
The OAuth login is built into the server. When you deploy, you create a Cloudflare KV namespace (OAUTH_KV) that stores session data. During local development, a mock login screen is shown; in production, you can customize the OAuth flow.
What transport does Remote MCP Server on Cloudflare use?
The server uses SSE (Server‑Sent Events) as the transport protocol. Clients connect to the /sse endpoint.
How do I connect Claude Desktop to my remote MCP server?
Add an entry to the Claude Desktop configuration that uses mcp-remote as the command, pointing to your deployed workers.dev/sse URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude to see the available tools.
How can I debug if something goes wrong?
Restart Claude, or try connecting directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth.
Where are OAuth session data stored?
The OAuth session data is stored in a Cloudflare KV namespace called OAUTH_KV. You must create this namespace before deployment and reference its ID in wrangler.jsonc.
