Servidor MCP remoto en Cloudflare

¡Pongamos en funcionamiento un servidor MCP remoto en Cloudflare Workers con inicio de sesión OAuth incluido!

Desarrollar localmente

# 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

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

Conecte el inspector MCP a su servidor

Para explorar su nueva API de MCP, puede utilizar el Inspector de MCP .

Inícielo con npx @modelcontextprotocol/inspector
Dentro del inspector , cambie el Tipo de transporte a SSE e ingrese http://localhost:8787/sse como la URL del servidor MCP al que conectarse y haga clic en "Conectar".
Accederá a una pantalla de inicio de sesión (simulada) con usuario y contraseña. Ingrese su correo electrónico y contraseña para iniciar sesión.
Deberías ser redirigido nuevamente al Inspector MCP y ahora podrás enumerar y llamar a cualquier herramienta definida.

Conecte Claude Desktop a su servidor MCP local

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

Abra el archivo en su editor de texto y reemplácelo con esta configuración:

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

Esto ejecutará un proxy local y permitirá que Claude se comunique con su servidor MCP a través de HTTP

Al abrir Claude, debería abrirse una ventana del navegador que te permitirá iniciar sesión. Verás las herramientas disponibles en la esquina inferior derecha. Si se le da la indicación correcta, Claude debería solicitar que se ejecute la herramienta.

Implementar en Cloudflare

npx wrangler kv namespace create OAUTH_KV
Siga las instrucciones para agregar el ID del espacio de nombres kv a wrangler.jsonc
npm run deploy

Llame a su servidor MCP remoto recién implementado desde un cliente MCP remoto

Tal como lo hizo anteriormente en "Desarrollar localmente", ejecute el inspector MCP:

npx @modelcontextprotocol/inspector@latest

Luego ingrese la URL de workers.dev (ej: worker-name.account-name.workers.dev/sse ) de su Worker en el inspector como la URL del servidor MCP al cual conectarse y haga clic en "Conectar".

Ahora se ha conectado a su servidor MCP desde un cliente MCP remoto.

Conecte Claude Desktop a su servidor MCP remoto

Actualice el archivo de configuración de Claude para que apunte a la URL de workers.dev (por ejemplo: worker-name.account-name.workers.dev/sse ) y reinicie 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 conectarse directamente a su servidor MCP en la línea de comando con el siguiente comando.

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

En algunos casos excepcionales puede ser útil borrar los archivos agregados a ~/.mcp-auth

rm -rf ~/.mcp-auth

Remote MCP Server on Cloudflare

Integrations