Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A setup guide for running a remote MCP server on Cloudflare Workers with OAuth login. Intended for developers building MCP-compatible tools.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies (npm install), and run locally with npx nx dev remote-mcp-server. Deploy with npm run deploy after configuring KV and wrangler.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth login
• Local development with hot reload
• Connection via MCP Inspector (SSE transport)
• Deploy to workers.dev or custom domain
• Integrates with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Building and testing MCP tools locally
• Deploying a public MCP server behind OAuth
• Connecting Claude Desktop to a remote MCP server
• Prototyping custom APIs with MCP compliance

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. Open http://localhost:8787/ in your browser.

How do I connect the MCP Inspector to my server?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter http://localhost:8787/sse (or your deployed URL), and log in with any email/password.

How do I deploy to Cloudflare?

First create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, then run npm run deploy.

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

Update Claude’s config file to use the mcp-remote command with your server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude.

How can I debug connection issues?

Try connecting directly via npx mcp-remote http://localhost:8787/sse. If problems persist, clear cached OAuth data with rm -rf ~/.mcp-auth.