Cómo conectar el MCP nativo de n8n a Claude, Cursor o Claude Code

Antes de empezar

Necesitas:

• n8n versión 2.18.4 o superior (cloud o self-hosted). Si estás en self-hosted con una versión vieja, actualiza primero.
• Permisos de owner o admin de la instancia. Si no eres tú, pídele a quien administre n8n que active el MCP.
• Un cliente MCP compatible: Claude Desktop, Claude Code, Cursor, Codex CLI, ChatGPT con MCP, o Google ADK.
• Si usas n8n self-hosted: tu instancia tiene que ser accesible públicamente (con dominio y HTTPS) para que el cliente se pueda conectar. Si está solo en localhost, no va a funcionar con clientes cloud.

Paso 1: Activar el MCP a nivel de instancia

1. Entra a tu instancia de n8n.
2. Ve a Settings → Instance-level MCP.
3. Activa el toggle "Enable MCP access".

Eso prende el servidor MCP. Por defecto ningún workflow está expuesto todavía — eso lo controlas tú en el siguiente paso.

Paso 2: Habilitar los workflows que quieres exponer

n8n te obliga a elegir qué workflows ve la IA. Esto es a propósito — protege que un agente no toque cosas que no debe.

Opción A — Desde la página de Instance-level MCP:

1. En la misma pantalla de Settings → Instance-level MCP, ve a la pestaña Workflows.
2. Click en "Enable workflows".
3. Busca el workflow por nombre y selecciónalo.

Opción B — Desde el workflow directamente:

1. Abre el workflow.
2. Click en el menú (...) arriba a la derecha → Settings.
3. Activa "Available in MCP".

Tip importante: dale a cada workflow una descripción clara. La IA lee esa descripción para decidir cuándo usarlo. Una descripción como "Workflow 1" no le sirve. Algo como "Recibe leads del formulario de la web, los califica con Claude, y los manda al CRM" sí.

Paso 3: Obtener tu credencial de conexión

n8n te da dos opciones. Elige según tu caso:

Para obtener cualquiera de los dos:

1. En Settings → Instance-level MCP, click en el botón "Connection details" arriba a la derecha.
2. Para OAuth: ve a la pestaña OAuth y copia la server URL.
3. Para Access Token: ve a la pestaña Access Token y copia tanto la URL como el token que se genera automáticamente.

⚠️ Cópialo de una vez. En visitas siguientes el token sale enmascarado y no lo vas a poder volver a copiar — solo regenerar.

Paso 4: Configurar tu cliente

Opción A — Claude Desktop (más amigable para no técnicos)

1. Abre el archivo de configuración:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Pega esta configuración (con Access Token):

{
  "mcpServers": {
    "n8n": {
      "type": "http",
      "url": "https://tu-instancia.n8n.cloud/mcp",
      "headers": {
        "Authorization": "Bearer TU_TOKEN_AQUI"
      }
    }
  }
}

1. Reemplaza tu-instancia.n8n.cloud por tu URL real y TU_TOKEN_AQUI por el token del Paso 3.
2. Guarda y reinicia Claude Desktop completamente.

Si prefieres OAuth (más seguro para uso continuo), simplemente añade el servidor MCP desde la interfaz de Claude Desktop usando solo la URL — Claude te abrirá el navegador para autorizar.

Opción B — Claude Code (recomendado por n8n para construir workflows)

Desde la terminal, en tu proyecto:

claude mcp add n8n --transport http https://tu-instancia.n8n.cloud/mcp \
  --header "Authorization: Bearer TU_TOKEN_AQUI"

Reemplaza la URL y el token con los tuyos. Listo — Claude Code ya tiene el MCP cargado.

Por qué n8n recomienda Claude Code para esto: los coding agents producen TypeScript validado mejor que los chat clients. Si tu objetivo es construir workflows (no solo ejecutarlos), Claude Code te da mejores resultados con el mismo prompt.

Opción C — Cursor

1. Ve a Settings → MCP dentro de Cursor.
2. Click en "Add new MCP server".
3. Configura:
   • Type: HTTP
   • URL: https://tu-instancia.n8n.cloud/mcp
   • Headers: Authorization: Bearer TU_TOKEN_AQUI
4. Guarda y reinicia Cursor.

Paso 5: Probar la conexión

Abre tu cliente y manda un mensaje de prueba:

"Lista los workflows que tengo disponibles en n8n por MCP."

Si está bien conectado, te lista los workflows que habilitaste en el Paso 2.

Después prueba con algo más interesante:

"Créame un workflow en n8n que cada lunes a las 9am traiga el clima de Bogotá y me lo mande por email a [tu correo]."

Si todo funciona, el workflow aparece corriendo en tu instancia en menos de un minuto.

Errores comunes (y cómo arreglarlos)

1. "Failed to connect to MCP server"

• Revisa que la URL sea correcta — incluye el /mcp al final.
• Si es self-hosted, confirma que la instancia es accesible desde fuera (no solo localhost).
• Verifica que el toggle de MCP esté prendido en Settings.

2. "Unauthorized" o "401"

• Tu token expiró o lo escribiste mal. Vuelve al Paso 3 y genera uno nuevo.
• Asegúrate de incluir la palabra Bearer antes del token, con un espacio.

3. "No workflows available"

• No has habilitado ningún workflow individualmente. Vuelve al Paso 2.
• Recuerda que solo workflows con triggers Webhook, Schedule, Form, Manual o Chat son ejecutables por el MCP. Otros tipos no se exponen.

4. "Tool execution failed" cuando ejecuta un workflow

• El workflow probablemente requiere credenciales (Gmail, Slack, etc.) que no están configuradas. El MCP no asigna credenciales automáticamente para HTTP Request — esos los tienes que configurar tú a mano.

5. Claude construye un workflow que se rompe a la primera

• Es normal en flujos complejos — el MCP hace reintentos. Si tras 2-3 reintentos sigue fallando, dale más contexto en el prompt: nombres exactos de credenciales que tienes disponibles, formato de los datos, qué nodos prefieres usar.

Cuándo conviene usar cada cliente

Tips de seguridad antes de pasar a producción

1. Empieza con un workflow de prueba. No expongas tu workflow más crítico en el primer intento.
2. Usa OAuth en vez de Access Token si vas a tener varios clientes. Te permite revocar acceso individual.
3. Revisa las descripciones de tus workflows. La IA decide qué workflow ejecutar leyendo eso. Una descripción ambigua puede hacer que ejecute el workflow equivocado.
4. Para clientes de tu agencia: crea un usuario separado en n8n con acceso solo a los workflows del cliente. El token MCP es por usuario.

Recursos oficiales

• Documentación oficial: docs.n8n.io/advanced-ai/mcp/
• Versión mínima recomendada: 2.18.4 (revísala en Settings → About)
• Foro de la comunidad de n8n para reportar issues: community.n8n.io

¿Te sirvió esta guía? Compártela con quien todavía cree que n8n se quedó atrás.