Remote

You can run a remote MCP server on Cloudflare Workers and connect it to your tools and Claude Desktop, enabling secure OAuth login and remote access to your MCP endpoints from local or remote clients.

How to use

Connect your MCP client to the remote MCP server to explore tools and call actions. Start by using the MCP Inspector to attach to your local server, then configure Claude Desktop to talk to either a local proxy or a remote worker URL. You can switch between local development and remote deployment by using the dedicated SSE endpoints shown in each setup. When Claude is properly configured, you will see available tools and be able to invoke them from your prompts.

How to install

Prerequisites you need before starting are Node.js and npm installed on your system.

Step by step commands to set up and run locally are:

# 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

Additional setup and usage notes

To explore your new MCP API locally, open the local server at the root URL and connect the MCP Inspector via SSE.

Then configure Claude Desktop to talk to your local MCP server by editing the configuration file and pointing it to the local SSE endpoint.

Finally, you can deploy to Cloudflare and connect Claude Desktop to the remote endpoint, using the deployed worker URL for the SSE stream.

Available tools

inspector

Launches the MCP Inspector to explore the MCP API using SSE transport, authenticate with a mock login, and list/call defined tools.

mcp-remote

CLI proxy used by Claude Desktop to connect to the MCP server over HTTP(S) by running a local proxy and routing tool calls.

wrangler

Cloudflare CLI to manage Worker deployments, including creating necessary KV namespaces for OAuth and deployment configuration.

nx

Monorepo task runner used to start the local development server for the remote MCP server.