Remote

This MCP server runs on Cloudflare Workers and provides a remote, OAuth-enabled interface you can connect to from MCP clients. It supports local development and remote deployment, letting you test, inspect, and integrate Claude Desktop or other clients with a Cloudflare-based backend.

How to use

You access and control the remote MCP server from an MCP client, such as the MCP Inspector or Claude Desktop. Start by connecting your client to the local server, then use the available tools to perform actions, run tools, and authenticate with OAuth.

Connect the MCP Inspector to your local server. Start the inspector with npx @modelcontextprotocol/inspector. In the inspector, switch Transport Type to SSE and enter http://localhost:8787/sse as the MCP server URL, then click Connect. After login, you can list and call defined tools.

Optionally, connect Claude Desktop to your local server. In Claude, set the configuration to proxy through a local MCP endpoint by using the following config. This runs a local proxy so Claude can talk to your MCP server over HTTP.

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

How to install

Prerequisites: you need Node.js and npm installed on your system. You also need a working Git client. The following steps assume you want to develop and test the server locally before deploying.

# clone the repository
git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
npm install

# run locally
npx nx dev remote-mcp-server

Open a browser and navigate to http://localhost:8787/ to verify the local server is running.

Connect Claude Desktop locally to your MCP server. In Claude's Settings > Developer, edit the config and replace it with the following to point Claude at your local server.

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

Additional content

Deploying to Cloudflare requires creating a KV namespace for OAuth and then deploying. Use these steps to set up and deploy your remote MCP server.

npx wrangler kv namespace create OAUTH_KV

After creating the namespace, follow the guidance to add the namespace ID to wrangler.jsonc, then deploy the server.

npm run deploy

Debugging

If you encounter issues, restart Claude or connect directly to your MCP server from the command line to verify reachability.

npx mcp-remote http://localhost:8787/sse

If you need to clear authentication data locally, remove the local MCP auth cache.

rm -rf ~/.mcp-auth

Available tools

mcp_inspector

Tool to explore the MCP API locally by connecting via SSE, authenticating, and listing/calling available tools.

claude_desktop_integration

Configures Claude Desktop to proxy through the local MCP server and access tools via the mcp-remote proxy.