Remote

You run an MCP server that hosts remote tools and exposes them to MCP clients, such as the Cloudflare AI Playground or local MCP clients. This lets you deploy a tooling surface that can be accessed via a remote URL or through a local proxy, enabling you to execute tools from anywhere the MCP client can reach.

How to use

Connect your MCP client to the remote server using either the remote URL or a local proxy configuration. You can access the server from the Cloudflare AI Playground by entering the deployed MCP server URL and starting to use your tools directly from the playground.

How to install

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

Create and deploy the remote MCP server using the Cloudflare template. Run the following command to generate and deploy the server locally:

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

How to customize your MCP server

To add your own tools, define each tool inside the init() method of src/index.ts using this.server.tool(...).

Additional notes and setup examples

You can connect your MCP server to a local or remote client via a standard MCP URL or a local proxy. For remote access, you will typically use a URL similar to remote-mcp-server-authless.your-account.workers.dev/sse. For local development, you can point a local client to http://localhost:8787/sse through a proxy such as mcp-remote or equivalent tooling.

Claude Desktop configuration example

Configure Claude Desktop to connect to your remote MCP server by editing the MCP connections in Settings > Developer > Edit Config and adding a new server entry that points to your MCP server.

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}