Remote MCP Server (Cloudflare AI Authless)

You can run a remote MCP server that exposes your tools via a cloud-based endpoint, then connect your MCP clients to it to execute tools remotely. This setup lets you deploy and customize an MCP server quickly, share your tools, and use them from supported clients without hosting everything locally.

How to use

Connect with an MCP client to run your tools remotely. You can use the Cloudflare AI Playground to test and experiment with your server, or configure a local client like Claude Desktop to reach the remote endpoint.

How to install

Prerequisites: install Node.js and npm on your machine.

Run the deployment command to create your remote MCP server with the provided template.

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

Additional notes

Customize your MCP server by adding tools inside the init() method of src/index.ts using this.server.tool(...). This is how you expose new capabilities to clients.

Connect to Cloudflare AI Playground to try your MCP server directly from a remote client. In the Playground, enter your deployed MCP server URL and you can start using your tools right away.

If you want to connect from a local MCP client like Claude Desktop, configure the remote proxy to point to your MCP server. The following example shows how to reference your remote server from Claude Desktop as a calculator tool:

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

Available tools

calculator

Remote calculator tool exposed via mcp-remote that forwards calculations to the specified MCP server endpoint.