Servidor MCP n8n

Un servidor MCP que proporciona acceso a flujos de trabajo, ejecuciones, credenciales y más de n8n mediante el Protocolo de Contexto de Modelo. Esto permite que los Modelos de Lenguaje Grandes (LLM) interactúen con instancias de n8n de forma segura y estandarizada.

Instalación

Obtenga su clave API n8n

Inicie sesión en su instancia n8n
Haga clic en su icono de usuario en la parte inferior izquierda.
Ir a Configuración
Seleccionar API
Haga clic en "Crear clave API"
Copia tu clave API (no podrás volver a verla)

Instalar el servidor MCP

Opción 1: Instalar desde npm (recomendado)

npm install -g @illuminaresolutions/n8n-mcp-server

Opción 2: Instalar desde la fuente

Clonar el repositorio:
git clone https://github.com/illuminaresolutions/n8n-mcp-server.git cd n8n-mcp-server
Instalar dependencias y compilar:
npm install npm run build
Inicie el servidor en segundo plano:
nohup npm start > n8n-mcp.log 2>&1 &
Para detener el servidor:
pkill -f "node build/index.js"

Nota: Al instalar desde npm, el servidor estará disponible como n8n-mcp-server en su RUTA.

Related MCP server: n8n Workflow Builder MCP Server

Configuración

Escritorio de Claude

Abra la configuración de Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json
Agregue la configuración n8n:
{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }

Cline (Código VS)

Instalar el servidor (siga los pasos de instalación anteriores)
Abrir VS Code
Abra la extensión Cline desde la barra lateral izquierda
Haga clic en el icono 'Servidores MCP' en la parte superior del panel
Desplácese hasta la parte inferior y haga clic en "Configurar servidores MCP".
Agregue al archivo de configuración abierto:
{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }
Guardar el archivo
Asegúrese de que el interruptor MCP esté habilitado (verde) y que el indicador de estado esté verde
Comience a usar comandos MCP en Cline

Sabio

¡Próximamente! El servidor MCP n8n estará disponible a través de:

Mercado de Smithery.ai
Importar desde Claude Desktop

Por ahora, utilice Claude Desktop o Cline.

Validación

Después de la configuración:

Reinicia tu solicitud de LLM
Pregunta: "Enumerar mis flujos de trabajo n8n"
Deberías ver tus flujos de trabajo enumerados

Si recibe un error:

Comprueba que tu instancia n8n se esté ejecutando
Verifique que su clave API tenga los permisos correctos
Asegúrese de que N8N_HOST no tenga ninguna barra diagonal final

Características

Características principales

Enumerar y gestionar flujos de trabajo
Ver detalles del flujo de trabajo
Ejecutar flujos de trabajo
Administrar credenciales
Manejar etiquetas y ejecuciones
Generar auditorías de seguridad
Administrar etiquetas de flujo de trabajo

Funciones empresariales

Estas funciones requieren una licencia n8n Enterprise:

Gestión de proyectos
Gestión de variables
Gestión avanzada de usuarios

Solución de problemas

Problemas comunes

"Cliente no inicializado"
- Compruebe que N8N_HOST y N8N_API_KEY estén configurados correctamente
- Asegúrese de que la instancia n8n sea accesible
- Verificar los permisos de la clave API
"Se requiere licencia"
- Estás intentando utilizar una función de Enterprise
- Actualice a n8n Enterprise o utilice solo las funciones principales
Problemas de conexión
- Verificar que la instancia n8n se esté ejecutando
- Comprobar el protocolo URL (http/https)
- Eliminar la barra diagonal final de N8N_HOST

Mejores prácticas de seguridad

Gestión de claves API
- Utilice los permisos mínimos necesarios
- Gire las llaves regularmente
- Nunca envíe claves al control de versiones
Acceso a instancias
- Utilice HTTPS para producción
- Habilitar la autenticación n8n
- Mantén n8n actualizado