home / mcp / remote mcp server mcp

Remote MCP Server MCP

Exposes remote MCP endpoints over HTTP/SSE for Cloudflare and local clients to invoke tools.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kaiyuanzhuadmin-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 serves tools to clients without requiring authentication. This setup lets you expose your MCP endpoints to tools like the Cloudflare AI Playground or local clients, enabling interactive tool usage from anywhere you deploy it.

How to use

You can use your MCP server from an MCP client to access and run the tools you expose. After deployment, your server will be reachable at a dedicated URL and will provide an SSE-based MCP interface for remote clients.

Connect from the Cloudflare AI Playground to try your MCP server directly in a remote, web-based client. Open the Playground, enter your deployed MCP server URL, and start using your tools without additional setup.

If you want to connect a local MCP client like Claude Desktop, you can route requests through an mcp-remote proxy. Use the provided configuration example to register your remote server under a local name, then restart the client to enable the tools.

Example configuration for a local MCP client to reach the remote server:

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

How to install

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

Option 1: Deploy online using the provided deployment URL.

Option 2: Run the MCP server locally using the command shown here.

# Option 2: Local deployment via Cloudflare template
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

Additional notes and customization

To customize your MCP server, add your own tools inside the init() method of src/index.ts using this.server.tool(...). This is where you define the individual tool behavior and capabilities that your clients can call.

Connect to the Cloudflare AI Playground to interact with your remote MCP server from a ready-made remote client. Use the Playground to run your tools and verify that they respond as expected.

If you plan to run the server locally from Claude Desktop or another MCP client, the following configuration demonstrates how to register a remote MCP server under a local identifier and how to point to the remote SSE endpoint.