Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide for deploying a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It targets developers who want a remote, edge-hosted MCP server that can be accessed by 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 (opens at http://localhost:8787/). Deploy to Cloudflare using npm run deploy after creating an OAuth KV namespace. Connect clients by pointing them to the SSE endpoint (e.g., http://localhost:8787/sse or your workers.dev URL). Use npx @modelcontextprotocol/inspector to test, or configure Claude Desktop with npx mcp-remote pointing at the SSE URL.

Key features of Remote MCP Server on Cloudflare

• OAuth login integration for secure access
• Local development with live reload via Nx
• One‑command deployment to Cloudflare Workers
• SSE transport for MCP client connectivity
• Works with MCP Inspector and Claude Desktop
• Remote proxy support via mcp-remote

Use cases of Remote MCP Server on Cloudflare

• Running a remote math tool for Claude Desktop
• Prototyping MCP tools with the Inspector
• Hosting an authenticated MCP server on the edge
• Testing MCP capabilities without local installation
• Deploying a global MCP endpoint with Cloudflare’s network

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then execute npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How do I connect the MCP Inspector to my server?

Start the Inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter your server’s SSE URL (e.g., http://localhost:8787/sse). A mock login screen appears; input any email/password to authenticate.

How do I connect Claude Desktop to my remote server?

Edit your Claude Desktop config file and add an entry using npx mcp-remote pointing to the remote SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude; a browser login window should open.

How do I deploy the server to Cloudflare?

Create an OAuth KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy.

What should I do if I encounter connection issues?

Try restarting Claude, connect directly via npx mcp-remote http://localhost:8787/sse, or clear cached auth files with rm -rf ~/.mcp-auth.