home / mcp / remote mcp server

Remote MCP Server

Provides a remote MCP server accessible via Cloudflare Workers, with local development, OAuth login, and remote access via MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "emaa-f-remote-mcp-server": {
      "url": "https://worker-name.account-name.workers.dev/sse"
    }
  }
}

You can run a remote MCP server on Cloudflare or locally, connect MCP clients and Claude Desktop, and debug through an HTTP/SDIO proxy that exposes the MCP API. This guide walks you through using the remote MCP server, installing prerequisites, and configuring clients to talk to it.

How to use

Connect MCP clients and tools to your server to access the MCP API. You can run a local proxy that exposes the MCP endpoint over SSE and point your clients at http://localhost:8787/sse, or connect to a cloud-hosted worker URL like a workers.dev endpoint. Use the MCP Inspector to explore available tools, trigger tool calls, and test authentication flows.

How to install

Prerequisites you need on your machine before starting:

Node.js (recommended latest LTS)
pnpm (for dependency management)

Install dependencies and run the local remote MCP server:

# clone the project
git clone https://github.com/cloudflare/ai.git
# Or if using ssh:
# git clone [email protected]: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 setup and usage notes

Deploying to Cloudflare creates a remote MCP server that can be reached via a Cloudflare Workers URL. After deployment, you can connect MCP clients to the remote server using the Worker URL with the sse endpoint.

To connect Claude Desktop to a local MCP server, configure Claude to proxy to the local SSE endpoint. Then you can login in Claude and access the available tools from the bottom-right. Use the provided configuration to point Claude to the local server.

Available tools

MCP Inspector

A browser-based tool to explore an MCP API, connect to an MCP server via SSE, perform mock login, and list/call defined tools.

Claude Desktop integration

An application workflow to connect Claude to an MCP server via a local proxy or a remote worker, enabling tool invocation from prompts.

mcp-remote

A CLI utility used to proxy commands from Claude or other clients to the MCP server over an HTTP(S) endpoint.

wrangler

Cloudflare's command-line tool used to deploy workers and manage Cloudflare KV namespaces for OAuth and MCP server hosting.