n8n MCP Server

Gestiona flujos de trabajo, ejecuciones y credenciales de n8n a través del Model Context Protocol.

GitHub
3
Prueba este MCPPatrocinado

Documentación

n8n MCP Server

Un servidor MCP que proporciona acceso a flujos de trabajo, ejecuciones, credenciales y más de n8n a través del Protocolo de Contexto de Modelo (Model Context Protocol). Esto permite que los Modelos de Lenguaje de Gran Tamaño (LLMs) interactúen con instancias de n8n de manera segura y estandarizada.

Instalación

Obtén tu clave de API de n8n

  1. Inicia sesión en tu instancia de n8n
  2. Haz clic en el icono de usuario en la esquina inferior izquierda
  3. Ve a Configuración (Settings)
  4. Selecciona API
  5. Haz clic en "Crear clave de API" (Create API Key)
  6. Copia tu clave de API (no podrás verla de nuevo)

Instalar el servidor MCP

Opción 1: Instalar desde npm (Recomendado)

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

Opción 2: Instalar desde el código fuente

  1. Clona el repositorio:

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

  2. Instala las dependencias y compila:

    npm install
npm run build

  3. Inicia 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 tu PATH.

Configuración

Claude Desktop

  1. Abre tu configuración de Claude Desktop:

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

  2. Añade la configuración de n8n:

    {
  "mcpServers": {
     "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code)

  1. Instala el servidor (sigue los pasos de Instalación anteriores)
  2. Abre VS Code
  3. Abre la extensión Cline desde la barra lateral izquierda
  4. Haz clic en el icono 'Servidores MCP' en la parte superior del panel
  5. Desplázate hasta el final y haz clic en 'Configurar servidores MCP'
  6. Añade 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. Guarda el archivo
  8. Asegúrate de que el interruptor MCP esté habilitado (verde) y que el indicador de estado esté en verde
  9. Comienza a usar comandos MCP en Cline

Sage

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

  • Mercado de Smithery.ai
  • Importación desde Claude Desktop

Por ahora, usa Claude Desktop o Cline.

Validación

Después de la configuración:

  1. Reinicia tu aplicación LLM
  2. Pregunta: "Lista mis flujos de trabajo de n8n"
  3. Deberías ver tus flujos de trabajo listados

Si obtienes un error:

  • Verifica que tu instancia de n8n esté en ejecución
  • Comprueba que tu clave de API tenga los permisos correctos
  • Asegúrate de que N8N_HOST no tenga una barra diagonal final

Características

Características principales

  • Listar y gestionar flujos de trabajo
  • Ver detalles de flujos de trabajo
  • Ejecutar flujos de trabajo
  • Gestionar credenciales
  • Manejar etiquetas y ejecuciones
  • Generar auditorías de seguridad
  • Gestionar etiquetas de flujos de trabajo

Características empresariales

Estas características requieren una licencia Enterprise de n8n:

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

Solución de problemas

Problemas comunes

  1. "Cliente no inicializado"

    • Verifica que N8N_HOST y N8N_API_KEY estén configurados correctamente
    • Asegúrate de que la instancia de n8n sea accesible
    • Comprueba los permisos de la clave de API

  2. "Licencia requerida"

    • Estás intentando usar una característica empresarial
    • Actualiza a n8n Enterprise o usa solo las características principales

  3. Problemas de conexión

    • Verifica que la instancia de n8n esté en ejecución
    • Comprueba el protocolo de URL (http/https)
    • Elimina la barra diagonal final de N8N_HOST

Mejores prácticas de seguridad

  1. Gestión de claves de API

    • Usa los permisos mínimos necesarios
    • Rota las claves regularmente
    • Nunca subas claves al control de versiones

  2. Acceso a la instancia

    • Usa HTTPS en producción
    • Habilita la autenticación de n8n
    • Mantén n8n actualizado

Soporte

Licencia

Licencia MIT