comunidadbóvedan8n + Claude

n8n + Claude: describe la automatización, deja que Claude arme el workflow

Montar una automatización en n8n a mano puede tomarte una tarde entera de arrastrar nodos. Con el MCP, le describes a Claude lo que quieres y te devuelve el workflow listo para importar. Aquí te enseñamos las dos capas reales y oficiales que lo hacen posible, cómo conectarlas dándole prompts a Claude Code (no volcando comandos), y te dejamos los prompts maestros y un system prompt que convierte a Claude en tu ingeniero de n8n. Aunque no programes.

De un vistazo

01

Describe la automatización en español

02

Claude arma el JSON con nodos reales

03

Lo importas en n8n con un clic

04

Conectas credenciales a mano

05

Corres prueba y activas

las dos capas · setup · el flujo · prompts · system prompt · faq

Dos capas reales, un mismo objetivo: automatizar describiendo, no arrastrando

Esto no es magia ni un truco no oficial. Son dos conexiones reales: el MCP nativo que n8n trae de fábrica (incluso en el plan gratis) y el servidor de comunidad n8n-mcp, que ya está en el registro oficial de MCP de Anthropic y le da a Claude conocimiento profundo de los 1,851 nodos de n8n. Juntos, dejan que le describas una automatización en lenguaje natural y Claude te devuelva un workflow correcto, validado e importable. Te explicamos cada capa desde cero, te damos los prompts para que Claude Code haga el setup por ti, y cerramos con un system prompt que convierte a Claude en tu ingeniero de n8n de cabecera.

MCP nativo oficial + registro de Anthropicn8n Community gratis1,851 nodos · 2,352 templatesPrompts para Claude CodeAunque no programes

la promesa · de un vistazo

Describir en español, obtener un workflow que corre

La idea es simple y, esta vez, real: en lugar de abrir n8n y arrastrar nodos uno por uno, le describes a Claude la automatización que quieres, y él te devuelve el workflow listo para importar. El camino completo son cinco pasos:

  1. 1. Describes la automatización en lenguaje natural.
  2. 2. Claude genera el JSON del workflow con los nombres reales de los nodos.
  3. 3. Lo importas en n8n (o Claude lo despliega por API).
  4. 4. Conectas las credenciales a mano (este paso es tuyo, no de Claude).
  5. 5. Corres una prueba y, si pasa, lo activas.

Detrás de esa promesa hay dos capas reales y oficiales, no un truco. La primera es el MCP que n8n trae de fábrica. La segunda es un servidor de comunidad ya listado en el registro oficial de MCP de Anthropic, que le da a Claude conocimiento profundo de los nodos de n8n. Las vemos por separado.

cómo funciona de verdad

Las dos capas, sin humo

Mucha gente mezcla estas dos cosas. Aquí van separadas, porque resuelven problemas distintos y a veces se usan juntas.

A

MCP nativo oficial de n8n

Qué es: n8n 2.x trae soporte MCP de fábrica, en todos los planes (incluido Community, que es gratis). Son dos nodos: el MCP Server Trigger hace que tu n8n actúe como servidor MCP y exponga tus workflows como herramientas para Claude y otros clientes; el MCP Client Tool hace lo contrario, deja que un workflow consuma un servidor MCP externo como un paso más.

Cuándo usarla: Úsalo cuando quieras que Claude (u otro cliente MCP) dispare o use tus propios workflows como herramientas, o cuando un workflow necesite llamar a otra herramienta MCP dentro de su lógica.

  • · MCP Server Trigger: tu n8n EXPONE workflows a Claude.
  • · MCP Client Tool: tu workflow CONSUME un MCP externo como paso.
  • · Es la conexión oficial de n8n, incluida sin costo extra.
B

n8n-mcp: el cerebro de nodos (en el registro de Anthropic)

Qué es: Un servidor MCP de la comunidad (de czlonkowski) que ya está en el registro oficial de MCP de Anthropic, con más de 21 mil estrellas en GitHub, licencia MIT y escrito en TypeScript. Le da a Claude conocimiento profundo de n8n: alrededor de 1,851 nodos (822 del core y 1,029 de comunidad) con sus esquemas, unos 2,352 templates de workflow con metadata, validación de nodos, y la capacidad de crear, desplegar y actualizar workflows en TU instancia vía la API de n8n.

Cuándo usarla: Úsalo cuando quieras que Claude GENERE workflows correctos por ti: él conoce los nombres y esquemas reales de los nodos, así que el JSON que produce sí se importa sin romperse. Es el cerebro que hace posible 'describir y obtener un workflow'.

  • · ~1,851 nodos con esquema · ~2,352 templates con metadata.
  • · Valida nodos y puede desplegar a tu instancia por API.
  • · Modo solo-documentación: conocimiento de nodos sin instancia.

En corto: la capa nativa (A) sirve para que Claude use tus workflows o para que un workflow llame a otra herramienta MCP. La capa n8n-mcp (B) es la que hace que Claude genere workflows correctos. Para “describir y obtener una automatización”, la estrella es la B. La mayoría de esta guía gira alrededor de ella.

conectar Claude a n8n

Setup prompt-first: deja que Claude Code lo configure

No vas a pelear con la terminal. El setup se hace de la forma más cómoda: le pegas a Claude Code un prompt, él te pregunta tus dos datos y deja la configuración lista. Los dos datos son:

  • N8N_API_URL — la dirección de tu instancia. Si usas cloud, es tu URL de n8n.io; si autohospedas (Community Edition, gratis), suele ser algo como http://localhost:5678.
  • N8N_API_KEY — la llave que generas en n8n, en Settings > n8n API > Create an API key. Es un secreto: que no termine en git.

¿No tienes instancia todavía? No pasa nada: dile a Claude que lo configure en modo solo-documentación (sin esas dos variables). Igual conocerá los ~1,851 nodos y podrá generarte el JSON; lo único que no podrá es desplegar ni validar contra tu instancia hasta que la conectes.

Configura n8n-mcp en Claude Code (sin tocar la terminal a ciegas)

Pégale esto a Claude Code en la carpeta de tu proyecto. Te pregunta tus datos y deja el archivo de configuración listo.

Quiero conectar el servidor MCP "n8n-mcp" (de czlonkowski) a este proyecto de Claude Code para que puedas conocer todos los nodos de n8n, validar workflows y desplegarlos en mi instancia.

Hazlo así, paso a paso, y NO ejecutes nada que borre o sobrescriba sin avisarme:

1. Primero pregúntame estos tres datos, uno por uno, y espera mi respuesta:
   - La URL de mi instancia de n8n (algo como https://miusuario.app.n8n.cloud o http://localhost:5678). Si te digo "no tengo instancia", configúralo en modo solo-documentación (sin N8N_API_URL ni N8N_API_KEY): así igual conoces todos los nodos, aunque no puedas desplegar.
   - Mi N8N_API_KEY (la genero en n8n en Settings > n8n API > Create an API key). Recuérdame que es un secreto y que no debe quedar en git.
   - Si uso Claude Code en este proyecto (config local en .mcp.json) o lo quiero global para todas mis sesiones.

2. Con esos datos, crea o edita el archivo .mcp.json en la raíz del proyecto y agrega el servidor "n8n-mcp" usando npx con el paquete oficial. Deja las variables N8N_API_URL y N8N_API_KEY apuntando a lo que te di. Si elegí modo solo-documentación, omite esas dos variables.

3. Si en este repo existe un .gitignore, confirma que .mcp.json (o el archivo donde quede la API key) esté ignorado, o sugiéreme mover la llave a una variable de entorno. NUNCA dejes mi API key en un archivo que se vaya a subir a git.

4. Al terminar, muéstrame en texto el bloque de configuración final (oculta la API key con asteriscos), explícame en una línea qué hace cada parte, y dime exactamente qué tengo que hacer para reiniciar Claude Code y comprobar que el servidor "n8n-mcp" quedó conectado.

5. Por último, dime una frase de prueba que yo pueda escribirte después para confirmar que ya tienes acceso a los nodos de n8n (por ejemplo, pedirte que listes los nodos disponibles para enviar un correo).

Si prefieres ver cómo queda la configuración por dentro, este es el bloque de referencia que Claude Code va a dejar en tu archivo .mcp.json. No tienes que escribirlo a mano: es solo para que lo reconozcas.

Bloque de referencia para .mcp.json (Claude Code lo genera por ti)

"n8n-mcp": { "command": "npx", "args": ["-y", "n8n-mcp"], "env": { "N8N_API_URL": "https://tu-instancia.app.n8n.cloud", "N8N_API_KEY": "tu_api_key" } }

Sobre la capa nativa: la conexión MCP que n8n trae de fábrica vive dentro de n8n, no en tu archivo de Claude. Si más adelante quieres que Claude dispare tus propios workflows, agregas un nodo MCP Server Trigger en n8n y eso expone ese workflow como herramienta. Para el flujo de esta guía (describir y obtener automatizaciones) no necesitas tocar eso todavía: basta con n8n-mcp configurado arriba.

de idea a automatización

El flujo completo, con el caveat honesto

Así se ve el camino de punta a punta. Cuatro de los cinco pasos los hace Claude o un clic; el cuarto, el de las credenciales, es tuyo, y es justo donde la gente tropieza. Por eso lo marcamos en grande.

1

Describes la automatización

En lenguaje natural, le cuentas a Claude qué quieres que pase y qué la dispara. Sin sintaxis, sin nodos: como se lo explicarías a un compañero.

2

Claude genera el JSON del workflow

Con n8n-mcp como cerebro, Claude usa los nombres REALES de los nodos y arma un JSON de workflow correcto, con sus disparadores, pasos y conexiones.

3

Lo importas en n8n

En el canvas de n8n, importas desde archivo o pegando desde el portapapeles. Si tienes la API conectada, Claude puede desplegarlo directo, sin que toques nada.

4

Conectas las credenciales (a mano)

Este paso es manual y no lo evita nadie: al importar, n8n NO trae tus credenciales. Claude las referencia por nombre, pero tú las conectas en cada nodo. Es, de lejos, la causa más común de que un import no funcione a la primera.

5

Corres una prueba y activas

Disparas una ejecución de prueba para ver que todo corre bien de punta a punta. Si algo falla, vuelves a Claude con el error. Cuando pasa, activas el workflow.

Para importar en n8n: abre el canvas, usa la opción de importar desde archivo o pega el JSON desde el portapapeles, y listo. Si conectaste tu instancia por API, ni siquiera tienes que hacer eso: le pides a Claude que lo despliegue directo y aparece en tu lista de workflows.

el entregable central

Prompts maestros para automatizar con n8n

Estos son los prompts que harán el trabajo pesado. Cópialos, rellena lo que está entre [corchetes] con tu caso, y pégaselos a Claude (con n8n-mcp conectado). Cada uno cubre una parte del ciclo: generar, validar, arreglar, convertir un proceso de tu negocio y optimizar.

Genera el JSON de una automatización completa

El prompt central. Describe lo que quieres en lenguaje natural y Claude devuelve un workflow importable.

Actúa como ingeniero de automatización de n8n con acceso al MCP n8n-mcp. Quiero que generes un workflow de n8n completo e importable para esta automatización:

AUTOMATIZACIÓN QUE QUIERO:
[Describe en lenguaje natural qué debe pasar. Ejemplo: "Cuando llegue un correo nuevo a mi Gmail con la palabra 'factura' en el asunto, extrae el PDF adjunto, súbelo a una carpeta de Google Drive llamada Facturas y mándame un mensaje a Slack con el nombre del archivo."]

DISPARADOR (trigger):
[Di qué inicia el flujo: un correo, un webhook, un horario (cron), un formulario, etc. Si no lo sabes, dame 2 opciones y recomiéndame una.]

Antes de escribir nada:
- Usa el MCP para buscar los nombres REALES de los nodos que existen en n8n para cada paso (no inventes nodos). Si hay un nodo nativo y uno de comunidad para lo mismo, prefiere el nativo.
- Revisa si existe un template oficial parecido en n8n-mcp y, si lo hay, parte de ese.

Luego entrégame:
1. Un resumen en español, paso a paso, de qué hará el workflow y qué nodos usa (con su nombre real).
2. El JSON del workflow completo, listo para importar en n8n (con sus nodos, conexiones, y posiciones razonables en el canvas). Incluye un nodo de manejo de errores o una rama de "si falla, avísame" donde tenga sentido.
3. Una lista clara de las CREDENCIALES que tendré que conectar a mano en n8n después de importar (este paso no lo puedes hacer tú): por cada nodo que necesite credenciales, dime cuál es y cómo se llama el tipo de credencial en n8n.
4. Si tengo una instancia conectada por API, pregúntame si quieres que lo despliegues directo o si prefiero importarlo yo manualmente.

No uses placeholders tipo "// aquí va tu nodo": el JSON debe estar completo y ser válido.

Explícame y valida el workflow antes de importarlo

Para no importar a ciegas: que Claude lo revise contra el MCP y te lo traduzca a español plano.

Tengo este workflow de n8n (en JSON) que vas a revisar antes de que yo lo importe. Aquí va:

[Pega aquí el JSON del workflow, o dime "es el que acabas de generar".]

Usa el MCP n8n-mcp para validarlo y respóndeme en español plano, sin asumir que sé programar:

1. ¿Es válido? Pasa cada nodo por la validación del MCP y dime si algún nodo tiene un nombre que no existe, un parámetro mal puesto, o una conexión rota. Si algo está mal, dime exactamente cuál y qué lo arregla.
2. ¿Qué hace, en palabras simples? Explícame el flujo paso por paso como si me lo contaras a mí, no a otro programador.
3. ¿Qué credenciales necesito conectar a mano y en qué nodos? (Recuerda que tú no puedes meter mis credenciales.)
4. ¿Qué podría salir mal en la primera ejecución? Dame los 3 fallos más probables y cómo prevenirlos.
5. ¿Le falta manejo de errores? Si sí, propón dónde agregar una rama para que, si algo se cae, yo me entere.

Cuando termines, dame una versión corregida del JSON solo si encontraste algo que arreglar. Si todo está bien, dímelo claro: "está listo para importar".

Arregla un nodo que falla o mapea las credenciales

La causa número uno de fallos al importar son credenciales no conectadas. Este prompt diagnostica y te guía a conectarlas.

Importé un workflow en n8n y un nodo está fallando. Ayúdame a arreglarlo usando el MCP n8n-mcp.

QUÉ ESTÁ PASANDO:
[Describe el problema. Ejemplo: "El nodo de Gmail aparece con un signo de admiración rojo y al correr la ejecución de prueba dice 'No credentials set'." O pega el mensaje de error exacto que te da n8n.]

NODO O WORKFLOW:
[Pega el mensaje de error completo de n8n, y si lo tienes, el JSON del nodo o del workflow.]

Quiero que:
1. Me digas la causa más probable en una frase. Empieza siempre por revisar si es un tema de CREDENCIALES no conectadas, que es la causa número uno: cuando se importa un workflow, n8n NO trae mis credenciales, hay que volverlas a conectar a mano en cada nodo que las use.
2. Si es de credenciales: dime exactamente qué tipo de credencial pide ese nodo, dónde la creo en n8n (Settings > Credentials), y cómo la asigno al nodo (paso a paso, como si nunca lo hubiera hecho).
3. Si NO es de credenciales: valida el nodo con el MCP, dime qué parámetro o conexión está mal, y dame el bloque de JSON corregido de ese nodo.
4. Termina con una mini-lista de verificación de 3 puntos para que yo confirme que ya quedó antes de volver a correrlo.

Habla en español plano. No des por hecho que sé dónde está cada botón de n8n.

Convierte un proceso manual de mi negocio en un workflow

Cuéntale a Claude un proceso que hoy haces a mano y que te lo diseñe como automatización.

Tengo un proceso que hoy hago a mano en mi negocio y quiero automatizarlo en n8n. Actúa como consultor de automatización con acceso al MCP n8n-mcp.

EL PROCESO MANUAL, TAL CUAL LO HAGO HOY:
[Cuéntalo paso por paso, con tus palabras. Ejemplo: "Cada vez que alguien llena el formulario de mi web, copio sus datos a una hoja de cálculo, le escribo un correo de bienvenida y lo agrego a mi lista de clientes. Me toma como 10 minutos por persona."]

MI NEGOCIO Y MIS HERRAMIENTAS:
[Di a qué te dedicas y qué herramientas usas: Gmail, Google Sheets, Notion, WhatsApp, un CRM, etc. Si no sabes si algo se conecta con n8n, pregúntame y lo averiguas con el MCP.]

Quiero que:
1. Me hagas las preguntas que te falten para entender bien el proceso (disparador, pasos, qué decide qué, dónde termina). No asumas: pregunta.
2. Me propongas el diseño de la automatización en español plano: qué la dispara, qué pasos sigue, qué nodos reales de n8n usaría cada paso (verifícalos con el MCP) y dónde necesito decisiones (ramas "si pasa esto, haz aquello").
3. Cuando aprobemos el diseño, generes el JSON del workflow completo e importable, con manejo de errores donde tenga sentido.
4. Me digas qué credenciales tendré que conectar a mano y cuánto tiempo aproximado me ahorraría esta automatización por semana.

Empieza por las preguntas. No generes el JSON hasta que yo apruebe el diseño.

Optimiza un workflow y agrégale manejo de errores

Para flujos que ya corren pero son frágiles, lentos o se caen sin avisar.

Tengo un workflow de n8n que ya funciona pero quiero hacerlo más robusto y eficiente. Usa el MCP n8n-mcp para revisarlo.

EL WORKFLOW:
[Pega el JSON del workflow o describe qué hace y qué nodos usa.]

QUÉ ME MOLESTA DE ÉL (si aplica):
[Ejemplo: "A veces se cae y no me entero", "va lento cuando hay muchos registros", "no sé si está manejando bien los casos en que la API externa no responde".]

Quiero que:
1. Audites el flujo nodo por nodo con el MCP y me digas, en español plano, los 3 puntos más frágiles (dónde se puede caer y por qué).
2. Le agregues manejo de errores de verdad: una rama o nodo de error que, si algo falla, me avise (por correo o por el canal que yo te diga) y no deje el flujo a medias sin que nadie se entere.
3. Propongas mejoras de eficiencia concretas: evitar pasos repetidos, procesar en lote en vez de uno por uno, no llamar APIs de más, usar el nodo más adecuado para cada cosa (verifícalo con el MCP).
4. Me entregues el JSON optimizado completo e importable, y una lista corta de qué cambiaste y por qué.
5. Me recuerdes qué credenciales tendré que reconectar si reimporto el flujo desde cero.

Habla claro: dime qué gano con cada cambio.

Truco: empieza siempre por el prompt de generar, luego corre el de validar antes de importar. Esos dos juntos evitan la mayoría de los sustos. El de arreglar guárdalo para cuando un nodo te salga con el signo de admiración rojo: casi siempre serán credenciales.

el cerebro reutilizable

El system prompt: Claude, ingeniero de n8n

Los prompts de arriba son de una sola vez. Este es distinto: es una personalidad permanente. Lo pegas una vez como instrucciones de un Proyecto de Claude en claude.ai, o como base de un subagente o skill en Claude Code, y a partir de ahí Claude se comporta como un ingeniero de n8n: siempre usa nodos reales, pregunta por triggers y credenciales, valida con el MCP, devuelve JSON importable y te marca el paso de credenciales.

System prompt: Claude, ingeniero profesional de n8n

Pégalo como instrucciones de un Proyecto de Claude, o como base de un subagente/skill de Claude Code. Es el cerebro reutilizable.

Eres un ingeniero profesional de automatización especializado en n8n. Tu trabajo es convertir lo que el usuario describe en lenguaje natural en workflows de n8n correctos, válidos e importables. Tienes acceso al servidor MCP "n8n-mcp", que conoce todos los nodos de n8n, sus esquemas, miles de templates oficiales, validación de nodos y, si hay una instancia conectada, despliegue por API. Úsalo siempre como tu fuente de verdad.

REGLAS QUE NUNCA ROMPES:

1. Nombres de nodos reales. Nunca inventes un nodo. Antes de usar cualquier nodo, búscalo en el MCP y usa su nombre y su tipo exactos. Si dudas entre un nodo nativo y uno de comunidad para lo mismo, prefiere el nativo y dilo.

2. Pregunta antes de construir. Antes de generar JSON, asegúrate de tener claro: (a) qué dispara el flujo (correo, webhook, horario, formulario, etc.), (b) los pasos y las decisiones, (c) dónde termina, (d) qué servicios externos conecta. Si falta algo, haz preguntas concretas. No asumas.

3. JSON importable y válido. Entrega siempre el workflow como JSON completo, con nodos, conexiones y posiciones razonables en el canvas. Nada de placeholders ni "aquí iría tu nodo". Si el usuario tiene instancia conectada, ofrece desplegarlo por API; si no, dale instrucciones para importarlo (canvas > importar desde archivo o portapapeles).

4. Valida antes de entregar. Pasa el workflow por la validación del MCP. Si un nodo, parámetro o conexión está mal, corrígelo antes de mostrarlo. Si algo no se puede validar, dilo en claro en vez de fingir que está bien.

5. Marca SIEMPRE el paso de credenciales. Tú no puedes meter las credenciales del usuario; n8n no las trae al importar un workflow. Por eso, al final de cada entrega incluye una sección titulada "CREDENCIALES QUE DEBES CONECTAR A MANO" donde listes, por cada nodo que las necesite, el tipo de credencial y dónde se conecta en n8n. Recuérdale que esta es la causa número uno de fallos al importar.

6. Manejo de errores por defecto. En todo workflow que llame servicios externos, incluye una rama o nodo de error que avise al usuario si algo se cae, en vez de dejar el flujo muerto en silencio. Si el usuario no quiere, que lo diga; por defecto, lo pones.

7. Parte de templates cuando existan. Antes de construir desde cero, revisa si el MCP tiene un template oficial parecido y úsalo como base; ahorra tiempo y evita errores.

8. Habla en español plano. El usuario puede no programar. Explica cada flujo en palabras simples, paso por paso, antes de mostrar JSON. Nunca lo abrumes con jerga sin traducirla.

9. Seguridad. Nunca pidas, muestres ni pegues secretos (API keys, tokens, contraseñas) en el JSON ni en el chat. Refiérete a las credenciales por su nombre, no por su valor.

FORMATO DE TU RESPUESTA, en este orden:
1. Resumen en español del workflow (qué hace, paso a paso, con los nombres reales de los nodos).
2. El JSON completo e importable.
3. CREDENCIALES QUE DEBES CONECTAR A MANO (lista por nodo).
4. Cómo importarlo o desplegarlo, y cómo correr una ejecución de prueba antes de activarlo.
5. Qué podría fallar en la primera corrida y cómo prevenirlo.

Si en algún momento te piden algo que el MCP no soporta o que requiere una instancia que no está conectada, dilo con honestidad y propón la alternativa.

¿Prefieres tenerlo como un subagente o skill que Claude Code invoque solo cuando hablas de n8n? Pégale este prompt a Claude Code y él hace el scaffolding por ti, dejando el system prompt de arriba como instrucciones del agente.

Crea el subagente / skill de n8n en Claude Code

Pégale esto a Claude Code para que arme un subagente o skill reutilizable con el system prompt de arriba.

Quiero crear en este proyecto un subagente (o skill) de Claude Code que sea mi "ingeniero de n8n" reutilizable. Hazlo así:

1. Confirma que en este proyecto está configurado el servidor MCP "n8n-mcp" (revisa el .mcp.json). Si no está, avísame y dame el prompt para configurarlo antes de seguir.

2. Crea un subagente especializado en n8n en la carpeta correcta de este proyecto (.claude/agents/ para un subagente, o .claude/skills/ si prefieres skill). Ponle un nombre claro como "ingeniero-n8n".

3. Como instrucciones del subagente/skill, usa este system prompt tal cual (no lo resumas):

[Pega aquí el contenido completo del system prompt "Claude, ingeniero profesional de n8n".]

4. En la descripción del subagente/skill, deja claro cuándo debe activarse: cuando yo pida crear, validar, arreglar o desplegar automatizaciones de n8n. Así Claude Code lo invoca solo cuando aplica.

5. Asegúrate de que el subagente/skill tenga permiso para usar las herramientas del MCP n8n-mcp.

6. Al terminar, muéstrame la ruta del archivo que creaste, su contenido, y dime una frase de ejemplo que yo pueda escribir para invocarlo (por ejemplo, "úsame el ingeniero de n8n para automatizar mis facturas").

No subas ningún secreto a git en el proceso.

Ojo al pegar el scaffold: donde dice “pega aquí el contenido completo del system prompt”, copia el bloque de arriba tal cual. No lo resumas: la fuerza del agente está en sus reglas completas, sobre todo la que lo obliga a marcar siempre el paso de credenciales.

lo que separa un demo de algo que corre

Buenas prácticas y caveats

Antes de soltar tus workflows al mundo, interioriza estas cinco. La primera es la que más dolores de cabeza evita.

Las credenciales son siempre manuales

Claude las nombra, pero tú las conectas en n8n. Es la causa número uno de fallos al importar. Da por hecho que después de cada import te toca abrir cada nodo con credenciales y volverlas a asignar.

Valida antes de correr

Pídele a Claude que pase el workflow por la validación del MCP antes de importarlo. Atrapa nodos inexistentes, parámetros mal puestos y conexiones rotas antes de que te exploten en producción.

Parte de templates

n8n-mcp conoce miles de templates oficiales. Pedirle a Claude que parta de uno parecido ahorra tiempo y reduce errores frente a construir desde cero.

Versiona tus workflows

Exporta el JSON de tus workflows y guárdalo en git (o donde sea). Si una edición rompe algo, vuelves a la versión que funcionaba sin rehacerlo a mano.

Nunca pegues secretos

No metas API keys, tokens ni contraseñas en el JSON ni en el chat. Las credenciales viven en n8n y se referencian por nombre. Si Claude te pide un secreto en texto, recuérdaselo.

dudas frecuentes

Preguntas que todos hacen

¿Esto es oficial o es un truco de la comunidad?+

Las dos cosas, y ambas legítimas. La capa nativa (MCP Server Trigger y MCP Client Tool) es la conexión MCP oficial que n8n trae de fábrica en la versión 2.x, en todos los planes. La capa del 'cerebro' (n8n-mcp) es un servidor de comunidad, pero ya está listado en el registro oficial de MCP de Anthropic, así que no es un experimento suelto: pasó por la validación de Anthropic.

¿Es gratis?+

Sí, puedes hacerlo todo sin pagar. n8n tiene Community Edition gratis para autohospedar. El servidor n8n-mcp es de licencia MIT (gratis y abierto). Lo único que cuesta es, si lo eliges, la versión cloud de n8n (n8n.io) en lugar de autohospedar, y tu plan de Claude.

¿Cloud o self-host?+

Cloud (n8n.io) es lo más rápido para arrancar: no instalas nada y obtienes una URL lista para tu N8N_API_URL. Self-host (Community Edition) es gratis y te da control total, pero tú mantienes el servidor. Para automatizar con Claude, cualquiera de las dos sirve: lo que importa es tener tu URL y tu API key.

¿Claude.ai, Claude Code o Claude Desktop?+

n8n-mcp se conecta a Claude Desktop, Claude Code (con claude mcp add o un .mcp.json), Cursor y Windsurf. Para crear y desplegar workflows desde tu proyecto, Claude Code es lo más cómodo porque vive en tu carpeta. El system prompt de esta guía también lo puedes pegar como instrucciones de un Proyecto de Claude en claude.ai.

¿Por qué tengo que conectar credenciales a mano si Claude hace todo lo demás?+

Por seguridad y por cómo funciona n8n: tus credenciales (las llaves de tu Gmail, tu Slack, etc.) viven dentro de tu instancia de n8n y no salen de ahí. Cuando importas un workflow, viene la estructura pero no las llaves. Claude referencia cada credencial por su nombre, pero conectarla es un paso tuyo, en n8n. Es la causa más común de que un import 'no funcione' a la primera.

¿Puedo usar n8n-mcp sin tener una instancia de n8n todavía?+

Sí. En modo solo-documentación (sin N8N_API_URL ni N8N_API_KEY), Claude igual tiene el conocimiento de los ~1,851 nodos y puede generarte el JSON. Lo único que no podrá es desplegar o validar contra tu instancia hasta que la conectes.

antes de activar

Checklist final

Si puedes marcar las diez, tienes una automatización lista para producción, no un demo que se cae al primer correo real.

  • Tengo una instancia de n8n (cloud o self-host) o decidí empezar en modo solo-documentación.
  • Generé mi N8N_API_KEY en n8n (Settings > n8n API) y tengo a mano mi N8N_API_URL.
  • Conecté el servidor n8n-mcp a Claude (Code, Desktop o como Proyecto) con el prompt de setup.
  • Confirmé que mi API key NO quedó en un archivo que se suba a git.
  • Le describí mi automatización a Claude y obtuve un JSON de workflow.
  • Le pedí a Claude que validara el workflow con el MCP antes de importarlo.
  • Importé el workflow en n8n (o Claude lo desplegó por API).
  • Conecté a mano las credenciales en cada nodo que las pedía.
  • Corrí una ejecución de prueba de punta a punta y revisé el resultado.
  • Activé el workflow solo después de que la prueba pasó.

Cierre de la guía

La parte difícil de n8n nunca fue la lógica, era arrastrar nodos y adivinar nombres. Con el MCP, esa parte se la quitas a Claude: tú describes, él arma, tú conectas las credenciales y activas. Empieza por una automatización pequeña de tu día a día, valida antes de importar y ve sumando flujos. Esta guía vive en la bóveda de tododeia.

Esta página no está afiliada a n8n. Las herramientas, los planes y las cifras (número de nodos y templates) cambian con cada versión; ante la duda, verifica en el sitio oficial de n8n (docs.n8n.io) y en el repositorio del servidor (github.com/czlonkowski/n8n-mcp).