Remote

You can deploy a remote MCP server that runs on Cloudflare Workers and expose an MCP-compatible interface without authentication. This setup lets you connect MCP clients to remote tools hosted in a scalable edge environment, enabling quick experimentation and integration with playgrounds and desktop clients.

How to use

Connect your MCP client to the remote server to access the tools you expose. You can use the Cloudflare AI Playground to interact with your MCP server directly in a browser, or configure local clients to talk to the remote endpoint. When connected, your MCP tools become available for you to invoke, test, and compose into workflows.

How to install

Prerequisites you need before installing this MCP server include Node.js and npm on your machine. Ensure you have a modern Node.js runtime and npm available in your shell.

Install and bootstrap your remote MCP server using the included template that targets a Cloudflare Workers deployment. Run this command from a directory where you want your server project to live:

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

After setup, deploy your MCP server to a URL provided by Cloudflare. It will look like this, once deployed: remote-mcp-server-authless.<your-account>.workers.dev/sse. This endpoint is your MCP server URL you will point clients at.

Additional sections

Configuration and customization options are available by editing the server’s initialization code. To add your own tools, define each tool inside the init() method of the source index file using this.server.tool(...). This enables you to plug in a variety of utilities that your MCP server can expose to clients.

Connect to the Cloudflare AI Playground to try your MCP server from a remote client. Open the playground, paste your deployed MCP server URL (for example, remote-mcp-server-authless.your-account.workers.dev/sse), and start testing your tools directly in the playground environment.

If you want to run a local MCP client against your remote server from Claude Desktop, you can configure the MCP connection in Claude Desktop’s Settings. Use the following configuration as an example, replacing the remote URL with your deployed endpoint:

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