# Instrucciones para el agente: n8n-MCP: documentación y validación de flujos para tu agente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/czlonkowski/n8n-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/n8n-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara Node.js y el cliente

Comprueba que Node.js cumple ≥22.23.4 y <23, ≥24.22.1 y <25, o ≥26.12.1, según el [package.json oficial](https://github.com/czlonkowski/n8n-mcp/blob/main/package.json), y que npm/npx está en PATH. Abre el cliente MCP elegido y sigue docs/SELF_HOSTING.md. Para la primera prueba usa únicamente las herramientas de documentación.

### Paso 2: configura MCP

Configuración básica de Claude Desktop, copiada de la guía oficial del proyecto:

```json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}
```

Para Claude Code, Codex o Cursor usa la guía de ese cliente enlazada en Connect your IDE del README. No pegues JSON de Desktop en un cliente que espere TOML.

### Paso 3: reinicia y consulta

Reinicia el cliente. Pide al agente que consulte `tools_documentation()` y busque un nodo para una automatización de prueba. Después solicita una validación del flujo propuesto.

## Comprobación

Comprueba que el cliente ve el servidor y recibe detalles de un nodo. La configuración básica no debe disponer de acceso para modificar una instancia n8n.

## Si algo falla

Revisa Node.js, la ruta de npx y los registros del cliente. Para stdio conserva los ajustes que evitan salida adicional por consola. Si añades gestión de n8n más adelante, sigue SELF_HOSTING.md y no confundas N8N_API_KEY con N8N_MCP_ACCESS_TOKEN.