home / mcp / remote mcp server

Remote MCP Server

Hosts a remote MCP server on Cloudflare Workers and enables local clients to connect via a proxy.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hackerrdave-remote-mcp-server-authless": {
      "url": "https://remote-mcp-server-authless.<your-account>.workers.dev/sse"
    }
  }
}

You can run a remote MCP server on Cloudflare Workers that you connect to from local or remote MCP clients. This setup lets you expose tools remotely and access them through standard MCP clients or proxies, enabling quick experimentation and integration without managing your own server infrastructure.

How to use

Once your remote MCP server is up, you can connect from an MCP client or via a local proxy to access tools exposed by the server. You can use the Cloudflare Playground to test your server, or configure a local client to launch tools through the remote endpoint. When you connect, you’ll see the available tools (for example, a calculator tool) that you can invoke to perform tasks through the MCP server.

How to install

Prerequisites you need before starting are Node.js and npm. You’ll also need access to the Cloudflare environment if you plan to deploy remotely.

# Install Cloudflare command line tooling and create a new MCP server project from a template
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

# Or deploy directly via a Cloudflare deployment URL in a browser
# Open a deployment URL that provisions your MCP server on Cloudflare Workers

Additional sections

Configure how your MCP server connects to clients by using the provided configuration examples. You can connect from the Cloudflare AI Playground or from a local MCP client through the mcp-remote proxy.

Connect to Cloudflare AI Playground to test your MCP server. Use the Playground to run tools directly against your deployed server, which helps you verify tool availability and behavior in a browser-based environment.

Connect Claude Desktop to your MCP server via the mcp-remote proxy. Add the following entry to Claude Desktop configuration to enable the remote calculator tool through your MCP server. You can point to either the local proxy or the remote Cloudflare Workers URL.

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

Available tools

calculator

A remote calculator tool exposed via MCP server that you can invoke from clients through the mcp-remote proxy.