Empezar un proyecto
MCPIntermedio11 minActualizado octubre de 2026

n8n-MCP

Servidor MCP de Romuald Czlonkowski para que tu asistente de IA conozca los nodos y plantillas de n8n y, con la API configurada, gestione tus flujos.

Por Romuald Czlonkowski

Fuente: n8n-MCP (repositorio oficial) · Oficial · Mantiene Romuald Czlonkowski (comunidad) · Licencia MIT · Ver original en github.com

Ficha técnica

Autor
Romuald Czlonkowski (se abre en una pestaña nueva)
Transporte
stdio con npx; también HTTP con token propio
Clientes compatibles
  • Claude Code
  • Claude Desktop
  • Visual Studio Code con GitHub Copilot
  • Cursor
  • Windsurf
  • Codex
  • Antigravity
Instalación
npx n8n-mcp

Qué es y qué expone

n8n-MCP es un servidor MCP que da a los asistentes de IA acceso completo a la documentación, las propiedades y las operaciones de los nodos de n8n. Hace de puente entre la plataforma de automatización y los modelos de IA, para que entiendan los nodos y trabajen bien con ellos.

Comprobado el 2026-10-25, su base cubre 3.143 nodos de n8n: 841 del núcleo y 2.302 de la comunidad. Incluye además una biblioteca de 2.352 plantillas de flujos de trabajo y 156 configuraciones reales, ordenadas, sacadas de plantillas populares. Las cifras cambian con cada versión.

No es un producto de n8n. Lo mantiene Romuald Czlonkowski, con licencia MIT. Según su autor, el proyecto empezó como una herramienta personal y hoy ayuda a decenas de miles de desarrolladores. Su autor ofrece también, con AiAdvisors, auditorías, construcción y operación de automatizaciones de n8n.

Valoración de KIRELEN: encaja con quien construye flujos de n8n con un asistente de IA y quiere que conozca los nodos y las plantillas reales. Es un proyecto de su autor, no de n8n.

Panel de Claude Code con el servidor n8n-mcp conectado, lanzado con npx n8n-mcp y con herramientas disponibles
n8n-MCP conectado en Claude Code: el comando /mcp muestra el estado del servidor y la orden con la que se lanza (npx n8n-mcp). Captura recortada de la guía de Claude Code del repositorio oficial, comprobado el 2026-10-17. Es de una versión anterior: el número de herramientas cambia con la versión.Guía de Claude Code de czlonkowski/n8n-mcp (se abre en una pestaña nueva)

Qué problema resuelve

Un asistente que construye flujos de n8n sin datos fiables de los nodos tiende a inventar parámetros o a dejar los valores por defecto. El README lo señala como el error más caro: los valores por defecto de los parámetros son la primera causa de fallos en ejecución.

Con n8n-MCP, el asistente consulta los nodos reales antes de escribir nada. El paquete trae una base de datos ya construida con la información de todos los nodos de n8n, así que las herramientas de documentación funcionan sin conectar ninguna instancia. Puede buscar plantillas, leer las propiedades de un nodo y validar su configuración antes de montar el flujo.

Si además le das la URL y la clave de API de tu instancia, el mismo asistente puede crear, actualizar, validar y probar flujos en ella.

Cómo funciona

Dos niveles de herramientas

La configuración básica solo da las herramientas de documentación. La completa añade las herramientas de gestión de n8n, que necesitan las variables N8N_API_URL y N8N_API_KEY con la dirección y la clave de tu instancia.

Dónde se ejecuta

Con Node.js instalado, se ejecuta directamente con npx, sin instalarlo; npx descarga y ejecuta automáticamente la última versión. Para autohospedarlo hay también opciones con Docker, Railway e instalación local. Y hay un panel alojado: basta con registrarse, obtener la clave de API y conectar el cliente MCP. Comprobado el 2026-10-25 en el README y en la página del servicio, tiene un plan gratuito de 100 llamadas a herramientas al día; el plan Supporter, de 19 € al mes, las da ilimitadas.

En Claude Desktop, la variable MCP_MODE con valor stdio es obligatoria: sin ella aparecen errores de análisis de JSON. Esa variable hace que por la salida estándar solo salgan mensajes JSON-RPC, sin que los registros de depuración interfieran con el protocolo. Si lanzas el servidor con npx desde dos clientes a la vez, puede haber conflictos de bloqueo en la caché de npm; la solución es dar a cada cliente un directorio npm_config_cache distinto.

Tarjetas de resultados

En los clientes que las muestran, algunas herramientas devuelven tarjetas de resultados. El agente construye y repara los flujos; las tarjetas ayudan a la persona a seguir el trabajo y revisar los resultados. Cada tarjeta nueva empieza plegada en una fila con el nombre n8n-mcp, la categoría del resultado y un resumen. Con N8N_MCP_DISABLE_UI_APPS en true, el servidor deja de anunciarlas, y las herramientas y sus respuestas de texto no cambian. Las capturas del repositorio muestran las tarjetas en su laboratorio local, con datos sintéticos, como la de abajo.

Tarjeta de n8n-mcp con el resultado de validar un flujo de ejemplo: 3 errores y 2 avisos, con los detalles plegados
Tarjeta de resultado de una validación: el flujo de ejemplo tiene 3 errores y 2 avisos, y los detalles se despliegan al pulsar. Captura del repositorio oficial, tomada en su laboratorio local con datos sintéticos.Capturas de las tarjetas de resultados de czlonkowski/n8n-mcp (se abre en una pestaña nueva)

Del asistente a tu instancia

Del asistente a tu instanciaArquitectura en 3 capas, de arriba abajo; capa 1: Asistentes de IA; capa 2: Servidor MCP; capa 3: Base de nodos, Instancia de n8n. Conexiones: Asistentes de IA → Servidor MCP, Servidor MCP → Base de nodos, Servidor MCP → Instancia de n8n.Asistentes de IAServidor MCPBase de nodosInstancia de n8nDel asistente a tu instanciaArquitectura en 3 capas, de arriba abajo; capa 1: Asistentes de IA; capa 2: Servidor MCP; capa 3: Base de nodos, Instancia de n8n. Conexiones: Asistentes de IA → Servidor MCP, Servidor MCP → Base de nodos, Servidor MCP → Instancia de n8n.Asistentes de IAServidor MCPBase de nodosInstancia de n8n
Leer el diagrama como texto
  1. Capa 1
    • Asistentes de IA
  2. Capa 2
    • Servidor MCP
  3. Capa 3
    • Base de nodos
    • Instancia de n8n

Conexiones

  • Asistentes de IA → Servidor MCP
  • Servidor MCP → Base de nodos
  • Servidor MCP → Instancia de n8n

Tecnologías utilizadas

TecnologíaPara qué
TypeScriptLenguaje del repositorio, según GitHub
JavaScriptLenguaje del repositorio, según GitHub
Node.jsEjecuta el servidor con npx, sin instalarlo
API de n8nLas herramientas de gestión, con N8N_API_URL y N8N_API_KEY de tu instancia

Cómo empezar: requisitos e instalación

  1. Instala Node.js y elige tu cliente.

    El requisito es tener Node.js instalado. Hay guías para Claude Code, Visual Studio Code con GitHub Copilot, Cursor, Windsurf, Codex y Antigravity.

  2. Añade el servidor.

    Con npx se ejecuta directamente, sin instalarlo. La configuración para Claude Desktop está en «Configuración» y el comando para Claude Code, en «Ejemplo de uso».

  3. En Claude Desktop, fija el modo.

    La variable MCP_MODE con valor stdio es obligatoria: sin ella aparecen errores de análisis de JSON.

  4. Para gestionar flujos, conecta tu instancia.

    Las herramientas de gestión necesitan N8N_API_URL y N8N_API_KEY; n8n_manage_agents, n8n_explore_node_resources y parte de n8n_list_catalog piden además el MCP de nivel de instancia de n8n.

  5. O usa el panel alojado.

    Basta con registrarse, obtener la clave de API y conectar el cliente MCP.

Estado del proyecto y licencia

n8n-MCP tiene licencia MIT con copyright de Romuald Czlonkowski, su autor; no es un producto de n8n.

Según la ficha del repositorio en GitHub, comprobada el 2026-10-25, el último release es v2.94.3, publicado el 2026-10-19, y el último push es del mismo día: un proyecto activo, con releases.

Herramientas expuestas

HerramientaGrupoQué hace
tools_documentationDocumentaciónDa la documentación de cualquier herramienta; es por donde se empieza.
search_nodesDocumentaciónBusca en todos los nodos, también los de la comunidad, con ejemplos opcionales.
get_nodeDocumentaciónInformación de un nodo: datos, documentación, propiedades y versiones.
validate_nodeDocumentaciónValida la configuración de un nodo.
validate_workflowDocumentaciónValida un flujo completo, incluidos los agentes de IA.
search_templatesDocumentaciónBusca plantillas por texto, nodos, tarea o metadatos.
get_templateDocumentaciónObtiene el JSON de un flujo de una plantilla.
n8n_create_workflowGestiónCrea flujos con sus nodos y conexiones.
n8n_get_workflowGestiónObtiene un flujo en varios modos.
n8n_update_full_workflowGestiónSustituye un flujo entero.
n8n_update_partial_workflowGestiónActualiza un flujo con operaciones de diferencias.
n8n_delete_workflowGestiónBorra flujos de forma permanente.
n8n_list_workflowsGestiónLista flujos con filtros y paginación.
n8n_validate_workflowGestiónValida en n8n un flujo por su ID.
n8n_autofix_workflowGestiónCorrige errores comunes de un flujo.
n8n_workflow_versionsGestiónHistorial, diferencias y vuelta atrás de un flujo.
n8n_deploy_templateGestiónDespliega una plantilla en tu instancia, con corrección automática.
n8n_test_workflowGestiónEjecuta un flujo.
n8n_executionsGestiónLista, consulta y borra ejecuciones.
n8n_evaluationsGestiónLanza y lee evaluaciones de prueba.
n8n_manage_foldersGestiónGestiona las carpetas de flujos.
n8n_manage_datatableGestiónGestiona tablas de datos, filas y columnas.
n8n_manage_credentialsGestiónGestiona las credenciales de n8n.
n8n_audit_instanceGestiónAuditoría de seguridad de la instancia y sus flujos.
n8n_manage_agentsGestiónGestiona los agentes de n8n.
n8n_explore_node_resourcesGestiónResuelve los valores dinámicos de los desplegables de un nodo.
n8n_health_checkGestiónComprueba la conexión con la API de n8n.
n8n_list_catalogGestiónLista proyectos o etiquetas de la instancia.

Comprobado el 2026-10-25, el README enumera 7 herramientas principales y 21 de gestión de n8n, que requieren configurar la API.

Configuración

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

Ejemplo de uso

Conectarlo a Claude Code

La guía de Claude Code del repositorio explica cómo conectar n8n-MCP a su CLI para desarrollar flujos de n8n desde la línea de comandos. La configuración básica, solo con las herramientas de documentación, es esta:

bash
claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -- npx n8n-mcp

Si ya lo tienes configurado en Claude Desktop, se puede importar en Claude Code, y para compartirlo con un equipo se añade al archivo .mcp.json de la raíz del proyecto. Durante una conversación, el comando /mcp muestra el estado del servidor y sus herramientas, como en la captura de la primera sección. También tiene guías para Visual Studio Code con GitHub Copilot, Cursor, Windsurf, Codex y Antigravity.

El proceso que propone el README

Para Claude Projects, el README propone unas instrucciones de sistema con un proceso por fases:

  1. Empieza llamando a tools_documentation para conocer las buenas prácticas.
  2. Antes de construir desde cero, revisa siempre las plantillas.
  3. Si no hay una plantilla adecuada, busca nodos; si los requisitos no están claros, hace preguntas para aclararlos.
  4. Antes de seguir, enseña la arquitectura del flujo a la persona para que la apruebe.
  5. Valida cada nodo, primero con una comprobación rápida de los campos obligatorios y después completa, y corrige todos los errores.
  6. Al construir, fija de forma explícita todos los parámetros, sin fiarse de los valores por defecto. Si parte de una plantilla, la atribución a su autor es obligatoria.
  7. Valida el flujo completo antes de desplegarlo.
  8. Si la API de n8n está configurada, lo despliega con n8n_create_workflow, lo comprueba con n8n_validate_workflow, aplica cambios con n8n_update_partial_workflow y lo prueba con n8n_test_workflow.

Ejemplo de KIRELEN (no oficial): pides un flujo que reciba un formulario por webhook y avise en un canal de chat. Con este proceso, el asistente busca primero plantillas parecidas; si ninguna sirve, consulta los nodos del webhook y del chat, te enseña la arquitectura y valida cada nodo antes de montar el flujo. Si no has configurado la API, el resultado es el JSON del flujo para importarlo tú.

Seguridad y límites

Nunca en producción directamente. El README advierte que nunca hay que editar con IA los flujos de producción directamente, porque los resultados de la IA pueden ser impredecibles. Recomienda copiar el flujo antes, probar primero en un entorno de desarrollo, exportar copias de los flujos importantes y validar los cambios antes de llevarlos a producción.

La frontera es tu instancia. n8n-mcp es un proxy de la API REST de n8n: todo lo que hace se puede hacer igual con esa API y la misma clave, y la frontera de seguridad es la propia n8n. Quien tenga acceso a la sesión MCP tiene, en la práctica, los mismos privilegios que la clave configurada. Las herramientas de gestión pueden crear y ejecutar flujos, también con nodos Code; lo que esos nodos pueden hacer se controla en la instancia, con su sandbox, activado por defecto, con N8N_CODE_NODE_ALLOWED_MODULES y, en n8n Enterprise, con RBAC. En modo HTTP es obligatorio AUTH_TOKEN, con un valor aleatorio fuerte de al menos 32 caracteres, y por defecto el modo strict de la protección de webhooks bloquea localhost, las redes privadas y los endpoints de metadatos de la nube.

Datos que pueden dar órdenes. Los nombres, descripciones y resultados de ejecución que devuelve el servidor llegan al LLM. Quien pueda modificar flujos en una instancia compartida podría preparar nombres o descripciones pensados para manipular al asistente. Como mitigación, la documentación propone restringir quién crea o modifica flujos, limitar las herramientas con DISABLED_TOOLS y revisar las acciones del agente antes de ejecutarlas.

Solo lectura. Para entornos con requisitos de gobernanza, el README propone desactivar del todo las herramientas que escriben, destruyen o manejan datos sensibles; n8n_manage_credentials y n8n_manage_datatable se quitan aunque tengan operaciones de lectura, porque incluso leer expone material sensible. Con DISABLED_TOOL_OPERATIONS se bloquean solo las operaciones destructivas de las herramientas que mezclan lectura y escritura. Ojo con n8n_test_workflow: los métodos auto, trigger, pinned y direct ejecutan el flujo, y solo prepare es de lectura. Se recomienda combinarlo con una clave de API de n8n de solo lectura, como defensa en profundidad.

Telemetría activada por defecto. El servidor recoge datos de uso para mejorar la herramienta y para crear conjuntos de datos y modelos de aprendizaje automático de generación de flujos. Registra qué herramientas se llaman, si la llamada tuvo éxito y cuánto tardó, y las estructuras de los flujos que se crean, actualizan o validan, después de limpiarlas. No recoge claves, tokens, contraseñas ni la dirección de tu instancia, pero la limpieza se hace por patrones y no garantiza que se detecte cualquier dato sensible. El responsable es AiAdvisors Romuald Członkowski, una empresa individual registrada en Polonia. Se desactiva con npx n8n-mcp telemetry disable o, en Docker, con N8N_MCP_TELEMETRY_DISABLED=true.

Valoración de KIRELEN: lo prudente es empezar con las herramientas de documentación, dar a las de gestión una instancia de pruebas y una clave de solo lectura, y desactivar la telemetría si los flujos no deben salir de tu equipo.

Enlaces oficiales

Sitio oficial
Repositorio
Descarga

Fuentes consultadas

Documentación

Repositorio

Recursos relacionados