Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide to set up a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is for developers who want to deploy and connect to MCP servers from remote clients.

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. Connect the MCP Inspector using SSE at http://localhost:8787/sse or configure Claude Desktop via npx mcp-remote with the same URL. Deploy to Cloudflare with npm run deploy after creating an OAuth KV namespace.

Key features of Remote MCP Server on Cloudflare

• Remote MCP server running on Cloudflare Workers
• OAuth login for authentication
• Supports SSE transport for MCP clients
• Connect via MCP Inspector for testing
• Integrates with Claude Desktop for tool usage
• Local development with hot-reload

Use cases of Remote MCP Server on Cloudflare

• Deploying a remote MCP server accessible over the internet
• Testing MCP tools locally with the inspector
• Connecting Claude Desktop to a remote MCP server for tool calling
• Using OAuth-protected MCP endpoints in production
• Developing and debugging MCP servers with Cloudflare KV for OAuth state

FAQ from Remote MCP Server on Cloudflare

What does Remote MCP Server on Cloudflare do?

It provides a template and instructions to run an MCP server on Cloudflare Workers with OAuth login, allowing remote clients to list and call tools.

What are the runtime dependencies?

You need Node.js and npm to install dependencies, and Nx is used to run the server locally. Cloudflare Workers is the deployment platform, and an OAuth KV namespace is required for OAuth state storage.

Where does OAuth data live?

OAuth data is stored in a Cloudflare KV namespace named OAUTH_KV, which you create during deployment.

What transport protocol does the server use?

The server uses Server-Sent Events (SSE) as its transport protocol. Clients connect using an SSE URL, e.g., http://localhost:8787/sse or a workers.dev URL.

How do I debug connection issues?

Restart Claude, or test the connection directly on the command line with npx mcp-remote <URL>. Clearing ~/.mcp-auth files can help in rare cases.