Cloudflare

You can run a remote MCP server on Cloudflare Workers, test it locally, connect via the MCP Inspector, and then route it into Claude Desktop. This setup gives you an OAuth-enabled, browser-accessible MCP server that you can develop against on your machine and deploy to the cloud.

How to use

Connect to your local MCP server with the MCP Inspector to explore tools and endpoints. Start the inspector, switch Transport Type to SSE, and point it at http://localhost:8787/sse. You’ll see a mock login screen; sign in with any email and password to access the available tools.

To use Claude Desktop with your local server, configure Claude to talk to your local MCP instance. In Claude, go to Settings > Developer > Edit Config and set the MCP URL to your local SSE endpoint. Then run Claude and open its integrated browser login flow. You should see the tools appear in the bottom-right area once you’re authenticated.

When you are ready to deploy to Cloudflare, follow a deployment flow that creates a KV namespace for OAuth data, updates the runtime configuration, and deploys your worker. After deployment, you will connect to your remote MCP server using a remote MCP client by pointing the client to the Worker’s SSE URL.

How to install

Prerequisites: you need Node.js and a package manager. The project uses pnpm for dependency management during development.

1. Install prerequisites and clone the project. Use your terminal to run:

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

2. Install dependencies with pnpm and prepare the local server. Change into the project directory, install, and start the local MCP server build in development mode. These steps assume you are using pnpm and nx tooling in this environment.

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

# run locally
npx nx dev remote-mcp-server

3. Open the local server in your browser. You should be able to visit http://localhost:8787/ to access the MCP server interface.

Additional content

Deploying the MCP server to Cloudflare involves creating a KV namespace for OAuth data, updating the deployment configuration, and running the deployment script. You will set up an OAuth data store in Cloudflare KV, configure the deployment to reference the KV namespace, and then deploy the worker so it is accessible at a Worker URL. The local SSE endpoint remains the bridge to your MCP client during development.

Connecting Claude Desktop to the Local MCP server uses a predefined configuration that points Claude to the local SSE endpoint. You can switch Claude’s config to run a local proxy that forwards requests to your MCP server via SSE.

If you need debugging steps, you can restart Claude or test connectivity directly from the command line by invoking the MCP proxy helper with the SSE URL. Clearing local authentication state can be done by removing the OAuth data directory if needed.