Conecta tu IA a tu Infraestructura con MCP

Ya no se trata solo de crear workflows manualmente; ahora puedes dar a tu IA acceso directo y seguro a tu infraestructura n8n hospedada en AIBuildr.

Gracias al Model Context Protocol (MCP) y las herramientas desarrolladas por Mateusz Czlonkowski — n8n-mcp y n8n-skills — tu IA puede entender, leer y ejecutar tus workflows como un ingeniero experto.

¿Qué consigues con esto?

Ejecución Real: Tu IA puede ejecutar nodos, probar webhooks y consultar tu base de datos a través de n8n.
Privacidad Total: Tus credenciales y datos sensibles permanecen en tu instancia de AIBuildr. La IA solo recibe el contexto necesario.
Agentes Autónomos: Crea agentes que pueden “ver” tus herramientas y usarlas para resolver problemas complejos.

Herramienta 1: n8n-MCP Server

El puente que conecta tu IA con n8n. Este servidor MCP da a tu IA acceso a la documentación de más de 1.084 nodos de n8n (537 core + 547 comunidad) y, opcionalmente, a la gestión completa de workflows vía API REST.

Requisitos previos

Node.js instalado en tu ordenador local.
Tu URL de n8n (ej. https://n8n.tudominio.aibuildr.tech).
Una API Key de n8n (genérala en Settings > Public API).

Configuración por Herramienta

La configuración usa variables de entorno, no flags de línea de comandos. Las claves principales son:

Variable	Descripción
`MCP_MODE`	Obligatorio. Debe ser `"stdio"` para evitar errores JSON.
`N8N_API_URL`	URL de tu instancia n8n.
`N8N_API_KEY`	Tu API Key de n8n.
`LOG_LEVEL`	Recomendado: `"error"` para reducir ruido.
`DISABLE_CONSOLE_OUTPUT`	Recomendado: `"true"`.

IMPORTANT

La variable MCP_MODE: "stdio" es obligatoria. Sin ella verás errores tipo "Unexpected token..." en la interfaz de tu IA.

1. Claude Desktop

Edita tu archivo de configuración:

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

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://n8n.tudominio.aibuildr.tech",
        "N8N_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

Reinicia Claude Desktop. Verás un icono de enchufe 🔌 indicando la conexión.

2. Cursor (AI IDE)

Crea un archivo .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://n8n.tudominio.aibuildr.tech",
        "N8N_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

Después, ve a Cursor Settings > MCP y activa el servidor.

TIP

Puedes crear reglas de proyecto para que Cursor siempre tenga contexto de n8n. Consulta la guía de Cursor para más detalles.

3. Antigravity

Antigravity soporta MCP nativamente. Requiere instalar n8n-mcp de forma global:

npm install -g n8n-mcp

Luego:

Abre el chat de Antigravity y haz clic en los tres puntos ... > MCP Servers > Manage MCP Servers > View raw config.
Edita mcp_config.json con la siguiente configuración:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "node",
      "args": [
        "<RUTA_GLOBAL_A_n8n-mcp>/dist/mcp/index.js"
      ],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://n8n.tudominio.aibuildr.tech",
        "N8N_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

NOTE

Sustituye <RUTA_GLOBAL_A_n8n-mcp> por la ruta donde npm instaló el paquete globalmente. En Mac/Linux suele ser algo como /usr/local/lib/node_modules/n8n-mcp. Consulta la guía oficial de Antigravity para más detalles.

Vuelve a Manage MCP Servers y haz clic en Refresh. El servidor aparecerá como activo.

Herramienta 2: n8n-skills

Si n8n-mcp son las manos de la IA, n8n-skills es el entrenamiento cerebral. Es un conjunto de 7 skills complementarias para que Claude sepa cómo construir en n8n siguiendo las mejores prácticas.

Las 7 Skills

#	Skill	¿Para qué?
1	Expression Syntax	Sintaxis de expresiones `$json`, `$node`, `$now`
2	MCP Tools Expert	Uso correcto de las herramientas MCP (prioridad máxima)
3	Workflow Patterns	5 patrones arquitectónicos probados
4	Validation Expert	Interpretar errores de validación y solucionarlos
5	Node Configuration	Configuración de nodos complejos y dependencias
6	Code JavaScript	JavaScript en nodos Code de n8n
7	Code Python	Python en nodos Code (para el 5% de casos)

Instalación

Para Claude Code (recomendado):

# Instalar como plugin directamente
/plugin install czlonkowski/n8n-skills

Manual (cualquier entorno):

git clone https://github.com/czlonkowski/n8n-skills.git
cp -r n8n-skills/skills/* ~/.claude/skills/

TIP

Consulta el repositorio oficial de n8n-skills para instrucciones detalladas de instalación en Claude.ai y vía API/SDK.

Tu Infraestructura en AIBuildr

Para que todo esto funcione con latencia mínima y seguridad máxima, tu instancia de n8n debe ser robusta. En AIBuildr, tu n8n corre sobre una infraestructura optimizada, con backups automáticos y recursos dedicados — perfecto para soportar la carga de trabajo de tus agentes de IA.

TIP

Consejo Pro: Crea un usuario de API específico en n8n para tus agentes MCP. Así podrás auditar qué acciones ha realizado la IA en tus logs de ejecución.

Solución de Problemas

Error: “Unexpected token…”

Asegúrate de incluir "MCP_MODE": "stdio" en las variables de entorno de tu configuración. Sin esto, los logs de debug interfieren con el protocolo JSON-RPC.

Error: “Connection refused”

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

Error: “Invalid API Key”

Genera una nueva API Key en n8n:

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