Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a blueprint for running a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to deploy a secure, serverless MCP endpoint that can be accessed by MCP clients like Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. To deploy, create a KV namespace for OAuth (npx wrangler kv namespace create OAUTH_KV), add its id to wrangler.jsonc, then run npm run deploy. Clients connect via SSE at the /sse endpoint, optionally using a local proxy like mcp-remote.

Key features of Remote MCP Server on Cloudflare

• Deployable to Cloudflare Workers as a serverless endpoint
• OAuth login for secure authenticated access
• Uses SSE transport for MCP communication
• Works with the official MCP Inspector for testing
• Connects to Claude Desktop via a local mcp-remote proxy
• Stores OAuth state in a Cloudflare KV namespace

Use cases of Remote MCP Server on Cloudflare

• Deploy a custom MCP server to production without managing infrastructure
• Test and debug MCP tools locally with the MCP Inspector
• Connect Claude Desktop to a remote MCP server via OAuth
• Build a serverless MCP endpoint that multiple users can authenticate to

FAQ from Remote MCP Server on Cloudflare

How do I develop locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/. Use the MCP Inspector with SSE at http://localhost:8787/sse to test.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

How do I connect Claude Desktop to my remote MCP server?

Add an entry to Claude Desktop’s config file using npx mcp-remote pointing to your worker’s /sse endpoint (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude; it will open a browser for OAuth login.

How can I debug connection issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. To clear cached OAuth state, remove the ~/.mcp-auth directory with rm -rf ~/.mcp-auth.