n8n MCP — Conecta Claude a Tu Negocio sin Código
n8n es donde montas agentes para que tu negocio jale solo. El problema: te aventabas a configurarlo todo a mano. Ahora hay un MCP gratis (18k★) que le da a Claude acceso a los 1,505 nodos de n8n. Le pegas la dirección de tu instancia y Claude te arma los agentes él mismo. Aquí los prompts para instalarlo, conectarlo y armar los 3 agentes que cambian un negocio: WhatsApp, correos y llamadas.
Del repo a tu primer agente
Instala · conecta tu n8n · valida · arma los 3 agentes
Empezamos eligiendo el camino de instalación, conectamos tu instancia con dos variables, verificamos que jale, y terminamos con prompts listos para los 3 agentes del video más una librería de prompts pro para sacarle el 100%.
el pain · por qué importa
n8n era libertad — pero te ahogaba en setup
Antes: n8n es la mejor pieza para automatizar tu negocio sin pagar SaaS por todo. Pero abrías la pantalla, veías 1,505 nodos posibles, y no sabías ni cuál arrastrar primero. Te aventabas a configurar credenciales a mano, leer docs, probar, fallar, repetir. Sin programar, te ahogabas.
Ahora: n8n-mcp es un MCP server (gratis, MIT, 18k★ en GitHub) que le da a Claude acceso directo a la documentación de los 1,505 nodos, miles de templates listos, y la API de tu instancia. Le explicas a Claude qué quieres en español, y él busca el template, valida la configuración, arma el workflow y te lo deja listo para que tú lo prendas.
Antes
Drag & drop a ciegas
Buscabas el nodo correcto entre 1,505. Probabas configuraciones. Algo fallaba en producción y no sabías por qué.
Después
Lo describes, Claude lo arma
Le explicas el agente que necesitas. Claude busca templates, elige nodos, valida y te entrega un workflow corriendo.
Costo real
Cero por el conector
n8n-mcp es MIT. La versión hosted te da 100 llamadas al día gratis. Self-host es 100% libre. Solo pagas tu plan de Claude.
Quién lo necesita: cualquiera que ya pagó por n8n (cloud o self-host) y no termina de soltarle el potencial. También quien estaba a punto de pagarle a un freelancer entre $500 y $2,000 dólares por automatización custom — ese gasto se vuelve innecesario para la mayoría de los flujos básicos de negocio.
paso 1 · instala el MCP
Dos caminos: hosted (cero instalación) o self-host
n8n-mcp se distribuye como un MCP server. Tienes dos formas de prenderlo en Claude Code: hosted (cero instalación, te da una API key gratis con 100 llamadas al día — buena para probar) o self-host con npx (corre local, conectado a tu propia instancia de n8n — el camino real para los 3 agentes).
- 1
Elige tu camino
Hosted (cero instalación, dashboard.n8n-mcp.com te da una API key gratis con 100 llamadas al día) o self-host (npx n8n-mcp con tu propia instancia de n8n). Si ya tienes n8n corriendo, ve directo a self-host.
- 2
Genera tu API key
Hosted: regístrate en dashboard.n8n-mcp.com y copia la MCP_API_KEY. Self-host: entra a tu n8n → Settings → n8n API → Create an API key, y guárdala junto con la URL de tu n8n (algo como https://mi-n8n.com/api/v1).
- 3
Pega el bloque MCP en Claude Code
En tu config de MCP servers, pega el snippet de abajo (uno para hosted, otro para self-host). Reinicia Claude Code para que cargue el server.
- 4
Verifica con n8n_health_check
Ejecuta el prompt de verificación más abajo. Claude llama a n8n_health_check y te confirma si la conexión está viva. Si dice OK, ya tienes acceso a 1,505 nodos y a las herramientas de gestión.
Camino A · Hosted
Para probar en 2 minutos sin instalar nada
Regístrate en dashboard.n8n-mcp.com y copia tu MCP_API_KEY. Pega este bloque en tu config de MCP. Las herramientas de gestión (crear/editar workflows reales) requieren una instancia de n8n — para eso pasa al Camino B.
Config MCP hosted (Claude Code)
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": ["n8n-mcp"],
"env": {
"MCP_API_KEY": "tu-api-key-del-dashboard"
}
}
}
}Camino B · Self-host con prompt
Para los 3 agentes del video — necesita tu n8n
Si ya tienes n8n corriendo (cloud o self-host), pasa este prompt a Claude Code y deja que él agregue el MCP, te pida las dos variables (URL del API y API key), y verifique la conexión. Si prefieres a mano, abajo está el comando crudo y el bloque JSON.
Instala n8n-mcp por mí
Pégalo en Claude Code. Él te guía con las preguntas exactas y verifica al final.
Quiero instalar el MCP de n8n-mcp (github.com/czlonkowski/n8n-mcp) en este Claude Code. Hazlo por mí: 1. Agrega n8n-mcp a mi configuración MCP usando `claude mcp add` con el comando `npx n8n-mcp`. 2. Pídeme las dos variables que necesita: N8N_API_URL (la URL del API de mi n8n, normalmente https://mi-n8n.com/api/v1) y N8N_API_KEY (la genero en n8n → Settings → API). 3. Mete esas variables como env del MCP server. 4. Cuando termines, llama a la herramienta n8n_health_check para confirmar que la conexión jala. 5. Si falla, dime exactamente qué pedirle a n8n para arreglarlo. No toques workflows reales todavía. Solo conexión.
Comando manual (correr una vez para probar)
npx n8n-mcpConfig MCP self-host (Claude Code)
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": ["n8n-mcp"],
"env": {
"N8N_API_URL": "https://tu-n8n.com/api/v1",
"N8N_API_KEY": "tu-api-key-de-n8n"
}
}
}
}Tip: si nunca habías agregado un MCP server a Claude Code, también te jala con claude mcp add n8n-mcp -- npx n8n-mcp. El prompt de arriba se encarga de eso por ti.
paso 2 · conecta tu n8n
Dos variables y un prompt para verificar
El MCP necesita saber dónde vive tu n8n y con qué llave entra. Eso es todo. Si ya pegaste el bloque de self-host, las dos variables van como env dentro del MCP server. Si todavía no las tienes, sácalas así:
N8N_API_URL
La URL del API de tu instancia. Casi siempre termina en /api/v1.
De dónde sale: Tu URL base de n8n + /api/v1 — ej. https://mi-n8n.com/api/v1
N8N_API_KEY
Token que usa el MCP para llamar a tu n8n.
De dónde sale: n8n → Settings → n8n API → Create an API key. Cópiala una vez, no se vuelve a mostrar.
MCP_API_KEY (opcional)
Solo para el camino hosted. Te la da el dashboard.
De dónde sale: dashboard.n8n-mcp.com → tu cuenta → API key.
Una vez pegadas, reinicia Claude Code para que cargue el MCP. Luego corre este prompt — Claude llama a n8n_health_check y te dice si jaló o si hay algo que arreglar.
Verifica que la conexión jala
Confirma versión de n8n, workflows activos y problemas de credenciales antes de empezar a construir.
Usa la herramienta n8n_health_check del MCP de n8n-mcp y dime: - Si la conexión con mi instancia de n8n está viva. - La versión de n8n que estoy corriendo. - Cuántos workflows tengo activos vs inactivos. - Si hay algún error de credenciales que deba arreglar antes de empezar a construir. Si todo está bien, dame luz verde y propón qué workflow armar primero.
Si falla: el 90% de las veces es uno de tres errores — URL sin /api/v1, API key copiada con espacios o tu n8n no expone el API público (revisa la variable de entorno N8N_PUBLIC_API_DISABLED en tu n8n). Pídele a Claude que diagnostique con el output del health check.
paso 3 · arma los 3 agentes
WhatsApp, correos y llamadas — el fin de semana
Estos son los tres agentes del video. Cada prompt es self-contained: lo pegas en Claude Code (con n8n-mcp ya instalado y conectado) y Claude busca templates, arma el workflow, lo valida y te lo deja en draft. Tú lo prendes cuando estés listo.
Importante: las credenciales (token de WhatsApp, password de Gmail, llaves de Twilio) las metes tú directo en n8n → Credentials. Claude solo las referencia por ID — nunca las pegues en el prompt.
Agente 1 — Recepcionista de WhatsApp 24/7
Recibe el mensaje, detecta intención, agenda en tu calendario y te manda resumen al final del día.
Necesito un agente en n8n que conteste WhatsApp por mí mientras duermo. Arma este workflow: Trigger: - Webhook entrante de WhatsApp (WhatsApp Business o Twilio, lo que tenga template). Lógica: 1. Recibe el mensaje del cliente. 2. Detecta intención: agendar cita, pedir información, queja, otro. 3. Si es agendar cita → revisa mi Google Calendar, propone tres horarios libres y confirma con el cliente. 4. Si pide información → responde con las preguntas frecuentes que te paso (te las daré en el siguiente mensaje). 5. Si es queja u otro → marca el mensaje como pendiente y avisa por correo. Cierre del día: - A las 9 PM, manda un correo resumen: cuántos mensajes contestó, cuántas citas agendó, cuáles quedaron pendientes. Antes de crear el workflow: 1. Llama a search_templates con searchMode: 'by_nodes' y nodeTypes: ['n8n-nodes-base.whatsApp', 'n8n-nodes-base.googleCalendar'] para ver si hay un template que arrancarle. 2. Después arma el workflow con n8n_create_workflow. 3. Valídalo con validate_workflow antes de activarlo. 4. NO lo actives todavía. Déjamelo en draft para que yo lo prenda.
Agente 2 — Ordenador de Gmail
Cada 15 minutos clasifica tus correos: importantes a la bandeja, presupuestos a Drive, ruido al archivo.
Necesito un agente que ordene mi bandeja de Gmail solo. Arma este workflow: Trigger: - Cada 15 minutos, revisa correos nuevos en Gmail. Reglas de clasificación: 1. Correos de clientes que ya me compraron → etiqueta "clientes" + bandeja principal. 2. Correos con la palabra "presupuesto", "cotización" o "factura" → mueve a la carpeta de Drive "Cotizaciones por revisar" + etiqueta "presupuestos". 3. Newsletters, promociones, notificaciones automáticas → archivar y aplicar etiqueta "ruido". 4. Correos donde mi nombre aparece en el cuerpo (no solo en CC) → marcar como importante y dejar en bandeja principal. 5. Cualquier otro caso → dejar en bandeja sin tocar. Antes de armar: 1. Llama a search_templates con query: 'gmail filter classify' para reusar lógica existente. 2. Arma con n8n_create_workflow y valida con validate_workflow. 3. Pruébalo en modo dry-run primero — quiero ver qué haría con los últimos 10 correos antes de activarlo. NO actives nada hasta que yo confirme las reglas.
Agente 3 — Recepcionista de llamadas
Contesta la llamada con voz, agenda en tu calendario y manda el resumen transcrito al chat de tu equipo.
Necesito un agente que conteste las llamadas de mi negocio 24/7 como si fuera una recepcionista. Arma este workflow: Trigger: - Llamada entrante vía Twilio (o el provider de voz que tengas template). Flujo de la llamada: 1. Saludo grabado con mi nombre de negocio. 2. Voz del agente (ElevenLabs o el TTS que tenga node) pregunta el motivo de la llamada. 3. Si quiere agendar → consulta Google Calendar, ofrece tres horarios y confirma. 4. Si quiere información de productos/servicios → responde con el catálogo que te paso después. 5. Si es urgencia → escala: marca a mi celular y manda mensaje al chat con la transcripción. Cierre: - Transcribe la llamada completa. - Manda un resumen al chat de Slack del negocio (canal #recepcion) con: nombre del cliente si lo dio, motivo, próximo paso, transcripción adjunta. Antes de crear: 1. Llama a search_templates con searchMode: 'by_nodes' y nodeTypes: ['n8n-nodes-base.twilio', 'n8n-nodes-base.slack']. 2. Si encuentras un template parecido, úsalo como base. 3. Arma con n8n_create_workflow y valida con validate_workflow. 4. NO actives ni metas mis credenciales de Twilio todavía. Déjame el workflow listo y dime exactamente qué credenciales tengo que crear y dónde.
Cómo correrlos en orden: uno por uno, no los tres a la vez. Pega el prompt → espera el plan de Claude → revisa el workflow en n8n → activa cuando estés contento. Si algo se ve raro, pídele que use n8n_test_workflow antes de meter producción.
paso 4 · sácale el 100%
Prompts pro — toda la caja de herramientas
Los 3 agentes son la entrada. Pero el MCP expone 20 herramientas en total (7 core + 13 de gestión). Estos prompts cubren los movimientos que más sirven después: buscar templates, auditar tu instancia, modificar workflows sin romper nada, probar antes de prender, y arreglar errores en automático.
Busca templates antes de armar desde cero
n8n tiene miles de templates. Empieza siempre por aquí — ahorra horas de configuración.
Antes de armar cualquier workflow desde cero, busca templates existentes en n8n. Tienen miles disponibles.
Usa search_templates con estos modos según lo que busque:
- Por tarea: { searchMode: 'by_task', task: 'webhook_processing' }
- Por complejidad para principiantes: { searchMode: 'by_metadata', complexity: 'simple', maxSetupMinutes: 30 }
- Por nodos específicos: { searchMode: 'by_nodes', nodeTypes: ['n8n-nodes-base.slack'] }
- Por texto libre: { query: 'whatsapp recordatorio cita' }
Cuando encuentres uno bueno, llama a get_template con mode: 'full' para ver el JSON completo. Si me lo quieres deployar directo, usa n8n_deploy_template — pero antes pásame el resumen de qué hace y qué nodos usa.Audita mi instancia de n8n
Reporte de seguridad y deuda técnica: webhooks expuestos, credenciales con permisos amplios, workflows zombi.
Audita mi instancia de n8n con la herramienta n8n_audit_instance del MCP. Quiero un reporte que cubra: 1. Workflows expuestos al internet sin autenticación. 2. Credenciales con permisos más amplios de lo necesario. 3. Workflows que no se han ejecutado en más de 30 días (candidatos a archivar). 4. Errores recurrentes en los últimos 7 días que valga la pena arreglar. 5. Nodos deprecated que debería migrar a su versión nueva. Dame el reporte en orden de severidad: crítico → recomendado → opcional. Por cada hallazgo, propón el fix concreto pero NO lo apliques. Solo dime qué tocarías y qué riesgo tiene.
Actualiza un workflow sin romperlo
Diff-based update. No rearma todo — solo aplica los cambios que pides. Token-efficient y seguro.
Quiero modificar el workflow con id {WORKFLOW_ID} sin tirar todo y rearmarlo. Usa n8n_update_partial_workflow con operaciones diff:
Cambios que necesito:
1. {Describe el cambio: ej. "agregar un nodo IF después del webhook que filtre por país"}
2. {Otro cambio: ej. "actualizar las credenciales del nodo de Slack"}
3. Limpia conexiones huérfanas si quedan.
Antes de aplicar:
1. Llama a n8n_get_workflow con mode: 'structure' para ver el estado actual.
2. Pasa el plan de operaciones (addNode, updateNode, addConnection, removeConnection, cleanStaleConnections) y muéstramelo antes de ejecutar.
3. Después de aplicar, valida con n8n_validate_workflow para confirmar que sigue corriendo.
Si el workflow está activo en producción, AVÍSAME antes de tocar nada.Prueba un workflow antes de activarlo
Ejecuta en modo test con datos dummy. Te muestra el output de cada nodo para que veas dónde rompe.
Quiero probar el workflow con id {WORKFLOW_ID} sin meterlo a producción. Usa n8n_test_workflow:
1. Si es un webhook → mándale un payload de prueba que yo te pase.
2. Si es un trigger manual → ejecútalo con datos dummy.
3. Si tiene chat trigger → manda 3 mensajes de prueba que cubran los casos: feliz, edge case, error esperado.
Después de la corrida:
- Muéstrame el output de cada nodo en orden.
- Marca en rojo los nodos que fallaron.
- Si algo falló, propón el fix con n8n_autofix_workflow pero NO lo apliques.Arregla errores en automático
Cuando algo rompe, autofix sugiere los cambios. Tú apruebas uno por uno antes de aplicar.
Mi workflow {WORKFLOW_ID} está rompiendo. Usa n8n_autofix_workflow para diagnosticar y proponer fixes automáticos.
Antes de aplicar el fix:
1. Muéstrame el diagnóstico: qué nodo falla, qué espera vs qué recibe.
2. Lista los fixes que el autofix sugiere, cada uno con su impacto.
3. Espera mi OK por cada fix antes de aplicarlo. NO apliques todo de una.
4. Después de cada fix, vuelve a validar con n8n_validate_workflow.7 herramientas core
Funcionan sin tu n8n
Documentación, búsqueda de nodos, validación, templates. Sirven aunque solo uses el camino hosted.
tools_documentation
Documentación de cualquier herramienta del MCP. Empieza aquí cuando no sepas qué hace algo.
search_nodes
Búsqueda full-text en los 1,505 nodos. Filtra por 'verified' o 'community' y pide ejemplos.
get_node
Detalle de un nodo: propiedades, modos, versiones. Usa detail: 'minimal' / 'standard' / 'full'.
validate_node
Valida la configuración de un nodo antes de meterlo al workflow. Modos minimal o full.
validate_workflow
Valida un workflow completo y devuelve errores con sugerencias de fix.
search_templates
Busca entre miles de templates por tarea, nodos, complejidad o texto libre. Úsalo SIEMPRE antes de armar desde cero.
get_template
Trae el JSON completo de un template. Modos: nodes_only, structure, full.
13 herramientas de gestión
Necesitan tu n8n
Crear, editar, probar, auditar y desplegar workflows reales. Aquí es donde Claude se vuelve tu segundo par de manos.
n8n_create_workflow
Crea un workflow nuevo en tu instancia de n8n.
n8n_get_workflow
Trae un workflow existente. Modos: full, details, structure, minimal.
n8n_update_partial_workflow
Update por diffs — token-efficient, no rearma todo.
n8n_validate_workflow
Valida un workflow por id ya en n8n.
n8n_autofix_workflow
Sugiere fixes automáticos para errores comunes.
n8n_test_workflow
Ejecuta el workflow en modo test (webhook, form o chat).
n8n_executions
Lista, consulta y limpia ejecuciones pasadas.
n8n_manage_credentials
CRUD de credenciales y schemas. NUNCA pegues secretos en el prompt — usa el flow del MCP.
n8n_health_check
Verifica conectividad con tu instancia.
n8n_audit_instance
Auditoría de seguridad y deuda técnica de tu n8n.
n8n_deploy_template
Deploya un template de n8n.io directo a tu instancia.
n8n_workflow_versions
Historial y rollback de versiones.
n8n_delete_workflow
Borra un workflow. Pídele a Claude que confirme antes.
paso 5 · no te quemes
Las llaves tú las metes — y otras 4 reglas
El MCP está bien diseñado pero es solo un puente. La seguridad de tus workflows depende de cómo los configures. Estas son las reglas que el repo recomienda y que te van a ahorrar dolores de cabeza.
Tú metes las credenciales, Claude no
API keys, tokens de WhatsApp, contraseñas SMTP, llaves de Twilio — nunca las pegues en el prompt. Créalas en n8n → Credentials, y deja que el MCP las referencie por ID.
No editar workflows en producción directo con IA
Es la regla #1 del repo. Trabaja en un workflow draft, valídalo con validate_workflow + n8n_test_workflow, y cuando esté limpio, hasta entonces lo activas tú a mano.
Webhooks públicos van detrás de un secreto
Cualquier webhook expuesto al internet debe pedir un header secreto o estar detrás de un nodo IF que lo valide. Si no, cualquiera puede dispararlo.
Audita antes de prender más cosas
Corre n8n_audit_instance una vez al mes. Revisa workflows abandonados, credenciales con permisos amplios y nodos deprecated. Limpia antes de crecer.
Backup periódico de tu n8n
El MCP no respalda nada por ti. Si self-hosteas, configura snapshots de la base de datos. Si usas n8n Cloud, exporta los workflows críticos cada semana.
Lectura recomendada: el repo tiene un SECURITY_HARDENING.md con la guía completa para self-hosters. Si vas a meter el MCP a producción, dale una pasada.
Guía de la comunidad
n8n-mcp convierte a Claude en tu segundo par de manos para automatizar tu negocio. Esta guía es parte de la bóveda de tododeia, una colección libre de recursos para quienes usan Claude todos los días. El repo original está en github.com/czlonkowski/n8n-mcp.
APIs, MCPs y A2A
Qué es un MCP y por qué importa
WhatsApp AgentKit
El otro camino para WhatsApp
Planea, Audita, Construye
Cómo auditar lo que Claude propone
¿Para quién no es n8n-mcp?
Si nunca has tocado n8n y no quieres montarlo, el camino hosted te deja explorar pero no construir agentes reales. Para los 3 agentes del video (WhatsApp, correos, llamadas) sí necesitas una instancia de n8n. La buena: n8n Cloud arranca gratis para flujos chicos, y self-host con Docker en una VPS de cinco dólares te da capacidad de sobra para el primer año.