La Biblia de n8n: de la automatización de workflows a los agentes de IA

De Apache NiFi hemos hablado mucho, mucho, mucho… y ya tocaba hacer lo mismo con la otra herramienta que no falta nunca en mi caja de herramientas: n8n.

Lo uso desde su lanzamiento, en octubre de 2019, cuando era poco más que el proyecto personal de Jan Oberhauser en Berlín. Lo he visto pasar de una curiosidad para geeks a una empresa valorada en miles de millones y a una de las plataformas de agentes de IA más usadas del mundo. Así que aquí va mi resumen de lo más destacado… con lo que me hubiera gustado saber el primer día.

¿Qué es n8n?

n8n (se pronuncia n-eight-n, de nodemation) es una plataforma de automatización de workflows: conectas aplicaciones, APIs y bases de datos arrastrando nodos en un lienzo, y cuando lo visual se queda corto, escribes código. Esa es su gracia: es visual cuando quieres y es código cuando lo necesitas.

Tres cosas lo hacen diferente de Zapier o Make:

• Lo puedes autoalojar. Tus datos no salen de tu infraestructura, algo clave si trabajas con datos sensibles, con el GDPR o con infraestructuras críticas.
• Es fair-code. El código es público y puedes usarlo, modificarlo y autoalojarlo gratis. Desde marzo de 2022 usa su propia Sustainable Use License; lo único que no puedes hacer es revenderlo como servicio que compita con ellos.
• No cobra por paso. En la nube cobra por ejecución del workflow completo, no por cada acción, y autoalojado… no cobra.

Un poco de historia

Y un dato que lo dice todo: el repositorio de n8n en GitHub supera ya las 200.000 estrellas. En 2025 fue el proyecto JavaScript que más creció de todo GitHub.

Los conceptos que tienes que entender

Antes de tocar nada, cuatro conceptos. Si los tienes claros, todo lo demás encaja:

• Workflow: el flujo completo, de principio a fin.
• Nodos: cada paso del flujo. Hay triggers (lo que arranca el workflow: un webhook, un horario, un email nuevo…) y nodos de acción (lo que hace algo: llamar a una API, escribir en una base de datos, enviar un Slack…).
• Items: n8n no pasa “un dato” de un nodo a otro, pasa una lista de items en JSON. Cada nodo se ejecuta, por defecto, una vez por cada item. Este es el concepto que más confunde al principio… y el que más potencia da cuando lo entiendes.
• Expresiones: lo que va entre {{ }}. Te permiten usar datos de nodos anteriores en cualquier campo:

{{ $json.email }}                         // un campo del item actual
{{ $('Webhook').item.json.body.nombre }}  // un campo de otro nodo
{{ $now.toFormat('yyyy-MM-dd') }}         // fechas con Luxon

Los nodos que más uso

Hay cientos de integraciones, pero el 80% de mis workflows se construyen con estos:

• Webhook y Schedule Trigger: para arrancar flujos desde fuera o con un horario.
• HTTP Request: la navaja suiza. Si una aplicación tiene API y no tiene nodo propio, con esto basta (y puedes importar un comando curl directamente).
• Code: JavaScript o Python cuando lo visual se queda corto.
• IF, Switch y Filter: para las bifurcaciones.
• Merge y Loop Over Items: para juntar ramas y procesar por lotes (imprescindible cuando una API tiene límites de peticiones).
• Execute Workflow: para llamar a sub-workflows. Mi consejo número uno: workflows pequeños y reutilizables, igual que funciones en código. Un workflow de 80 nodos no lo mantiene nadie.
• Wait: para pausar hasta una fecha, un webhook o la aprobación de una persona (el famoso human in the loop).

Gestión de errores: lo que nadie hace al principio

Un workflow que falla en silencio es peor que no tener workflow. Tres capas:

1. En cada nodo: activa Retry On Fail en los nodos que llaman a APIs externas, y decide si un error debe parar el flujo o continuar (On Error → Continue).
2. Un error workflow global: crea un workflow que empiece con el nodo Error Trigger y que te avise (Slack, email, lo que uses). Luego, en los ajustes de cada workflow, lo seleccionas como su Error Workflow.
3. Monitorización externa: si lo autoalojas, la edición comunitaria no te va a avisar sola de que algo va mal. Monitoriza el contenedor y la base de datos como cualquier otro servicio de producción.

n8n e IA: de automatizar tareas a orquestar agentes

Aquí es donde n8n ha cambiado de liga. Hoy es, de hecho, una de las formas más rápidas de poner un agente de IA en producción:

• AI Agent: un nodo que recibe un objetivo, un modelo (OpenAI, Anthropic, Gemini, modelos abiertos con Ollama…), una memoria y un conjunto de herramientas. Y lo mejor: cualquier nodo o sub-workflow de n8n puede ser una herramienta del agente.
• MCP (Model Context Protocol), en las dos direcciones. Con el nodo MCP Client Tool, tu agente usa las herramientas de un servidor MCP externo. Con el MCP Server Trigger, conviertes tus workflows en herramientas que pueden usar Claude, ChatGPT o tu IDE. Y la propia instancia de n8n puede exponerse como servidor MCP.
• Evaluations: para probar tus agentes con un conjunto de casos y medir si responden bien antes de cambiar un prompt o un modelo. Si vas a producción, esto no es opcional.
• Data tables: tablas dentro de n8n para guardar estado entre ejecuciones sin montar una base de datos aparte.
• n8n Assistant: el asistente que te ayuda a construir workflows y agentes describiéndolos en lenguaje natural.

Si quieres ver un caso real, en este artículo monto un agente de soporte con Gmail, Supabase, OpenAI y Slack. Y si te interesa la teoría detrás, los 17 patrones de arquitecturas agénticas encajan perfectamente con lo que se puede construir con n8n.

Autoalojar n8n en serio

Para trastear, con un contenedor te basta. Para producción, mi configuración mínima es Docker con PostgreSQL:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - WEBHOOK_URL=https://n8n.tudominio.com/
      - GENERIC_TIMEZONE=Europe/Madrid
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:16
    restart: unless-stopped
    environment:
      - POSTGRES_DB=n8n
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:

Tres consejos que me han ahorrado más de un disgusto:

• Guarda la N8N_ENCRYPTION_KEY como oro en paño. Con ella se cifran todas tus credenciales. Si la pierdes, al restaurar un backup tendrás que volver a configurar todas las credenciales una a una.
• No expongas el editor a internet. Fíjate en el 127.0.0.1 del puerto: el editor solo es accesible desde la propia máquina. Para entrar desde fuera, usa una red privada como Tailscale y publica solo los webhooks que necesites. Después de los ciberataques a la refrigeración de los supermercados, creo que no hace falta explicar por qué.
• Cuando crezcas, pasa a queue mode. Con EXECUTIONS_MODE=queue, Redis y varios workers (n8n worker), las ejecuciones se reparten y el editor no se ralentiza aunque tengas cientos de workflows en marcha.

n8n 2.0 y 3.0: lo que tienes que saber antes de actualizar

n8n 2.0 (diciembre de 2025) fue, sobre todo, una versión de seguridad por defecto:

• El código del nodo Code se ejecuta en task runners aislados, y ya no puede leer variables de entorno.
• Nodos peligrosos como Execute Command o Local File Trigger vienen desactivados.
• El interruptor de activar o desactivar se sustituye por Publish/Unpublish.
• El nodo Python pasa a ser Python nativo (con task runners externos), desaparece el nodo Start y se deja de dar soporte a MySQL y MariaDB como base de datos.

n8n 3.0 está en beta desde el 27 de octubre de 2026 y sigue limpiando:

• Solo Docker: deja de soportarse la instalación con npm o npx n8n.
• Fuera nodos antiguos como Function, Function Item, Item Lists, Cron o Interval, con migración a sus sustitutos (Code, Schedule Trigger…).
• Valores por defecto más estrictos, como un timeout de 60 segundos en los task runners o los paquetes de la comunidad no verificados desactivados.

Mi recomendación: antes de actualizar, ejecuta el informe de migración que te dice qué workflows se van a ver afectados, y espera a la versión estable si lo tienes en producción.

¿Cuánto cuesta?

• Autoalojado (Community Edition): gratis, sin límite de workflows ni de ejecuciones. Pagas tu servidor.
• En la nube: según la página de precios, Starter desde 20 €/mes (2.500 ejecuciones) y Pro desde 50 €/mes (10.000 ejecuciones), con facturación anual.
• Business (autoalojado con funciones de empresa como SSO, entornos o control de versiones con Git) y Enterprise para organizaciones grandes.

n8n, NiFi, Zapier o Make: ¿cuál uso?

Yo lo resumo así: NiFi para tuberías de datos, n8n para procesos y agentes, y Zapier o Make para lo que un equipo no técnico tiene que montar en una tarde. No compiten tanto como parece.

Cierro con una reflexión

Cuando empecé a usar n8n, lo que me enganchó fue poder automatizar lo aburrido sin pagar por cada paso. Hoy lo que me engancha es otra cosa: es de las pocas herramientas que te permiten pasar de “tengo una idea de agente de IA” a “está en producción, con trazas, con errores controlados y en mi infraestructura” en una tarde.

Conclusión: n8n no es una herramienta de automatización con IA. Es una plataforma de agentes que, además, automatiza. Y eso, créeme, es una diferencia enorme.

Fuentes

• n8n: Documentación oficial, Release notes, v2.0 breaking changes, v3.0 breaking changes y herramienta de migración a 3.0
• n8n: Precios y Sustainable Use License
• GitHub: n8n-io/n8n y releases
• Wikipedia: n8n (historia, licencia y rondas de financiación)