Claude construye tus flujos de n8n

Pasos

1. Trabaja sobre una copia

El propio README de n8n-mcp lo avisa en grande: nunca edites con IA tus flujos en producción. Antes de empezar, descarga una copia de los flujos importantes. Si puedes, usa una instancia de n8n solo para pruebas.

Deberías ver: tus flujos exportados en una carpeta del ordenador.

2. Crea la API key de n8n

En n8n ve a Settings > n8n API, pulsa Create an API key, ponle una etiqueta («claude-pruebas») y una caducidad corta. Copia la clave. Fuera del plan Enterprise, la clave tiene acceso a todo, así que trátala como una contraseña. Ojo: en la prueba gratis de n8n Cloud la API no está disponible.

Deberías ver: la clave en pantalla una sola vez. Guárdala.

3. Conecta n8n-mcp a Claude Code

En la terminal, con tu URL y tu clave:

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -e N8N_API_URL=http://localhost:5678 \
  -e N8N_API_KEY=tu-api-key \
  -- npx n8n-mcp

Comprueba que está:

claude mcp list

Si usas Claude Desktop, el README trae el bloque equivalente para claude_desktop_config.json (en Mac está en ~/Library/Application Support/Claude/). Después reinicia la app.

Deberías ver: n8n-mcp conectado, y dentro de Claude Code el comando /mcp te enseña sus herramientas.

4. Prepara el bot de Telegram

Abre un chat con @BotFather, escribe /newbot, dale nombre y copia el token. Mete el bot en el grupo «Cocina». Para sacar el Chat ID del grupo, abre Telegram en el navegador: son los números que salen detrás de la «g» en la dirección, y en n8n se ponen con un - delante. Crea tú la credencial de Telegram en n8n con el token. No se la pases a Claude.

Deberías ver: la credencial guardada en n8n.

5. Pídele el flujo

Usa n8n-mcp para crear un flujo nuevo en mi n8n. No toques ningún otro flujo
ni lo publiques. Deja el flujo sin publicar.

Contexto: hamburguesería en Málaga con pedidos para recoger desde la web.
La web enviará cada pedido por POST en JSON con: nombre, telefono,
hora_recogida, total (número en euros) y lineas (lista de productos con
cantidad).

Flujo:
1. Webhook que recibe el pedido por POST.
2. Si total es mayor que 80, mandar un mensaje de Telegram (Send Message)
   al chat [TU CHAT ID, con el - delante] con este texto:
   "PEDIDO GRANDE: {total} € para las {hora_recogida}. {lineas en una lista}.
   Cliente: {nombre}."
3. Si no, no hacer nada.

Usa la credencial de Telegram que ya existe en mi n8n, no crees otra.
Antes de crear el flujo, busca los nodos y valídalo. Al acabar,
dime el nombre del flujo y la Test URL del webhook.

Deberías ver: Claude buscando nodos, validando y respondiendo con el flujo creado y su URL de prueba.

6. Pruébalo con un pedido falso

Abre el flujo en n8n, revisa cada nodo, pulsa Execute workflow y manda un pedido de prueba a la Test URL:

curl -X POST "PEGA_AQUI_LA_TEST_URL" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Prueba","telefono":"600000000","hora_recogida":"21:15","total":96.5,"lineas":[{"producto":"Smash doble","cantidad":6},{"producto":"Patatas","cantidad":4}]}'

Repite con "total":40 para comprobar que no avisa.

Deberías ver: el aviso en el grupo de cocina con el primer pedido y nada con el segundo.

7. Publica tú

Cuando lo hayas revisado, publícalo tú desde n8n y pon la Production URL en la web.

Errores típicos

• Claude cambia un flujo que ya funcionaba. Trabaja en una copia y dile en el prompt qué flujos no puede tocar. El README explica cómo desactivar herramientas con DISABLED_TOOLS (por ejemplo, n8n_delete_workflow).
• Claude Desktop da errores de JSON tipo «Unexpected token». Falta MCP_MODE=stdio en la configuración. Es obligatorio.
• Falla si abres Claude Desktop y Claude Code a la vez. Los dos lanzan npx y chocan en la caché de npm. El README propone una carpeta npm_config_cache distinta para cada uno.
• Telegram no manda nada al grupo. El Chat ID de un grupo lleva un - delante. Comprueba también que el bot está dentro del grupo.
• Fiarte del flujo sin abrirlo. La IA se equivoca en detalles como el campo del total o la condición. Ábrelo siempre y prueba con datos falsos antes de publicar.

Siguiente paso

Si todavía no tienes n8n, empieza por n8n gratis: instálalo y haz tu primer flujo. Para entender qué es un MCP sin jerga, lee MCP explicado sin tecnicismos. n8n también trae su propio servidor MCP, que se activa en sus ajustes y sirve como alternativa a n8n-mcp.