Automatizaciones

N8N + Claude Code: no es una guerra, es cuándo usar cada uno

La discusión no es cuál va a ganar. La discusión es cómo conectarlos para que trabajen juntos — y esta guía te muestra exactamente cómo hacerlo, paso a paso.

29 de mayo de 20265 min de lectura#n8n#claude-code#automatizacion#mcp#sistemas

Cuándo usar cada uno — la respuesta corta

No hay un ganador. Hay contextos distintos:

Usa N8N cuando necesitas:

Velocidad para conectar apps
Triggers y webhooks listos
Logs y monitoreo visual
Integraciones con APIs populares
Flujos simples sin código

Usa Claude Code cuando necesitas:

Lógica compleja y personalizada
Transformaciones de datos avanzadas
Sistemas específicos de tu negocio
Control total sobre el comportamiento
Automatizaciones sin límites de nodos

La ventaja real la tienen los que saben combinar ambos — no los que eligen bando.

La arquitectura: qué conecta qué

Para que Claude Code trabaje con tu instancia de N8N necesitas dos cosas instaladas:

n8n-mcp — el servidor MCP que conecta Claude Code con N8N via API. Claude puede crear, modificar y ejecutar workflows directamente.
n8n-skills — 7 skills que le enseñan a Claude cómo funciona N8N internamente: sintaxis de expresiones, patrones de workflow, validaciones, nodos específicos y más.

Son complementarios: el MCP le da acceso, las skills le dan conocimiento. Con los dos juntos, Claude se comporta como un desarrollador especializado en N8N.

📎 Fuentes: github.com/czlonkowski/n8n-mcp y github.com/czlonkowski/n8n-skills

Paso 1 — Crea tu API Key en N8N

Antes de instalar cualquier cosa, necesitas una API Key de tu instancia de N8N. Esta clave le da permiso a Claude de hablar con tu N8N.

1. Inicia sesión en tu instancia de N8N

Puede ser la versión cloud (https://tu-workspace.n8n.cloud) o tu instancia self-hosted (http://localhost:5678).

2. Ve a Settings → n8n API

En el panel izquierdo, busca el ícono de los tres puntos o “Settings” en la esquina inferior izquierda. Dentro, selecciona n8n API.

3. Haz clic en “Create an API Key”

Escribe un nombre descriptivo (ej: claude-code) y selecciona No expiration si quieres que no venza. Después haz clic en Save.

4. Copia la key inmediatamente

La key se muestra una sola vez. Cópiala ahora y guárdala en un lugar seguro (bloc de notas, gestor de contraseñas). Si la cierras sin copiarla, tendrás que crear una nueva.

⚠️ Importante: También anota la URL de tu instancia de N8N. La vas a necesitar en el paso siguiente. Para N8N Cloud: https://tu-workspace.n8n.cloud. Para self-hosted: http://localhost:5678.

📎 Proceso verificado en: docs.n8n.io/api/authentication

Paso 2 — Instala el MCP de N8N en Claude Code

El MCP es lo que le da a Claude acceso real a tu instancia de N8N. Con él, Claude puede ver, crear y modificar tus workflows directamente.

Opción A — Instalación rápida con npx (recomendada)

No necesitas clonar ningún repositorio. Abre el archivo de configuración de Claude Code en ~/.claude.json y agrega este bloque:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://tu-instancia.n8n.cloud",
        "N8N_API_KEY": "tu-api-key-de-n8n"
      }
    }
  }
}

Reemplaza https://tu-instancia.n8n.cloud con la URL de tu N8N y tu-api-key-de-n8n con la key que copiaste en el paso anterior.

Opción B — Instalación manual clonando el repo

Si prefieres tener el código localmente:

# 1. Clona el repo
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp

# 2. Instala dependencias y construye
npm install
npm run build
npm run rebuild

Luego en ~/.claude.json apunta al archivo construido con la ruta absoluta:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "node",
      "args": ["/ruta/absoluta/a/n8n-mcp/dist/mcp/index.js"],
      "env": {
        "NODE_ENV": "production",
        "LOG_LEVEL": "error",
        "MCP_MODE": "stdio",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://tu-instancia.n8n.cloud",
        "N8N_API_KEY": "tu-api-key-de-n8n"
      }
    }
  }
}

⚠️ Usa siempre rutas absolutas, no relativas. Por ejemplo: /Users/gabriel/n8n-mcp/dist/mcp/index.js — no ./dist/mcp/index.js. Las rutas relativas no funcionan en la configuración del MCP.

Reinicia Claude Code. Para verificar que el MCP está activo, usa el comando /mcp dentro de Claude Code — vas a ver el servidor n8n-mcp listado con sus herramientas disponibles.

📎 Configuración verificada en: n8n-mcp/docs/CLAUDE_CODE_SETUP.md

Paso 3 — Instala las Skills de N8N

Las skills le enseñan a Claude cómo funciona N8N por dentro. Sin ellas, el MCP conecta pero Claude comete errores típicos de sintaxis. Con ellas, trabaja como un experto.

Son 7 skills complementarias que se activan automáticamente según lo que le pides:

n8n Expression Syntax — Se activa cuando escribes expresiones {{}}, usas $json, $node. Evita los errores más comunes de sintaxis.
n8n MCP Tools Expert — Guía sobre cómo usar las herramientas del MCP de forma eficiente al buscar nodos y validar configuraciones.
n8n Workflow Patterns — 5 patrones arquitectónicos probados. Se activa cuando construyes flujos complejos con webhook, loops o branching.
n8n Validation Expert — Interpreta y corrige errores de validación. Se activa cuando hay errores de configuración en nodos.
n8n Node Configuration — Guía específica por operación: cómo configurar correctamente cada tipo de nodo según lo que quieres hacer.
n8n Code JS — Para escribir código JavaScript en nodos Code. Evita errores de scope y limitaciones del lenguaje en N8N.
n8n Code Python — Lo mismo pero para Python en nodos Code.

Instalación via plugin (más fácil)

/plugin install czlonkowski/n8n-skills

Ejecuta este comando dentro de Claude Code. Reinicia y las 7 skills estarán disponibles automáticamente.

Instalación manual clonando el repo

# 1. Clona el repo
git clone https://github.com/czlonkowski/n8n-skills.git

# 2. Copia las skills a tu directorio de Claude Code
cp -r n8n-skills/skills/* ~/.claude/skills/

# 3. Reinicia Claude Code

📎 Instalación verificada en: n8n-skills.com y github.com/czlonkowski/n8n-skills

Paso 4 — Pruébalo: pídele a Claude que construya un workflow

Con el MCP activo y las skills instaladas, abre Claude Code y prueba con algo como:

Construye un workflow en mi N8N que escuche un webhook,
tome el campo "email" del body, lo busque en una hoja de Google Sheets
y si no existe, lo agregue en una nueva fila con la fecha de hoy.

Claude va a usar las skills para entender la sintaxis correcta, buscar los nodos adecuados via el MCP y crear el workflow directamente en tu instancia de N8N — sin que abras el editor.

Otros ejemplos de lo que puedes pedirle:

“Muestra todos mis workflows activos”
“Activa el workflow llamado ‘Newsletter semanal’”
“Crea un workflow que mande un correo cuando llegue un formulario de Typeform”
“Revisa el workflow con ID abc123 y dime si tiene errores de configuración”
“Construye un flujo con un AI Agent que use OpenAI para clasificar correos entrantes”

Lo que cambia cuando los usas juntos

El flujo típico sin esta integración: piensas la automatización, abres N8N, arrastras nodos, configuras cada uno manualmente, pruebas, corriges errores, repites. Todo manual.

Con Claude Code + MCP + Skills: describes lo que quieres en lenguaje natural, Claude construye el workflow, lo valida y lo despliega en tu N8N. Tú solo revisas el resultado.

No es N8N vs Claude Code. Es N8N potenciado por Claude Code.