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

1. Inicie sesión en su instancia n8n

2. Haga clic en su icono de usuario en la parte inferior izquierda.

3. Ir a Configuración

4. Seleccionar API

5. Haga clic en "Crear clave API"

6. Copia tu clave API (no podrás volver a verla)

Instalar el servidor MCP

Opción 1: Instalar desde npm (recomendado)

Opción 2: Instalar desde la fuente

1. Clonar el repositorio:

   git clone https://github.com/illuminaresolutions/n8n-mcp-server.git cd n8n-mcp-server

2. Instalar dependencias y compilar:

   npm install npm run build

3. 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.

Configuración

Escritorio de Claude

1. Abra la configuración de Claude Desktop:

   ~/Library/Application Support/Claude/claude_desktop_config.json

2. 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)

1. Instalar el servidor (siga los pasos de instalación anteriores)

2. Abrir VS Code

3. Abra la extensión Cline desde la barra lateral izquierda

4. Haga clic en el icono 'Servidores MCP' en la parte superior del panel

5. Desplácese hasta la parte inferior y haga clic en "Configurar servidores MCP".

6. 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" } } } }

7. Guardar el archivo

8. Asegúrese de que el interruptor MCP esté habilitado (verde) y que el indicador de estado esté verde

9. 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:

1. Reinicia tu solicitud de LLM

2. Pregunta: "Enumerar mis flujos de trabajo n8n"

3. 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

1. "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

2. "Se requiere licencia"

   • Estás intentando utilizar una función de Enterprise

   • Actualice a n8n Enterprise o utilice solo las funciones principales

3. 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

1. Gestión de claves API

   • Utilice los permisos mínimos necesarios

   • Gire las llaves regularmente

   • Nunca envíe claves al control de versiones

2. Acceso a instancias

   • Utilice HTTPS para producción

   • Habilitar la autenticación n8n

   • Mantén n8n actualizado

Apoyo

• Problemas de GitHub

• Documentación de n8n

Licencia

Licencia MIT