Cómo usar n8n: guía completa

n8n se define a sí mismo como una "plataforma de automatización de flujos de trabajo con IA": permite automatizar procesos de negocio sin límite en la lógica que se puede construir.

Se puede usar de dos formas: en la nube gestionada por n8n, o autoalojado (Docker, on-premise, incluso en un entorno aislado sin conexión a internet) con el código fuente disponible en GitHub. Técnicamente no es "open source" según los criterios de la OSI: usa la Sustainable Use License (basada en la Elastic License 2.0), que n8n llama "fair-code" — el código es abierto y modificable, pero no se puede revender como un SaaS competidor.

Los flujos se construyen de forma visual, sobre un lienzo (canvas) donde cada paso es un nodo — pero se puede bajar a código (JavaScript o Python) en cualquier punto del flujo cuando la lógica visual no basta.

Cada paso del razonamiento de un agente de IA construido en n8n queda trazable en el propio lienzo, no oculto en una caja negra. A efectos de facturación, una "ejecución" es una corrida completa del flujo de principio a fin, sin importar cuántos nodos tenga: un flujo de 30 pasos cuenta igual que uno de 3. Al alcanzar el límite mensual de ejecuciones, los flujos se detienen inmediatamente, sin aviso previo ni margen de gracia.

1. 1. Crear un volumen persistente

   docker volume create n8n_data — conserva las claves de cifrado y los logs entre reinicios.

2. 2. Arrancar el contenedor

   docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n, añadiendo las variables de zona horaria y las de conexión a Postgres si se usa en producción.

3. 3. Acceder a la interfaz

   En http://localhost:5678 tras el primer arranque.

4. 4. Usar Docker Compose para producción

   El propio repositorio de n8n mantiene ficheros de Compose completos con Postgres como base de datos, en vez de la SQLite por defecto de una instalación local rápida.

1. 1. Crear un flujo dedicado a errores

   Con el nodo 'Error Trigger' como primer nodo, guardado con un nombre reconocible (por ejemplo, "Error Handler").

2. 2. Asignarlo como flujo de error del flujo principal

   Desde Options > Settings > "Error workflow" del flujo que quieres proteger.

3. 3. El Error Trigger recibe el contexto completo del fallo

   Mensaje de error, stack trace, último nodo ejecutado, información del flujo, y si fue un reintento (execution.retryOf).

4. 4. Configurar el comportamiento por nodo

   Cada nodo tiene su propia opción "On Error" (detener el flujo, continuar, o continuar usando una salida de error separada) y "Retry On Fail" (número de intentos y espera entre ellos) — pero solo se puede tener un comportamiento activo por nodo a la vez.

• Webhook: tiempo real, cuenta una ejecución por cada solicitud entrante, incluso con el cuerpo vacío.
• Polling (por ejemplo, el disparador de Gmail): revisa en intervalos programados y solo cuenta una ejecución cuando encuentra datos nuevos — una consulta vacía no cuenta como ejecución.
• Schedule Trigger: siete tipos de intervalo (segundos, minutos, horas, días, semanas, meses o cron personalizado de 6 posiciones), con gestión de "si se perdió la ejecución programada" para no duplicar un resumen si el servidor estuvo caído.

El nodo AI Agent de n8n solo funciona hoy como "Tools Agent": requiere obligatoriamente un modelo de chat conectado y al menos una herramienta conectada como subnodo. La memoria es opcional (un subnodo "Simple Memory" es volátil y se pierde al reiniciar, por lo que no es apta para producción; para persistencia real se usan alternativas como Redis).

1. 1. Importar los datos

   Obtener o subir los archivos, preparar los metadatos, y conectar la base de datos vectorial (Pinecone, Qdrant, Supabase, Weaviate, Postgres con PGVector, entre otras).

2. 2. Procesar el contenido

   Dividir en fragmentos (chunking), generar embeddings y almacenarlos.

3. 3. Configurar el agente

   Conectarlo a un modelo de lenguaje (en la nube o local vía Ollama, para mayor privacidad de datos).

4. 4. Añadir capacidad de recuperación y chat

   Para que el agente busque en la base vectorial antes de responder, en vez de depender solo de su conocimiento general.

n8n tiene tres nodos oficiales relacionados con MCP: MCP Client (usa herramientas de un servidor MCP externo como pasos normales del flujo), MCP Client Tool (conecta un servidor MCP externo directamente a un AI Agent como herramienta invocable), y MCP Server Trigger (permite que n8n actúe como servidor MCP, exponiendo sus propios flujos a clientes externos como Claude Desktop). Existe además un proyecto de terceros popular, "n8n-mcp", que no es oficial de n8n, para construir flujos desde un asistente de código.

Además de los nodos oficiales, existen miles de nodos construidos por la comunidad, instalables desde el propio panel de n8n (interfaz gráfica, vía el registro de npm) o manualmente por línea de comandos cuando se necesita un paquete privado o el modo de cola. No existe una cifra oficial única y estable de cuántos nodos de comunidad hay disponibles en un momento dado — cualquier número concreto debe tratarse como aproximado.

Los nodos verificados pasan un proceso de revisión de n8n y son los únicos disponibles también en n8n Cloud; los no verificados solo se pueden instalar en una instancia autoalojada.

Por defecto, n8n almacena las credenciales cifradas en su propia base de datos. Para equipos con requisitos de seguridad más estrictos, la función "External Secrets" permite usar HashiCorp Vault, AWS Secrets Manager o Azure Key Vault: los secretos nunca se guardan en la base de datos de n8n, se cargan solo cuando el flujo los necesita en tiempo de ejecución. Buenas prácticas habituales: aplicar el principio de mínimo privilegio en cada credencial y rotarlas con regularidad.

• Miles de nodos ya construidos para aplicaciones comunes, más nodos de la comunidad instalables desde el propio panel.
• Conexiones a API personalizadas para cualquier servicio sin nodo propio.
• Construcción de agentes de IA complejos: sistemas multiagente y RAG, cambiando de modelo (en la nube o local) sin reconstruir el flujo.
• Código JavaScript o Python en cualquier punto del flujo.
• Nodos MCP Client/MCP Client Tool/MCP Server Trigger para conectar n8n con el ecosistema de agentes vía Model Context Protocol.
• Gestión de secretos externa (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) para no guardar credenciales en la base de datos de n8n.
• Despliegue autoalojado, incluso en entornos aislados sin conexión ('air-gapped').

Precios confirmados en n8n.io/pricing/ el 2026-09-26 — en la nube y autoalojado. Workflows y usuarios son ilimitados en todos los planes de nube; el límite real es el volumen de ejecuciones mensuales.

• Conectar dos aplicaciones que no tienen una integración nativa entre sí.
• Construir un agente de IA que combine varias fuentes de datos (RAG) antes de responder.
• Vigilar una bandeja de entrada de correo y archivar o etiquetar automáticamente los mensajes según su contenido.
• Publicar un resumen periódico en Slack a partir de datos obtenidos de una API externa.
• Automatizar un proceso interno (por ejemplo, dar de alta un cliente en varios sistemas a la vez) sin escribir todo el código a mano.
• Desplegar la automatización en un entorno propio, aislado, por requisitos de seguridad o cumplimiento.

• Combinar mal "Retry On Fail" con el modo "Continue" de un nodo: si el modo de error está en Continue, los reintentos configurados se ignoran y el nodo sigue adelante al primer fallo sin reintentar — solo se puede tener un comportamiento por nodo.
• Confiar en el pruning de historial sin revisar sus variables: por defecto se conservan 14 días o 10.000 ejecuciones (lo que se cumpla antes); las ejecuciones en curso o marcadas con una etiqueta nunca se eliminan automáticamente.
• No revisar si un nodo está deprecado tras una actualización: n8n distingue nodos retirados (dejan de funcionar), deprecados (siguen funcionando pero sin actualizaciones) y versionados (una nueva versión por defecto, sin afectar a los flujos ya construidos con la versión anterior).
• Riesgo de bucles infinitos: un webhook que se dispara a sí mismo, o un flujo de manejo de errores que reintenta indefinidamente, puede agotar créditos de API o de IA antes de detectarse — conviene revisar siempre un flujo autogenerado antes de activarlo en producción.
• Superar el límite de payload de un webhook: 16 MB por defecto (configurable en autoalojado).
• Subestimar la curva de aprendizaje: construir la lógica de mapeo de datos y expresiones lleva más tiempo las primeras semanas que en herramientas más simples como Zapier o Make, a cambio de mayor capacidad; en autoalojado, además, hay que asumir el mantenimiento del servidor.

• No es "open source" en sentido estricto (según criterios OSI): la Sustainable Use License restringe el uso comercial como SaaS competidor, aunque el código sea abierto y modificable.
• Los nodos de la comunidad no verificados solo están disponibles en instalaciones autoalojadas, no en n8n Cloud.
• El AI Agent node solo opera como "Tools Agent" hoy — otros tipos como Conversational Agent o SQL Agent ya no están disponibles.
• La memoria por defecto del agente ("Simple Memory") es volátil y se pierde al reiniciar — no apta para producción sin una alternativa persistente.