Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template that lets you run a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It is designed for developers who want a remote, secure MCP endpoint that can be connected to 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 connect clients, use npx @modelcontextprotocol/inspector for the MCP Inspector or configure Claude Desktop with "command": "npx", "args": ["mcp-remote", "http://localhost:8787/sse"] for local testing. Deploy to Cloudflare with npx wrangler kv namespace create OAUTH_KV then npm run deploy, and point clients to your workers.dev URL.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with Server-Sent Events (SSE) transport.
• Includes OAuth login for authentication.
• Supports local development and remote deployment.
• Connects seamlessly to MCP Inspector and Claude Desktop.
• Uses a local proxy (mcp-remote) for Claude Desktop connectivity.

Use cases of Remote MCP Server on Cloudflare

• Hosting a remote MCP server with built-in OAuth authentication.
• Testing MCP tools locally with the MCP Inspector.
• Integrating MCP tools into Claude Desktop via a remote proxy.
• Deploying a production-ready MCP endpoint on Cloudflare’s edge network.

FAQ from Remote MCP Server on Cloudflare

How do I deploy my own Remote MCP Server on Cloudflare?

Create an OAUTH_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 on Cloudflare?

Edit your Claude Desktop configuration file to include an entry with "command": "npx" and "args": ["mcp-remote", "https://your-worker.your-account.workers.dev/sse"]. Restart Claude and a browser window will open for login.

What transport does Remote MCP Server on Cloudflare use?

The server uses Server-Sent Events (SSE) as the transport protocol. Clients connect to the /sse endpoint.

Does Remote MCP Server on Cloudflare include authentication?

Yes, it includes OAuth login. When you connect via the MCP Inspector or Claude Desktop, you are redirected to a login screen (locally a mock screen) to authenticate.

How can I debug Remote MCP Server on Cloudflare?

Try restarting Claude, or test the server directly with npx mcp-remote http://localhost:8787/sse. If issues persist, clear the ~/.mcp-auth directory with rm -rf ~/.mcp-auth.