Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare helps you run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is designed for developers who want to expose MCP tools to remote clients such as Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For production deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Connect clients by pointing them to the server's SSE endpoint (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse after deployment).

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with serverless edge deployment
• Includes OAuth login for secure client access
• Uses SSE (Server-Sent Events) transport for MCP communication
• Works with MCP Inspector for local testing and debugging
• Connects to Claude Desktop via mcp-remote proxy
• Supports local development with mock login screen

Use cases of Remote MCP Server on Cloudflare

• Deploy a math tool MCP server remotely and call it from any SSE‑capable client
• Test MCP tool integrations locally with the MCP Inspector before deploying
• Connect Claude Desktop to a remote MCP server for tool‑augmented conversations
• Debug server behavior using command‑line client (npx mcp-remote)

FAQ from Remote MCP Server on Cloudflare

How do I connect Claude Desktop to my server?

Configure Claude Desktop with an mcp-remote entry pointing to your server’s SSE URL. For example, use "command": "npx", "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"] in the Claude config file.

What transport does the server use?

The server uses SSE (Server‑Sent Events) transport, accessed via the /sse endpoint. Local development uses http://localhost:8787/sse; deployed versions use a workers.dev URL.

How do I deploy to Cloudflare Workers?

Create a KV namespace (npx wrangler kv namespace create OAUTH_KV), paste the namespace ID into wrangler.jsonc, then run npm run deploy.

How can I test the server locally?

Run npx nx dev remote-mcp-server from the repository, then use the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE endpoint http://localhost:8787/sse and a mock login.

How do I debug connection issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse on the command line. In rare cases, clear stored auth state with rm -rf ~/.mcp-auth.