Remote MCP Server on Cloudflare

Un servidor MCP remoto desplegable en Cloudflare Workers con soporte de inicio de sesión OAuth.

Documentación

Remote MCP Server on Cloudflare

Vamos a poner en marcha un servidor MCP remoto en Cloudflare Workers, completo con inicio de sesión OAuth.

Desarrollar localmente

# 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

Deberías poder abrir http://localhost:8787/ en tu navegador

Conecta el inspector MCP a tu servidor

Para explorar tu nueva API de MCP, puedes usar el MCP Inspector.

Inícialo con npx @modelcontextprotocol/inspector
Dentro del inspector, cambia el Tipo de Transporte a SSE e introduce http://localhost:8787/sse como la URL del servidor MCP al que conectarte, y haz clic en "Connect"
Serás redirigido a una pantalla de inicio de sesión (simulada) de usuario/contraseña. Introduce cualquier correo y contraseña para iniciar sesión.
Deberías ser redirigido de vuelta al inspector MCP y ahora puedes listar y llamar cualquier herramienta definida.

Conecta Claude Desktop a tu servidor MCP local

El inspector MCP es genial, pero realmente queremos conectarlo a Claude. Sigue la Guía de inicio rápido de Anthropic y dentro de Claude Desktop ve a Configuración > Desarrollador > Editar Config para encontrar tu archivo de configuración.

Abre el archivo en tu editor de texto y reemplázalo con esta configuración:

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Esto ejecutará un proxy local y permitirá que Claude hable con tu servidor MCP a través de HTTP.

Cuando abras Claude, se abrirá una ventana del navegador que te permitirá iniciar sesión. Deberías ver las herramientas disponibles en la esquina inferior derecha. Con el prompt adecuado, Claude solicitará llamar a la herramienta.

Clicking on the hammer icon shows a list of available tools

$Claude answers the prompt 'I seem to have lost my calculator and have run out of fingers. Could you use the math tool to add 23 and 19?' by invoking the MCP add tool$

Despliega en Cloudflare

npx wrangler kv namespace create OAUTH_KV
Sigue las indicaciones para añadir el ID del namespace de KV a wrangler.jsonc
npm run deploy

Llama a tu servidor MCP remoto recién desplegado desde un cliente MCP remoto

Igual que hiciste arriba en "Desarrollar localmente", ejecuta el inspector MCP:

npx @modelcontextprotocol/inspector@latest

Luego introduce la URL workers.dev (ej: worker-name.account-name.workers.dev/sse) de tu Worker en el inspector como la URL del servidor MCP al que conectarte, y haz clic en "Connect".

Ahora te has conectado a tu servidor MCP desde un cliente MCP remoto.

Conecta Claude Desktop a tu servidor MCP remoto

Actualiza el archivo de configuración de Claude para que apunte a tu URL workers.dev (ej: worker-name.account-name.workers.dev/sse) y reinicia Claude.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://worker-name.account-name.workers.dev/sse"
      ]
    }
  }
}

Depuración

Si algo sale mal, puede ser útil reiniciar Claude, o intentar conectarte directamente a tu servidor MCP en la línea de comandos con el siguiente comando.

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

En algunos casos raros, puede ayudar limpiar los archivos añadidos a ~/.mcp-auth

rm -rf ~/.mcp-auth