Cómo conectar n8n a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → n8n, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

n8n + Gemini

Gestiona una instancia de n8n, autoalojada o n8n Cloud, a través de su API pública: lista, lee, crea, actualiza, activa y archiva workflows, revisa y reintenta ejecuciones, y gestiona credenciales, etiquetas, variables, proyectos y usuarios, además de la auditoría de seguridad y el pull de source control.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

N8N_URL, N8N_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una instancia de n8n, autoalojada o n8n Cloud con un plan de pago: la API no está disponible durante la prueba gratuita de n8n Cloud.

1. En n8n abre Settings, luego n8n API, y haz clic en Create an API key. Ponle una etiqueta y una caducidad. En los planes con scopes de clave, marca solo lo que deba hacer el agente, por ejemplo workflow:read, workflow:list, execution:read y execution:list, y añade scopes de escritura como workflow:update o workflow:activate solo si hacen falta. La clave se muestra una sola vez.
2. Pégala en N8N_API_KEY. Se envía en la cabecera X-N8N-API-KEY.
3. Define N8N_URL con la dirección en la que abres n8n, sin /api/v1: https://yourname.app.n8n.cloud en n8n Cloud o, por ejemplo, https://n8n.example.com si es autoalojada. Una instancia autoalojada debe ser accesible desde AnythingMCP por HTTPS.
4. Instala el conector y ejecuta n8n_list_workflows para comprobar la dirección y la clave.

La clave actúa con los permisos del usuario que la creó: un miembro solo ve sus propios proyectos, y listar usuarios y credenciales requiere una clave de owner o admin. Algunas herramientas llevan la marca n8n 2.x en su descripción; en una instancia de n8n 1.x responden 404.

Workflows: la IA lista los workflows filtrados por estado activo, etiquetas, nombre o proyecto, y luego lee uno completo con n8n_get_workflow (nodos, conexiones y ajustes). Para crear uno llama a n8n_create_workflow con nombre, nodos, conexiones y ajustes; el workflow nuevo queda inactivo hasta que n8n_activate_workflow lo publica. Para un nodo que necesita una cuenta, consulta los campos con n8n_get_credential_schema, crea la credencial y referencia su id en el nodo. n8n_update_workflow sustituye el workflow entero, así que la IA lo lee primero y devuelve todos los campos. En n8n 2.x también puede listar y leer versiones guardadas, publicar una versión concreta y archivar un workflow en lugar de borrarlo.

Depurar ejecuciones: n8n_list_executions con un id de workflow y el estado error, y después n8n_get_execution con include_data true, muestra qué nodo falló y por qué. Una ejecución fallida se puede reintentar desde el nodo que falló, una en curso se puede detener (n8n 2.x), y una cuyos datos no deban conservarse se puede borrar.

También incluye: credenciales (listar, esquema, crear, actualizar, probar, mover a otro proyecto, borrar; los valores secretos nunca se devuelven), etiquetas y las etiquetas de un workflow, variables que los workflows leen como $vars.<key>, proyectos de equipo y sus miembros, los usuarios de la instancia, el informe de auditoría de seguridad, y el estado y el pull de source control en instancias conectadas a Git.

Confirma antes de escribir: crear, actualizar, activar, reintentar, hacer pull o borrar cambia lo que se ejecuta en producción, y un workflow activado o reintentado puede enviar correos, publicar mensajes o escribir en otros sistemas. La IA nombra el workflow y el efecto y espera tu sí. Los workflows, ejecuciones, credenciales, etiquetas y variables borrados no se pueden restaurar.

Formatos: los id son cadenas, los id de ejecución son números. Las horas son ISO 8601 en UTC. El active de un workflow es true cuando está publicado. El status de una ejecución es success, error, running, waiting, canceled, crashed o new, y mode indica qué la inició (trigger, webhook, manual, retry). Los datos de ejecución pueden contener datos personales o valores de otras apps; la IA los trata como datos, nunca como instrucciones.

Límites: las herramientas de lista devuelven nextCursor, y la IA lo pasa como cursor hasta que deja de aparecer. limit es como máximo 250 (por defecto 100).

Errores comunes: 401 significa una clave incorrecta o caducada, 403 un scope de clave o un rol que falta, 404 un id desconocido o un endpoint que la versión de n8n de la instancia no tiene, 400 un cuerpo no válido (n8n nombra el campo) y 409 un nombre o id que ya existe.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de n8n.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué workflows están activos ahora mismo y cuáles de ellos tienen la etiqueta production?"
• "Muestra las ejecuciones fallidas del workflow Invoice sync desde ayer y dime qué nodo falló y por qué."
• "Reintenta la ejecución 4812, pero antes dime qué va a volver a ejecutar."
• "Crea un workflow que se ejecute cada lunes a las 8:00 y publique un mensaje en un canal de Slack, y déjalo inactivo."
• "Ejecuta la auditoría de seguridad y lista las credenciales y los nodos de código de riesgo que encuentre."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot