Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template and guide for running a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It helps developers quickly deploy a remote MCP server that clients such as the MCP Inspector or Claude Desktop can use over HTTP.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For deployment, create a KV namespace, add its ID to wrangler.jsonc, and run npm run deploy. Connect clients like the MCP Inspector or Claude Desktop using the server’s SSE endpoint (e.g., localhost:8787/sse locally, or the Workers URL remotely).

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for scalable, remote access
• Includes OAuth‑based login flow for secure tool access
• Works with the MCP Inspector for local tool testing
• Connects to Claude Desktop via a local proxy (mcp-remote)
• Supports both local development and production deployment

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server for use by AI assistants like Claude
• Test and debug MCP tools locally with the MCP Inspector
• Connect Claude Desktop to a self‑hosted, remote MCP server with authentication
• Provide a reference implementation for Cloudflare‑based MCP servers

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then 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, set Transport Type to SSE, and enter http://localhost:8787/sse as the URL. Login with any email and password to see and call tools.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler@latest kv namespace create remote-mcp-server-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 the remote server?

In Claude Desktop’s MCP config file, add an entry using npx mcp-remote with the workers.dev URL (e.g., npx mcp-remote https://your-worker.workers.dev/sse). Restart Claude, and a browser will open for OAuth login.

What if something goes wrong?

Restart Claude, or test the server directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth.