n8n-mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Búsqueda de texto completo entre más de 500 nodos de n8n con esquemas
Validador de JSON del workflow — detecta configuraciones incorrectas antes de implantar
Biblioteca de plantillas + JSON obtenible para puntos de partida
Opcional: gestiona workflows en una instancia de n8n real (crear, actualizar, disparar, auditar)

Demo en vivo

Cómo se ve en la práctica

n8n-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "n8n-mcp",
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "n8n-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "n8n-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add n8n-mcp -- npx -y n8n-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: n8n-mcp

Construir un workflow de n8n a partir de una descripción en inglés simple

👤 Ingenieros de operaciones, hackers independientes que usan n8n ⏱ ~20 min intermediate

Cuándo usarlo: Sabes lo que quieres ('cada nuevo Typeform va a Notion + Slack') pero no quieres pasar 20 minutos haciendo clic en la UI de n8n.

Requisitos previos

Instancia de n8n (cloud o auto-hospedada) — Cualquier n8n en funcionamiento; necesaria solo para el paso de implantación, no para el diseño
N8N_API_URL + N8N_API_KEY — n8n Configuración → n8n API → crear clave API

Flujo

Busca nodos para cada paso

Quiero: webhook de Typeform → analizar → crear página de Notion → publicar en Slack. Busca los tipos de nodo exactos que necesito.✓ Copiado

→ Nombres de nodo + credenciales requeridas identificadas
Genera el JSON del workflow

Genera un workflow completo con esos 4 nodos conectados en orden. Usa una plantilla como base si hay una que coincida.✓ Copiado

→ JSON de workflow de n8n válido
Valida e implanta

Valida el JSON con validate_workflow. Corrige cualquier error. Luego implanta en mi n8n como borrador (no activo).✓ Copiado

→ El workflow aparece en la UI de n8n en estado de borrador

Resultado: Un workflow de n8n en funcionamiento, 10x más rápido que hacer clic manualmente, con validación que detecta errores de configuración antes de que presiones Ejecutar.

Errores comunes

Las credenciales deben configurarse primero en n8n — el JSON las referencia por ID — Crea entradas de credenciales en la UI de n8n antes de implantar; pasa los IDs de credencial al agente
El agente se implanta como activo e inmediatamente se dispara con datos históricos — Siempre implanta inactivo; activa manualmente después de probar en la UI de n8n

Audita tu instancia de n8n para detectar workflows rotos o peligrosos

👤 Responsables de operaciones que heredan una instancia de n8n ⏱ ~30 min intermediate

Cuándo usarlo: Asumiste el control de una instancia de n8n con 50 workflows, sin documentación. Necesitas saber qué hay y qué es arriesgado.

Flujo

Lista todos los workflows

Lista cada workflow con nombre, estado activo, última hora de ejecución y cantidad de nodos.✓ Copiado

→ Inventario completo
Marca patrones arriesgados

Encuentra workflows con: sin manejo de errores, webhooks disparadores sin autenticación, nodos HTTP Request a URLs aleatorias, o nodos de comando shell.✓ Copiado

→ Lista de riesgos con justificación
Verifica tasas de fallo

Para cada workflow activo, obtén las últimas 20 ejecuciones. Calcula la tasa de fallo. Marca cualquier cosa >20%.✓ Copiado

→ Lista de workflows rotos

Resultado: Un inventario de riesgo + salud — sabe qué corregir, congelar o eliminar.

Errores comunes

Deshabilitar un workflow del que dependen otros workflows (a través del nodo Execute Workflow) — Antes de deshabilitar, busca referencias al objetivo por ID en otros workflows

Comienza desde una plantilla y personalízala

👤 Nuevos usuarios de n8n ⏱ ~15 min beginner

Cuándo usarlo: Probablemente alguien ha construido algo cercano a lo que necesitas — úsalo como punto de partida.

Flujo

Busca plantillas

Encuentra plantillas que hagan: 'sincronizar un CSV a una base de datos con deduplicación'.✓ Copiado

→ 3-5 plantillas candidatas clasificadas por relevancia
Obtén y adapta

Obtén el JSON para la coincidencia principal. Adapta los nodos para usar mi base de datos real (Postgres en host X) y mi fuente CSV (bucket S3 Y).✓ Copiado

→ JSON de workflow personalizado
Valida e implanta

Valida, luego implanta como borrador en mi n8n.✓ Copiado

→ Workflow de borrador en n8n

Resultado: Un workflow en funcionamiento en 10 minutos aprovechándose del trabajo de otra persona.

Errores comunes

Las plantillas usan versiones de nodo obsoletas — Verifica el resultado de validate_workflow para advertencias de versión; canjea por nodos actuales

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

n8n-mcp + notion

Genera un scaffold de un workflow de n8n que escribe en una base de datos de Notion específica — busca el esquema de BD primero

Busca el esquema de la base de datos 'Leads' de mi Notion. Luego construye un workflow de n8n que tome entrada de webhook y cree entradas coincidentes.✓ Copiado

n8n-mcp + linear

Crea automáticamente tickets de Linear para fallos de workflow de n8n

Audita mi n8n para workflows que fallan >20% de las ejecuciones. Para cada uno, crea un bug en Linear.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
tools_documentation	tool_name?	Descubre herramientas disponibles	gratuito
search_nodes	query, limit?	Encuentra cuáles nodos de n8n coinciden con una necesidad	gratuito
get_node	node_type, mode?	Análisis profundo de un nodo específico antes de conectarlo	gratuito
validate_node	node JSON	Verifica la configuración de un solo nodo	gratuito
validate_workflow	workflow JSON	Siempre — antes de cualquier implantación	gratuito
search_templates	query/keywords/nodes	Encuentra trabajos anteriores antes de construir desde cero	gratuito
get_template	template_id	Obtén una plantilla elegida	gratuito
create_workflow / update_workflow / delete_workflow	requiere N8N_API_URL/KEY	Implanta o modifica en la instancia real	1 llamada a API de n8n
trigger_workflow / get_executions	workflow_id, data?	Prueba un workflow implantado	1 llamada a API de n8n
audit_instance		Revisión periódica de la instancia	múltiples llamadas a API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Herramientas de búsqueda/validación: ilimitadas (datos locales). Herramientas de gestión: limitadas por la capacidad de tu instancia de n8n.
Tokens por llamada: Los esquemas de nodos pueden ser grandes (2-5k tokens); usa get_node con mode='minimal' cuando solo necesites tipos
Monetario: MCP gratuito; n8n tiene un nivel cloud ($20+/mes) o auto-hospedado gratuitamente
Consejo: Diseña completamente con búsqueda/validación primero (gratuito). Solo llama create/update una vez que estés seguro — cada implantación cuesta un slot de cuota en n8n cloud

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: N8N_API_KEY en variable de entorno — trata como un token de administrador ya que puede crear workflows

Salida de datos: El MCP n8n-mcp en sí se ejecuta localmente. Las herramientas de gestión llaman a tu N8N_API_URL.

Resolución de problemas

Errores comunes y soluciones

Las herramientas de gestión no aparecen

N8N_API_URL o N8N_API_KEY no están configurados. Las herramientas de gestión solo se registran cuando ambas variables de entorno están presentes al iniciar.

Verificar: echo $N8N_API_URL && echo $N8N_API_KEY | cut -c1-6

validate_workflow pasa pero n8n rechaza en la implantación

Probablemente un problema de referencia de credencial. Las credenciales se validan contra los nombres en tu instancia de n8n — verifica que los nombres de credencial coincidan exactamente.

El workflow se implanta pero falla en la primera ejecución con 'Tipo de nodo no encontrado'

Estás usando un nodo de un paquete de comunidad no instalado en la instancia de n8n. Instálalo primero en n8n o canjea por un nodo central.

El JSON de plantilla usa versiones de nodo obsoletas

Después de obtener, pasa por validate_workflow — marca versiones obsoletas. Actualiza los nodos antes de implantar.

Alternativas

n8n-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
Zapier MCP	Tu equipo está en Zapier, no en n8n	Solo hospedado; menos control pero integraciones más pulidas
Make (Integromat) MCP	Tu equipo está en Make	Hospedado; el modelo de escenario difiere del modelo de gráfico de n8n
Raw n8n REST API	Quieres control a nivel de código desde un script personalizado	Sin catálogo de nodos ni validación — estás solo para la corrección

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills