Remote MCP Server (Authless Cloudflare)

You can run a remote MCP server that exposes tools to clients over HTTP or via a local stdio proxy. This lets MCP clients like the Cloudflare AI Playground or desktop clients access tools you define, run actions remotely, and compose workflows without embedding logic in each client.

How to use

Connect to your remote MCP server from an MCP client to start using your tools. You can use the Cloudflare AI Playground to run tools directly from the server by providing the server URL. You can also connect a local MCP client via a proxy, which lets you use the same tools from your own development environment.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. You should also have access to a terminal or command prompt.

Step 1. Deploy the remote MCP server to a public URL you control.

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

Step 2. Note the deployed URL and the SSE endpoint as provided by your deployment. You will use the URL in MCP clients.

Step 3. Configure a local proxy or client to connect to the server. If you want to use a local proxy, you can reference the example configuration below.

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

Additional content

Customize your MCP server by adding tools in the init() method of the server code. Define each tool with this.server.tool(...) to expose it to MCP clients.

Playground access lets you test your MCP server from a remote client. Open the Cloudflare AI Playground, enter your deployed server URL, and start using your tools directly from the playground.

You can also connect from Claude Desktop or other local MCP clients using the mcp-remote proxy. Update your client’s MCP configuration to point at your server’s SSE endpoint, restart the client, and your tools will be available.

Notes and examples

Example tool exposure: you can define a tool named calculator within the server which shows up as a callable MCP tool. Use the same approach when you add more tools to expand capabilities.