lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

herramienta intermedio mcpn8nclaude-codecodexcursor

n8n-MCP: documentación y validación de flujos para tu agente

Consulta nodos y plantillas de n8n desde tu cliente MCP. Diseña y valida flujos con información del proyecto antes de conectarlos a una instancia real.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara Node.js y el cliente

Comprueba que Node.js cumple ≥22.23.4 y <23, ≥24.22.1 y <25, o ≥26.12.1, según el package.json oficial, y que npm/npx está en PATH. Abre el cliente MCP elegido y sigue docs/SELF_HOSTING.md. Para la primera prueba usa únicamente las herramientas de documentación.

Paso 2: configura MCP

Configuración básica de Claude Desktop, copiada de la guía oficial del proyecto:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

Para Claude Code, Codex o Cursor usa la guía de ese cliente enlazada en Connect your IDE del README. No pegues JSON de Desktop en un cliente que espere TOML.

Paso 3: reinicia y consulta

Reinicia el cliente. Pide al agente que consulte tools_documentation() y busque un nodo para una automatización de prueba. Después solicita una validación del flujo propuesto.

Comprobación

Comprueba que el cliente ve el servidor y recibe detalles de un nodo. La configuración básica no debe disponer de acceso para modificar una instancia n8n.

Si algo falla

Revisa Node.js, la ruta de npx y los registros del cliente. Para stdio conserva los ajustes que evitan salida adicional por consola. Si añades gestión de n8n más adelante, sigue SELF_HOSTING.md y no confundas N8N_API_KEY con N8N_MCP_ACCESS_TOKEN.

ver en .md ¿Prefieres el recurso entero?

Qué es

n8n-MCP es un servidor MCP que acerca documentación, configuraciones y plantillas de n8n al agente. Con credenciales adicionales también puede gestionar flujos de una instancia de n8n.

Para qué te sirve

  • Cuando el agente inventa campos o propiedades de un nodo.
  • Cuando buscas una plantilla de automatización antes de construirla desde cero.
  • Cuando necesitas validar conexiones y expresiones antes de desplegar un flujo.

Cómo funciona

El paquete lleva una base de información de nodos preparada para consulta. El cliente MCP llama a herramientas de búsqueda, detalle y validación. La configuración básica solo expone documentación; añadir la URL y la clave de n8n activa herramientas de gestión. La documentación distingue además el acceso MCP de la propia instancia, que usa otro token.

Antes de empezar

Para el modo local con npx necesitas npm/npx, un cliente MCP y Node.js en uno de los intervalos del paquete: ≥22.23.4 y <23, ≥24.22.1 y <25, o ≥26.12.1. La prueba de documentación no requiere clave de n8n. Si conectas una instancia, prepara su URL y permisos de API. El código del servidor es MIT; el servicio alojado, tu modelo y la instancia n8n pueden tener costes propios.

Límites y alternativas

La validación de estructura no demuestra que un servicio externo responda ni que el flujo cumpla el objetivo. Prueba con datos de ejemplo antes de activarlo. No confundas n8n-MCP con el servidor MCP incluido en n8n: el README documenta ambas superficies. Mantener el modo de documentación es suficiente cuando solo quieres diseñar un flujo sin modificar la instancia.

Recursos