Remote

You can run a remote MCP server on Cloudflare Workers that serves your tools over a simple, authenticated-free channel, making it easy to connect from both cloud-based and local MCP clients. This setup lets you expose your MCP tools remotely and use them from playgrounds or desktop clients with straightforward configuration.

How to use

You can connect to your MCP server from an MCP client or a cloud playground to run your tools remotely. Use the Cloudflare Playground to access and test your server by supplying the deployed URL, then invoke your tools directly from the playground. You can also connect from a local client by configuring it to reach the remote server, or by running a local proxy that forwards to the remote endpoint.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. If you are using a macOS or Linux environment, you may also need a working terminal and internet access.

How to install

# 1) Install the Cloudflare template to create your MCP server project
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

# 2) Change into the project directory
cd my-mcp-server

# 3) Install dependencies
npm install

# 4) Build and start (if applicable in your template)
npm run build
npm run start

How to use

After you have the server running, you can connect via the Cloudflare AI Playground using the deployed URL. You can also connect a local client by pointing it to the remote server URL that ends with /sse.

Additional content

Configuration and usage notes: to add your own tools, define each tool inside the init() method of src/index.ts using this.server.tool(...). This enables you to expose your custom capabilities to clients like the Playground or Claude Desktop.

Connect Cloudflare AI Playground

Open the Playground and enter your deployed MCP server URL (for example, remote-mcp-server-authless.your-account.workers.dev/sse). You can now use your MCP tools directly from the playground.

Connect Claude Desktop to your MCP server

You can also connect from Claude Desktop by configuring the mcp-remote client. Update Claude Desktop Settings > Developer > Edit Config to include a server entry that points to the remote endpoint.

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