Remote MCP Server (Cloudflare Authless)

You deploy a remote MCP server on Cloudflare Workers that exposes a streaming endpoint you can connect to with MCP clients. It lets you define your own tools and use them from remote clients or the Cloudflare AI Playground, enabling practical, extensible AI-assisted workflows without authorizing every request.

How to use

Connect to your remote MCP server from an MCP client or the Cloudflare AI Playground to start using your tools. You can access the server via the dedicated SSE URL and then issue requests through the client to run your tools and retrieve results.

How to use

Connect to Cloudflare AI Playground to run your MCP tools directly from a browser. Open the Playground, enter your deployed MCP server URL, and start executing the available tools.

How to use

If you want to use Claude Desktop or another local MCP client, you can connect through the mcp-remote proxy. You configure Claude Desktop to point at your server URL or localhost proxy, then restart the app to load the tools.

How to use

In Claude Desktop, add a new MCP server configuration with the following settings: the server name is arbitrary (for example, calculator), the command is npx, and the arguments include the remote MCP package you want to run, followed by the server URL that ends with /sse. After saving, restart Claude and the tools from your remote server become available in Claude’s interface.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Option A: Deploy a remote MCP server to Cloudflare Workers using the interactive installer.

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

# This will set up a remote MCP server named my-mcp-server using the authless template.

How to install

Option B: Run the setup locally with the same template to generate your MCP server files on your machine.

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

# After installation, you can customize src/index.ts to add your own tools.

How to install

After the setup, you will have a project you can tailor. The following steps illustrate a typical flow to get your server running and ready for deployment.

Additional notes

Customizing your MCP Server: To add your own tools, define each tool inside the init() method of src/index.ts using this.server.tool(...). This is where you specify the capabilities your MCP server offers to clients.

Additional notes

Connect Claude Desktop to your MCP server: You can connect to your remote MCP server from Claude Desktop by configuring the MCP server entry with the remote URL. The typical configuration uses npx and includes the remote server URL under the mcp-remote proxy. Example configuration provided in practice follows this shape.

Additional notes

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