Remote

You set up a remote MCP server that you can connect to from MCP clients and tools like Claude Desktop. This server runs on Cloudflare Workers and supports local development, Cloudflare deployment, and remote access via an HTTP-like transport. Use it to expose MCP tools securely and test integrations from your favorite MCP clients.

How to use

You connect to your MCP server from an MCP client or the MCP Inspector to explore available tools, call them, and verify behavior. Start locally to experiment with a mock login flow and verify tool calls. When you deploy, you can connect a remote client to the Worker endpoint to run tools over the internet. Use the provided command configurations to point your client to the correct server URL or to the local proxy.

How to install

Prerequisites you need before starting: Node.js and pnpm. You will clone the project, install dependencies, and run the server locally for development.

# clone the repository
git clone https://github.com/cloudflare/ai.git
# Or if using ssh:
# git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
# Note: using pnpm instead of just "npm"
pnpm install

# run locally
npx nx dev remote-mcp-server

Additional setup and deployment steps

Deploy the remote MCP server to Cloudflare and prepare it for remote access.

1. npx wrangler kv namespace create OAUTH_KV
2. Follow the guidance to add the kv namespace ID to wrangler.jsonc
3. npm run deploy

Connecting to the server from an MCP client

Use the MCP Inspector to connect to your server and explore the available tools. Start the inspector and switch Transport Type to SSE, then use the server URL to connect.

npx @modelcontextprotocol/inspector

Claude Desktop integration

To connect Claude Desktop to your local MCP server, configure Claude to point at the local SSE URL. You run Mob MCP proxy locally so Claude can talk to your server over HTTP.

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

Connecting Claude Desktop to a remote MCP server

Point Claude Desktop to the remote Worker endpoint once you have deployed your MCP server. Use the remote SSE URL provided by your Cloudflare Worker deployment.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://worker-name.account-name.workers.dev/sse"
      ]
    }
  }
}

Debugging and troubleshooting

If you encounter issues, you can restart Claude, or try connecting directly from the command line to your local server to verify availability.

npx mcp-remote http://localhost:8787/sse
rm -rf ~/.mcp-auth