Remote

You can run a remote MCP server on Cloudflare Workers with built-in OAuth login, connect it to the MCP Inspector, and use it from Claude Desktop. This guide walks you through local development, connecting clients, deploying to Cloudflare, and debugging tips so you can prototype and test end-to-end MCP interactions.

How to use

Develop locally, then explore and use your MCP server from an inspector or a Claude Desktop integration. Start the local server, connect the MCP Inspector via SSE, login, and you can list and call available tools. You can also connect Claude Desktop by pointing it at your local server or a deployed worker URL.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You should also have npx available via npm to run developer tasks.

Clone the project, install dependencies, and run the server locally.

How to install

# 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

How to use

After starting locally, you should be able to open the MCP server in your browser at the local address shown in the run output.

Deploy to Cloudflare

Prepare a Cloudflare KV namespace for OAuth state storage, then deploy the server so it runs under Workers.

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