概要
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a ready-to-deploy MCP server that runs on Cloudflare Workers with built-in OAuth login. It is intended for developers who want to quickly set up a remote, authenticated MCP endpoint and connect it to clients like Claude Desktop or the MCP Inspector.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, then run locally with npx nx dev remote-mcp-server. Use the MCP Inspector to test by connecting over SSE at http://localhost:8787/sse. Deploy to Cloudflare with npm run deploy, and then connect Claude Desktop by updating its config to point to your workers.dev/sse URL via the mcp-remote proxy.
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers for global, serverless deployment
- Includes OAuth login for authenticated client access
- Uses SSE transport for MCP communication
- Ready-to-use local development and deployment workflow
- Works with MCP Inspector and Claude Desktop
Use cases of Remote MCP Server on Cloudflare
- Host a remote MCP server with secure, OAuth-based access
- Enable Claude Desktop to call custom tools over the internet
- Test and debug MCP tools locally with the MCP Inspector
- Deploy a math or custom tool server on Cloudflare’s edge network
FAQ from Remote MCP Server on Cloudflare
What runtime dependencies does Remote MCP Server on Cloudflare require?
You need Node.js and npm for local development, plus a Cloudflare account and Wrangler CLI for deployment. The client side uses npx to run both the MCP Inspector and the mcp-remote proxy.
Where does OAuth session data live?
OAuth storage uses a Cloudflare KV namespace called OAUTH_KV. You must create it and add its ID to wrangler.jsonc before deployment.
How do I connect a remote MCP client like Claude Desktop?
Update Claude Desktop’s config file to use npx mcp-remote with your Worker’s workers.dev/sse URL as an argument. Restart Claude and authenticate through the browser login screen.
Can I test the server before deploying?
Yes. Run locally with npx nx dev remote-mcp-server, then connect via the MCP Inspector over SSE at http://localhost:8787/sse.
How do I troubleshoot connectivity issues?
Restart Claude, or try connecting directly on the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear ~/.mcp-auth to reset authentication state.
