01 Qué es y qué aporta
n8n es una plataforma de automatización con miles de nodos: Gmail, Google Sheets, CRM, WhatsApp, modelos de IA, peticiones HTTP… Su punto débil es la curva de entrada: encontrar el nodo correcto, configurar todos sus parámetros y entender por qué falla un flujo lleva tiempo.
n8n-MCP es un servidor MCP con licencia MIT que pone ese conocimiento a disposición de Claude. Sin conexión a tu instancia, Claude puede consultar la documentación y las propiedades de cada nodo, buscar plantillas y validar configuraciones. Con la API de tu n8n configurada, además crea flujos, los actualiza, los prueba y revisa sus ejecuciones.
| Modo | Qué puede hacer Claude | Qué necesitas |
|---|---|---|
| Solo documentación | Buscar nodos y plantillas, explicar parámetros, validar un flujo en JSON | Nada más que Claude Code y npx |
| Con tu instancia | Crear, modificar, validar, probar y auditar flujos y ver ejecuciones | URL de tu n8n y una clave de su API |
| Servicio alojado | Probar sin instalar nada, con un límite diario de llamadas en el plan gratuito | Registrarte en el panel del proyecto |
02 Instalación en Claude Code
-
1
Crea la clave de API en n8n
En tu instancia, entra en Settings, sección n8n API, y genera una clave. Guárdala en tu gestor de contraseñas; no la pegues en el chat.
-
2
Añade el servidor
Ejecuta el comando de abajo en tu terminal sustituyendo la URL y la clave. Si n8n corre en tu ordenador, la URL suele ser http://localhost:5678.
-
3
Comprueba la conexión
Ejecuta claude mcp list fuera de Claude Code o /mcp dentro de una sesión. Debe aparecer n8n-mcp como conectado.
-
4
Haz una prueba de salud
Pide a Claude que ejecute la herramienta n8n_health_check. Si responde correctamente, ya puede trabajar con tu instancia.
claude mcp add n8n-mcp \
-e MCP_MODE=stdio \
-e LOG_LEVEL=error \
-e DISABLE_CONSOLE_OUTPUT=true \
-e N8N_API_URL=https://tu-instancia-n8n.com \
-e N8N_API_KEY=tu-clave-de-api \
-- npx n8n-mcp# dentro de Claude Code
/plugin install czlonkowski/n8n-skillsEstas skills, del mismo autor, enseñan a Claude la sintaxis de expresiones de n8n, patrones de flujo habituales, cómo interpretar errores de validación y cómo escribir nodos de código en JavaScript o Python.
03 El método de trabajo que mejor funciona
Plantillas primero
Antes de construir desde cero, Claude busca entre las plantillas públicas una que se parezca. Ahorra tiempo y parte de algo probado.
Parámetros explícitos
Los valores por defecto son la causa más común de fallos en ejecución. Pide que todos los parámetros relevantes queden configurados a mano.
Validar en capas
Primero cada nodo, luego el flujo completo (conexiones y expresiones) y, tras desplegarlo, otra validación en la instancia.
Crear desactivado
El flujo se crea sin activar. Tú revisas, conectas credenciales y lo pruebas antes de encenderlo.
04 Prompts para casos de negocio
Usa n8n-mcp para diseñar un flujo que lea los correos nuevos de Gmail cada 10 minutos, los clasifique con un modelo de IA en presupuesto, soporte, factura o spam, aplique la etiqueta correspondiente y, si es una petición de presupuesto, añada una fila en la hoja de Google Sheets [nombre] con remitente, asunto, fecha y un resumen de dos líneas.
Busca primero plantillas parecidas. Antes de crear nada, enséñame el esquema de nodos y espera mi aprobación. Configura todos los parámetros explícitamente, valida cada nodo y el flujo completo, y créalo desactivado. Las credenciales las conectaré yo.Necesito un flujo con un webhook que reciba el formulario de contacto de mi web (nombre, correo, teléfono, mensaje, servicio). Debe validar que el correo tiene formato correcto, crear el contacto en [CRM], enviar un mensaje a [canal de Slack o Telegram] con el resumen y responder al webhook con un 200. Si falla la creación en el CRM, guarda los datos en una hoja de respaldo y avísame. Valida y créalo desactivado.Lista mis flujos de n8n y, sin modificar ninguno, revisa los activos: valida cada uno, comprueba las últimas ejecuciones fallidas y ejecuta la auditoría de seguridad de la instancia. Dame un informe con los problemas ordenados por gravedad y una propuesta de solución para cada uno. No apliques cambios.En el flujo [nombre], quiero añadir un paso que [cambio]. Duplica primero el flujo y trabaja sobre la copia. Usa actualizaciones parciales, no reemplaces el flujo entero. Al terminar valida la copia, pruébala con datos de ejemplo y enséñame la diferencia con el original.05 Seguridad y buenas prácticas
- ✓Las credenciales de servicios (Gmail, CRM, WhatsApp) las conectas tú en la interfaz de n8n, no se las dictes a Claude.
- ✓Guarda la clave de la API de n8n en la configuración del servidor MCP; no la subas a un repositorio. Si compartes la configuración con --scope project, usa una clave distinta y con un uso controlado.
- ✓Usa una instancia o proyecto de pruebas para que Claude experimente.
- ✓Para entornos sensibles, el servidor permite desactivar herramientas de escritura con la variable DISABLED_TOOLS y trabajar en solo lectura.
- ✓Revisa siempre el flujo en el editor visual de n8n antes de activarlo.
- ✓Si usas una plantilla pública, respeta la atribución a su autor.
Preguntas frecuentes
No. n8n-MCP es un proyecto independiente de código abierto. n8n ofrece también su propio servidor MCP a nivel de instancia; n8n-MCP puede conectarse a él para funciones adicionales si configuras su token de acceso.
Sí, con ambos, siempre que la API pública esté disponible y tengas una clave. Si tu n8n está detrás de Cloudflare Access, el servidor admite sus credenciales de servicio.
El servidor es gratuito si lo ejecutas tú con npx o Docker. Existe una versión alojada con un plan gratuito limitado en llamadas diarias. A eso se suma tu plan de Claude y el coste de tu n8n.
Tiene herramientas para hacerlo, por eso conviene trabajar con copias, tener copias de seguridad exportadas y, si te preocupa, desactivar las herramientas destructivas con DISABLED_TOOLS.
No para empezar, pero sí para revisar. Entender qué hace cada nodo te permitirá detectar errores de lógica que ninguna validación automática encuentra.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.