Remote Cloudflare

You can run a remote MCP server on Cloudflare Workers that doesn't require authentication, allowing you to expose a set of tools that you can access from compatible MCP clients. This setup is useful for quickly prototyping remote tools and testing how a client interacts with a server without handling auth in the first pass.

How to use

Connect to your remote MCP server from supported clients to run tools directly. You can use the Cloudflare Playground to try your MCP server in a browser-based environment. Enter your deployed MCP server URL to load the available tools, then execute them within the playground. You can also connect from local MCP clients via a proxy that forwards requests to your remote server. If you want to run a specific tool locally, provide the remote server URL to the client configuration so that tool invocations are proxied to the remote instance.

How to install

Prerequisites you need before deployment: Node.js and npm installed on your machine, and a Cloudflare account with Workers access.

Step 1: Install the scaffolding command globally if you don’t have it yet.

Step 2: Create the remote MCP server project using the Cloudflare template.

Step 3: Deploy to Cloudflare Workers and obtain the public URL for your MCP server.

Additional sections

Customize your MCP server by adding tools in the init() method of the source file using this.server.tool(...). Define each tool you want to expose to MCP clients, and ensure your deployment rebuilds after changes.

Connect to the Cloudflare AI Playground to test the server quickly. Use the Playground to point to your server URL and experiment with available tools in a remote MCP client environment.

Connect Claude Desktop or other local MCP clients by configuring an MCP connection that points to your remote server's SSE endpoint. The example shows a configuration where the client connects to the remote server over HTTP and routes tool calls through a local proxy if needed.

Restart the client after updating the configuration so the tools become available in your MCP client environment.

Notes on configuration and usage

The remote MCP server URL to connect to is in the standard SSE endpoint format, typically ending with /sse. Use the exact URL shown when configuring clients.

Available tools

mcp-remote

Tool that proxies or connects to a remote MCP server via an SSE endpoint, enabling command execution on the remote server from a local client.