Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a remote Model Context Protocol (MCP) server that runs on Cloudflare Workers with OAuth login. It provides an SSE endpoint for MCP clients like the MCP Inspector or Claude Desktop to discover and call tools.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect clients via the SSE URL (e.g., http://localhost:8787/sse locally or the workers.dev URL after deployment) and authenticate through the OAuth login flow.

Key features of Remote MCP Server on Cloudflare

• Deploys as a Cloudflare Worker with OAuth authentication
• Uses SSE transport for MCP communication
• Supports local development with hot reload
• Works with MCP Inspector for testing tools
• Integrates with Claude Desktop via mcp-remote proxy
• Enables remote access to MCP tools from any HTTP client

Use cases of Remote MCP Server on Cloudflare

• Expose MCP tools over the internet with OAuth security
• Develop and test MCP tools locally before deployment
• Connect Claude Desktop to a remote MCP server
• Use the MCP Inspector to browse, list, and call tools remotely

FAQ from Remote MCP Server on Cloudflare

How do I develop the server locally?

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

How can I test my server with the MCP Inspector?

Start the MCP Inspector with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, and enter http://localhost:8787/sse (or your remote URL) as the server URL. Log in with any email and password on the mock login screen.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy. The server will be available at a workers.dev URL.

How do I connect Claude Desktop to my remote server?

Update Claude's configuration file (Settings > Developer > Edit Config) with an mcpServers entry using the mcp-remote command pointing to your SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude and log in through the browser that opens.

What should I do if something goes wrong?

Restart Claude, or try connecting directly from the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear cached auth files by running rm -rf ~/.mcp-auth.