Remote

You learn how to run a remote MCP server on Cloudflare Workers and connect clients like the MCP Inspector and Claude Desktop. This setup lets you host an MCP API in the cloud and access it from local or remote clients for testing, prototyping, and integration with Claude.

How to use

You can connect to your MCP server from different clients to explore tools and run actions. Start by deploying or running the server locally, then connect the MCP Inspector to the server using the SSE transport. When using Claude Desktop, configure the MCP proxy so Claude talks to your server over HTTP. Finally, you can connect from a remote MCP client by pointing it to the cloud-hosted Worker URL.

How to install

Prerequisites: ensure you have Node.js and pnpm installed on your machine.

Clone the project and install dependencies locally:

# clone the repository
# replace with the actual URL if needed
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 sections

Deploying to Cloudflare and connecting from clients are supported workflows. You can deploy the MCP server to Cloudflare Workers, then connect MCP clients from your local environment or from Claude Desktop using a cloud URL.

To connect from a remote MCP client, start the MCP Inspector and point it at the cloud URL in the SSE path, for example: https://worker-name.account-name.workers.dev/sse. This will allow you to list and call tools exposed by your MCP server.

To connect Claude Desktop to your remote server, configure the MCP proxy to use your Worker URL with the SSE endpoint, for example https://worker-name.account-name.workers.dev/sse.

For debugging, you can test connectivity directly from the command line using: npx mcp-remote http://localhost:8787/sse and you can clear saved credentials if necessary with rm -rf ~/.mcp-auth.

Available tools

inspector

MCP Inspector tool to explore the MCP API, switch to SSE transport, connect to the server, and interact with tools.

mcp-remote

CLI proxy used to connect Claude Desktop to the MCP server or to interact with a remote MCP server from the command line.