Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare provides a starter template to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is designed for developers building AI‑connected tools that need a publicly accessible, authenticated MCP endpoint.

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 the MCP Inspector (via npx @modelcontextprotocol/inspector) with SSE transport at http://localhost:8787/sse for local testing, or replace localhost with your deployed Worker URL for remote access. For Claude Desktop, add a configuration entry using mcp-remote pointing to that SSE endpoint.

Key features of Remote MCP Server on Cloudflare

• OAuth login integrated into the server flow.
• Local development with hot‑reloading via Nx.
• One‑command deployment to Cloudflare Workers.
• Supports SSE transport for remote MCP clients.
• Connects to MCP Inspector, Claude Desktop, and other clients.
• Includes a mock login screen for local testing.

Use cases of Remote MCP Server on Cloudflare

• Run a custom MCP server accessible from anywhere.
• Connect Claude Desktop to a remote, authenticated tool server.
• Prototype and debug MCP tools locally before deploying.
• Provide a secure API endpoint for AI assistants using OAuth.
• Experiment with remote MCP workflows without self‑hosting infrastructure.

FAQ from Remote MCP Server on Cloudflare

What transport does the server use?

The server uses SSE (Server‑Sent Events) at the /sse endpoint for client connections.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then execute npm run deploy.

How do I connect the MCP Inspector to the server?

Start the inspector with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, and enter the server URL ending with /sse. A mock login screen appears; input any email and password.

How do I connect Claude Desktop to a remote instance?

Edit Claude’s config file to add an entry like "command": "npx", "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]. A browser window opens for OAuth login; tools become visible in Claude after authentication.

How can I debug connection issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear stored credentials by running rm -rf ~/.mcp-auth.