Remote

You run a remote MCP server on Cloudflare Workers or locally, enabling a standardized, instrumented interface for tools that your clients can call. This server exposes an HTTP/SSE endpoint for tool discovery and execution, and you can connect via the MCP Inspector or Claude Desktop to experiment, develop, and deploy your MCP-enabled workflows.

How to use

To use your MCP server, connect an MCP client such as the MCP Inspector or Claude Desktop. Start by pointing the client at the local server, then switch to the appropriate transport for your client and begin exploring tools.

Using the MCP Inspector locally, start the inspector, select SSE as the transport, and connect to the server at http://localhost:8787/sse. You will see a mock login screen; enter any email and password to log in, then you can list and call defined tools.

If you want Claude Desktop to talk to your local MCP server, configure Claude to use a local proxy by updating the MCP config with a command similar to npx mcp-remote http://localhost:8787/sse. This runs a local proxy so Claude can communicate with your MCP server via HTTP.

How to install

Prerequisites: you need Node.js (and associated tooling) installed on your machine. You will also use pnpm for dependencies in this setup.

Concretely, follow these steps to run the server locally:

# clone the repository
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 involves creating an OAuth KV namespace for storage and then deploying your Worker. The steps shown are:

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

Troubleshooting and debugging

If you encounter issues, you can restart Claude or try connecting to the MCP server directly from the command line with the following command to verify connectivity and basic behavior.

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

If authentication or local state becomes problematic, you can clear local authentication files to reset sessions.

rm -rf ~/.mcp-auth

Available tools

MCP Inspector

A client utility to explore and test MCP servers. It connects to the MCP server via SSE, lets you login with any credentials to browse available tools, and execute them from the interface.

Claude Desktop integration

Integration that enables Claude to talk to the MCP server through a local proxy using the mcp-remote command. It uses a config file to map MCP servers to Claude tasks and enables tool invocation from Claude prompts.