Docs

Conectar Claude Desktop y Cursor con AIBuildr (MCP)

Guía oficial para usar n8n hospedado en AIBuildr como backend nativo para tus Agentes de IA mediante Model Context Protocol (MCP).

Conecta tu IA a tu Infraestructura

AIBuildr está optimizado para funcionar como el “cerebro ejecutivo” de tus agentes de IA locales. Gracias al Model Context Protocol (MCP), puedes permitir que Claude Desktop o Cursor lean, editen y ejecuten workflows en tu servidor n8n privado de forma segura.

¿Por qué hacer esto?

  • Control Total: Tu IA no solo genera código, ahora puede ejecutar acciones reales (webhooks, base de datos, APIs).
  • Privacidad: Los datos sensibles se quedan en tu servidor AIBuildr, no en la nube de la IA.
  • Velocidad: Ejecuta tareas pesadas en tu VPS dedicado, no en tu ordenador local.

1. Configuración para Claude Desktop

Para que Claude pueda interactuar con tu instancia de n8n, necesitas añadir la configuración del servidor MCP.

  1. Abre el archivo de configuración de Claude:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Añade el siguiente bloque (asegúrate de tener tu API Key de n8n a mano):

{
  "mcpServers": {
    "aibuildr-n8n": {
      "command": "npx",
      "args": [
        "-y",
        "@n8n/mcp-server",
        "--n8n-url",
        "https://n8n.tudominio.aibuildr.tech",
        "--api-key",
        "tu-api-key-de-n8n-aqui"
      ]
    }
  }
}
  1. Reinicia Claude Desktop. Ahora verás un icono de “enchufe” 🔌 indicando que Claude está conectado a tu infraestructura.

2. Configuración para Cursor (AI IDE)

Cursor permite interactuar con tu servidor n8n directamente desde el editor de código, ideal para desarrolladores que están construyendo nodos personalizados.

  1. Ve a Cursor Settings > Features > MCP.
  2. Haz clic en + Add new MCP server.
  3. Rellena los datos:
    • Type: command
    • Name: AIBuildr n8n
    • Command: npx -y @n8n/mcp-server --n8n-url https://n8n.tudominio.aibuildr.tech --api-key tu-api-key

Solución de Problemas

Error: “Connection refused”

Asegúrate de que tu instancia de n8n en AIBuildr está activa y accesible públicamente. AIBuildr configura SSL automáticamente, así que asegúrate de usar https://.

Error: “Invalid API Key”

Genera una nueva API Key en n8n:

  1. Entra a tu panel n8n.
  2. Ve a Settings > Public API.
  3. Crea una nueva key y cópiala inmediatamente.