Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template for running a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It is intended for developers who want to deploy a remote MCP server accessible over HTTP and SSE, complete with authentication.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect the MCP Inspector by setting transport type to SSE and entering the local URL (e.g., http://localhost:8787/sse). Deploy to Cloudflare by creating a KV namespace for OAuth, updating wrangler.jsonc, and running npm run deploy. Connect Claude Desktop by editing its configuration to use the mcp-remote proxy pointing to your server’s SSE endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with serverless deployment.
• Includes OAuth login for secure access.
• Supports local development and testing.
• Connects via SSE transport.
• Works with MCP Inspector and Claude Desktop.
• Uses Cloudflare KV for OAuth token storage.

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server with authentication for public use.
• Develop and test MCP tools locally before deploying.
• Integrate MCP tools with Claude Desktop via a remote proxy.
• Build an API‑key‑less, OAuth‑protected MCP endpoint.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

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

How do I connect the MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, enter http://localhost:8787/sse (or your deployed URL + /sse), then click “Connect”. You will be prompted to log in (any email/password for local mock login).

How do I connect Claude Desktop to my remote server?

Edit Claude Desktop’s configuration file to include a server entry that uses npx mcp-remote with your server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude Desktop; a browser window will open for OAuth login.

How do I deploy the server to Cloudflare?

1. Create a KV namespace: npx wrangler kv namespace create OAUTH_KV.
2. Add the returned KV namespace ID to wrangler.jsonc.
3. Run npm run deploy. Your server will be available at a *.workers.dev URL.

What should I do if something goes wrong?

Try restarting Claude Desktop, or test the server directly with npx mcp-remote http://localhost:8787/sse (or your remote URL). In rare cases, clear the local auth files with rm -rf ~/.mcp-auth.