Remote

You can run a remote MCP server that exposes its tools over HTTP or via a local stdio proxy, enabling clients to access and execute tools from anywhere. This setup is useful for testing, remote collaboration, and integrating tools into external clients without embedding them directly in your own environment.

How to use

Connect to your remote MCP server from clients to access tools exactly as if they were running locally. You can use the Cloudflare AI Playground to interact with your remote server in a browser, or configure a local MCP client to reach the server over HTTP.

How to install

Prerequisites you need before starting:

• Node.js installed on your machine (recommended LTS version)

• npm package manager (comes with Node.js) or npx for quick commands

Step-by-step commands to set up the MCP server on Cloudflare Workers:

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

Additional sections

Customize your MCP server by adding tools directly in the initialization code. Open the server’s entry point and define each tool inside the init() method using this.server.tool(...). This is the place to register your own commands, handlers, and integrations so clients can discover and run them.

Connect to Cloudflare AI Playground to test and run your MCP tools from a remote client. Follow these steps:

1. Open the Cloudflare AI Playground at the provided URL.

2. Enter your deployed MCP server URL: remote-mcp-server-authless.<your-account>.workers.dev/sse

3. You can now use your MCP tools directly from the playground.

To connect Claude Desktop to your MCP server, use the mcp-remote proxy configuration. In Claude Desktop, go to Settings > Developer > Edit Config and update with the following configuration, replacing the URL with your remote server if needed:

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // or remote-mcp-server-authless.your-account.workers.dev/sse
      ]
    }
  }
}