Ivona Mikulčić5 de septiembre de 202610 min de lecturaActualizado: 28 sept 2026
n8n Debugger: corrige errores de flujos en menos de 2 minutos con Claude AI (sin API key)
La semana pasada, uno de los flujos de enriquecimiento de leads de nuestro equipo se rompió a mitad de ejecución. Sin notificación de error, sin ping en Slack. Solo más de 400 leads en cola, sin enriquecer, durante seis horas antes de que alguien se diera cuenta. ¿El culpable? Una sola expresión que referenciaba un campo renombrado más arriba en el flujo. Seis horas de pipeline muerto por un error tipográfico.
Si gestionas flujos de trabajo en n8n que alimentan tu CRM o disparan secuencias de outbound, ya pasaste por esto. En este artículo te muestro exactamente cómo depurar errores de flujos de n8n rápido, usando tanto las herramientas nativas de n8n como el lemlist n8n-debugger Claude Skill, que lee tu error (o una captura de pantalla de tu canvas roto) y devuelve un diagnóstico con la solución. Sin código. Sin buscar entre documentación. También quiero verificar que el enlace a la documentación de n8n y la documentación propia de n8n sobre errores de flujos estén correctamente citados. Ya tengo lo que necesito. Ahora voy a compilar el artículo completo actualizado.
Qué es el n8n debugger y por qué los errores de flujos frenan tu pipeline
"n8n debugger" suele referirse a dos cosas distintas: las herramientas nativas de n8n para rastrear una ejecución fallida, y el lemlist n8n-debugger, un Claude Skill que lee tu error y te explica qué se rompió y cómo arreglarlo. Ambos te ayudan a encontrar la causa de una ejecución fallida. Solo operan a niveles diferentes.
Cuando un flujo de n8n lanza un error a mitad de ejecución, todo lo que está después de ese nodo se detiene. Si ese flujo alimenta tu CRM o dispara una secuencia de outbound, el fallo es un pipeline paralizado, y cada minuto que pasa roto es un minuto en que tus leads no avanzan. Como dice la documentación de n8n, las ejecuciones de flujos pueden fallar por razones que van desde nodos mal configurados hasta errores misteriosos de servicios externos.
Las herramientas nativas de n8n (que cubrimos más abajo) te muestran dónde ocurrió el fallo: qué nodo, qué datos. No siempre te dicen por qué ocurrió ni qué cambiar. Esa es la brecha que cierra el Claude Skill n8n-debugger.
Cómo el Claude Skill lemlist n8n-debugger corrige errores a partir de mensajes y capturas de pantalla
El lemlist n8n-debugger es un Claude Skill: un conjunto de instrucciones que agregas a un proyecto de Claude Desktop para indicarle a Claude cómo manejar una tarea específica. En este caso, esa tarea es leer un error de n8n y devolver un diagnóstico con la solución.
Pega un mensaje de error y obtén un diagnóstico
Copia el texto rojo del error desde el panel de ejecución de n8n y pégalo en Claude con el Skill activo. Claude identifica el tipo de error y el nodo que falló, normalmente en segundos. Si el error es ambiguo, hará una pregunta aclaratoria antes de diagnosticar.
Sube una captura de pantalla de un flujo roto
A veces una captura de pantalla dice más que un muro de texto, sobre todo cuando el problema está en cómo se conectan los nodos en el canvas. Sube una captura de la ejecución fallida, y Claude usa visión para leer los nombres de los nodos, las insignias de error y las líneas de conexión para localizar el problema.
Recibe instrucciones paso a paso para la solución
Después del diagnóstico, Claude devuelve pasos numerados:
Qué nodo abrir
Qué campo cambiar
Qué expresión reescribir
Cómo evitar el mismo error la próxima vez
Así no pierdes tiempo resolviendo lo mismo dos veces.
Qué tipos de errores cubre el Skill
El Skill se activa con errores pegados, capturas de pantalla, o incluso un simple "¿por qué no funciona esto?". Está diseñado para manejar:
Fallos en evaluación de expresiones: referenciar un campo que no existe, o sintaxis rota en una expresión
Errores en solicitudes HTTP: códigos de estado 4xx/5xx, timeouts, URLs mal formadas
Errores de autenticación y credenciales: tokens expirados, claves revocadas, credenciales faltantes
Incompatibilidad de formato de datos: un nodo devuelve un array, el siguiente espera un objeto único
Fallos en triggers de webhook: diferencias entre URLs de prueba y producción, flujos inactivos
Cómo configurar el Claude Skill n8n-debugger en dos minutos
La configuración es rápida. No necesitas API key ni configurar un servidor MCP, a diferencia de otras integraciones de Claude de lemlist.
Paso 1. Abre el Claude Skill en GitHub. Encuentra el archivo SKILL.md en el repositorio de GitHub lemlist claude-skills, junto con un README que cubre los prerrequisitos (principalmente una cuenta Claude Pro o Team con acceso a Projects).
Paso 2. Agrega el Skill a Claude Desktop. Crea un proyecto nuevo (o abre uno existente) y pega el contenido del Skill en el campo Project Instructions. Eso es toda la configuración.
Paso 3. Pega tu primer error de n8n. Copia el error de una ejecución fallida, cambia a Claude y envíalo. Recibirás un diagnóstico de inmediato, o una pregunta rápida de seguimiento si el error necesita más contexto.
Consejo: Agrega el n8n-debugger junto con otros Claude Skills de lemlist en el mismo proyecto. Puedes depurar, corregir, y luego reconstruir un flujo con el Claude Skill n8n Workflow Builder en una sola conversación.
Herramientas nativas de depuración de n8n y dónde se quedan cortas
n8n incluye algunas herramientas para rastrear fallos antes de que abras Claude. Vale la pena saber qué hace realmente cada una.
Historial de ejecuciones y depuración en el editor
n8n registra cada ejecución, con datos de entrada y salida por nodo. La opción Debug in Editor carga una ejecución fallida anterior de vuelta en el canvas, con los nodos exitosos resaltados en verde y los fallidos en rojo, para que veas exactamente dónde se rompió todo. Como describe la documentación de n8n, puedes "hacer cambios en tu flujo para corregirlo, y luego volver a ejecutarlo con los datos de la ejecución anterior".
Data pinning para pruebas repetibles
Data pinning congela la salida de un nodo para que cada re-ejecución manual use la misma entrada, en vez de traer datos nuevos cada vez. Es especialmente útil para flujos activados por webhook, donde no quieres disparar el evento externo repetidamente solo para reproducir un bug.
Logging y el nodo debug helper
En n8n auto-alojado, configurar N8N_LOG_LEVEL=debug te da logs detallados del servidor. También existe un nodo debug helper creado por la comunidad que puedes colocar en medio del flujo para generar logs estructurados en un punto específico. Los usuarios de n8n Cloud no tienen acceso a los logs del servidor, así que están limitados a lo que muestra el panel de ejecución.
El plugin propio de Claude Skills de n8n
Dato importante: n8n ahora incluye su propio plugin oficial de Claude Skills a través del repositorio n8n-io/skills en GitHub. Incluye 13 skills de capacidades que cubren todo el ciclo de vida de un flujo de trabajo (expresiones, manejo de errores, depuración, y más) y se conecta directamente a tu instancia de n8n mediante un servidor MCP a nivel de instancia. Es una opción sólida si quieres que tu agente de código construya y edite flujos con buenas prácticas integradas.
La diferencia: el n8n-debugger de lemlist funciona a partir de errores pegados o capturas de pantalla, sin ninguna conexión a tu instancia. No necesitas configurar MCP, y no necesitas exponer tu instancia de n8n. El plugin de n8n requiere configuración MCP a nivel de instancia y está diseñado para construir flujos completos, no solo diagnosticar uno roto a partir de un mensaje de error.
La brecha que dejan las herramientas nativas
Todas las herramientas anteriores te muestran los datos en bruto en el punto de fallo. Ninguna te explica qué significa el error ni qué cambiar. Tú sigues siendo quien interpreta el JSON, revisa la documentación de la API y prueba soluciones por ensayo y error, que es exactamente el trabajo que el Skill n8n-debugger te quita de encima.
Los errores más comunes en flujos de n8n y cómo corregir cada uno
La mayoría de los errores en n8n se reducen a un puñado de sospechosos habituales. Esto es lo primero que reviso en cada caso.
Fallos de autenticación y credenciales
Normalmente aparece como "401 Unauthorized". Abre el gestor de credenciales, vuelve a autenticarte y verifica la ventana de expiración del token. Las conexiones OAuth suelen necesitar reautorización periódica, y es fácil olvidarlo.
Errores de expresión y campos indefinidos
Algo como Cannot read property 'email' of undefined significa que la salida del nodo anterior no coincide con lo que tu expresión espera. Abre el editor de expresiones, haz clic en la salida real del nodo referenciado y reescribe la expresión para que coincida.
Configuración incorrecta de webhooks
n8n genera URLs separadas para modo de prueba y modo de producción. Si registraste la URL de prueba externamente y luego activaste el flujo, la URL de producción es diferente, y el webhook falla en silencio. Siempre toma la URL de producción después de activar.
Errores de rate limit y timeout
Una respuesta 429 o 504 significa que la API externa está recibiendo peticiones demasiado rápido. Agrega un nodo Wait entre llamadas o reduce el tamaño del lote en un nodo Split In Batches.
Incompatibilidad de formato de datos entre nodos
Un nodo devuelve un array, el siguiente espera un objeto único. Un nodo Set o Function puede transformar los datos en el medio.
Tipo de error | Mensaje típico | Qué revisar primero |
|---|---|---|
Fallo de autenticación | "401 Unauthorized" | Volver a autenticar la credencial |
Campo indefinido | "Cannot read property 'X' of undefined" | Inspeccionar la salida del nodo anterior |
Webhook no coincide | "Workflow could not be started" | Comparar URLs de prueba vs. producción |
Rate limit | "429 Too Many Requests" | Agregar un nodo Wait o reducir el tamaño del lote |
Incompatibilidad de formato | "Expected object, received array" | Transformar con un nodo Set o Function |
Depuración con IA vs. inspección manual de nodos
La depuración manual implica hacer clic nodo por nodo en las salidas, leer JSON en bruto y buscar en foros una respuesta que aplique. La depuración con IA implica pegar el error y recibir una explicación estructurada en segundos.
Factor | Inspección manual | Depuración con IA |
|---|---|---|
Velocidad | Depende de la complejidad del flujo | Diagnóstico en segundos |
Conocimiento requerido | JSON, respuestas de API, expresiones de n8n | Entrada y salida en lenguaje natural |
Causa raíz | Tú interpretas los datos | Claude identifica la causa probable |
Guía de solución | Documentación y foros | Pasos específicos para tu error |
Capturas de pantalla | No aplica | Claude lee el canvas |
Los dos enfoques no compiten entre sí. Yo uso Claude para el diagnóstico, luego fijo los datos problemáticos en n8n con data pinning y vuelvo a ejecutar el flujo para confirmar que la corrección realmente funciona.
Depura flujos de n8n conectados a herramientas de ventas y outreach
n8n es una base común para la automatización de outbound: sincronizar registros del CRM, disparar secuencias, enriquecer leads. Cuando esos flujos se rompen, la actividad del pipeline se detiene con ellos.
Fallos de sincronización con HubSpot y Salesforce
Los problemas de mapeo de campos y propiedades requeridas faltantes son los culpables habituales. Un cambio de permisos en la API ocupa un cercano tercer lugar, pero es más difícil de detectar porque el mensaje de error rara vez dice "permisos" directamente. Las integraciones nativas de lemlist con HubSpot y Salesforce manejan estas sincronizaciones directamente, lo que elimina a n8n como punto intermedio de fallo.
Errores de webhook en secuencias de outreach
Las herramientas de outreach suelen activar flujos de n8n por webhook, y los fallos más comunes son una URL que cambió después de un redeploy y una incompatibilidad en el formato del payload. Un flujo silenciosamente inactivo es otro clásico, sobre todo cuando alguien edita el canvas y se olvida de reactivarlo. La API de lemlist y la conexión lemlist MCP son gestionadas en lugar de manuales, lo que reduce esta categoría de errores. El servidor MCP de lemlist expone más de 40 acciones (lemlist MCP | Conecta agentes de IA con outreach de ventas y datos de leads) que cubren búsqueda de leads, enriquecimiento, creación de secuencias y gestión de campañas, así que hay menos razón para armar una cadena de webhooks improvisada.
Problemas de credenciales de API con proveedores de enriquecimiento
Cuando n8n llama a APIs de enriquecimiento para obtener emails verificados o números de teléfono, una clave expirada o un endpoint modificado causa un fallo silencioso. lemlist agrupa el enriquecimiento de múltiples proveedores en una sola plataforma, así que hay menos credenciales externas que vigilar dentro de n8n.
Tu turno
Cada minuto que pasas depurando un flujo de n8n roto es un minuto que no estás hablando con prospectos. Guarda el Skill n8n-debugger para diagnósticos rápidos, combínalo con las herramientas nativas de n8n para tener el panorama completo, y evalúa si algunas de tus cadenas en n8n podrían simplemente reemplazarse por una plataforma diseñada para outbound de punta a punta.
Explora la biblioteca completa de Claude Skills de lemlist para ver qué más puedes agregar a tu flujo de trabajo.
Comienza una prueba gratis de 14 días para gestionar outbound con entregabilidad, enriquecimiento y secuencias multicanal integradas. Sin tarjeta de crédito, cancela cuando quieras.
Lanza campañas outbound con IA
Automatiza tu prospección y personaliza secuencias con IA para conseguir más reuniones.