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

Por qué usarlo

Características clave

CRUD completo de flujos de trabajo + gestión del ciclo de vida
Ejecuta flujos de trabajo manualmente desde el agente
Obtén historial de ejecuciones y registros para depuración
Auditoría de seguridad vía generate_audit

Demo en vivo

Cómo se ve en la práctica

n8n-workflow-builder.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-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

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-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

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-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder

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

Casos de uso

Usos del mundo real: n8n-workflow-builder

Construye un flujo de trabajo de n8n desde una descripción en lenguaje natural

👤 PMs sin código, fundadores en solitario, operaciones internas ⏱ ~20 min intermediate

Cuándo usarlo: Quieres un flujo webhook → Slack → Google Sheet sin arrastrar nodos.

Requisitos previos

Instancia de n8n ejecutándose con API habilitada — docker run n8nio/n8n; habilitar N8N_API en env
Clave API — n8n Settings → API Keys

Flujo

Describe el flujo

Crea un flujo de trabajo de n8n: cuando un webhook toca /signup, publica el payload en Slack #signups y añade una fila a la hoja 'Signups'.✓ Copiado

→ Flujo de trabajo creado con 3 nodos conectados
Activa

Activa el flujo de trabajo y devuelve la URL del webhook de producción.✓ Copiado

→ Activo + URL
Prueba rápida

Ejecútalo una vez con un payload de muestra, luego obtén el registro de ejecución.✓ Copiado

→ Ejecución exitosa o fallo identificable

Resultado: Una automatización en ejecución en pocos prompts en lugar de una mañana en el editor.

Errores comunes

Las credenciales no están configuradas en los nodos recién creados — MCP no puede crear secretos por ti — añade credenciales de Slack/Google en la UI de n8n una vez, refiere por nombre

Combinar con: google-sheets

Depura un flujo de trabajo de n8n que falla desde el historial de ejecuciones

👤 Ingenieros de operaciones que mantienen automatización ⏱ ~25 min intermediate

Cuándo usarlo: Un flujo de trabajo nocturno está fallando y quieres triarlo desde el chat.

Flujo

Obtén fallas recientes

list_executions para el flujo de trabajo 'nightly-export' con status=error en los últimos 7 días.✓ Copiado

→ Lista con fechas y fragmentos de errores
Inspecciona el peor

get_execution en la falla más reciente. Muéstrame la entrada y el error del nodo que falla.✓ Copiado

→ Pista de causa raíz
Parcha y redeploy

Actualiza el flujo de trabajo para manejar valores nulos en el nodo de transformación. Luego desactiva+activa para recargar.✓ Copiado

→ Las ejecuciones posteriores tienen éxito

Resultado: Interrupción resuelta sin abrir el editor.

Ejecuta una auditoría de seguridad en tus flujos de trabajo de n8n

👤 Equipos de seguridad + operaciones ⏱ ~15 min intermediate

Cuándo usarlo: Antes de ir a producción, o trimestralmente, quieres un informe de estilo de cumplimiento.

Flujo

Genera auditoría

Usa generate_audit en mi instancia de n8n. Resume los hallazgos en: credenciales, exposición de webhook y problemas de permisos de nodos.✓ Copiado

→ Informe de auditoría estructurado
Registra los elementos riesgosos

Para cada hallazgo de gravedad alta, crea un problema en Linear/GitHub con remediación.✓ Copiado

→ Problemas creados

Resultado: Automatización trimestral de higiene de seguridad.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

n8n-workflow-builder + google-sheets

Automatizaciones de webhook a hoja construidas y monitoreadas desde el chat

Crea un flujo de trabajo de n8n que añada payloads a mi hoja 'Leads'; verifica que funcione de extremo a extremo.✓ Copiado

n8n-workflow-builder + sentry

Alerta de Sentry → flujo de trabajo de n8n → cadena de respuesta ante incidentes

Cuando Sentry ve un pico en el proyecto X, dispara mi flujo de trabajo de n8n 'incident-page' vía execute_workflow.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_workflows		Descripción general	1 llamada API
get_workflow	id	Inspecciona nodos	1 llamada API
create_workflow	name, nodes[], connections	Nueva automatización	1 llamada API
execute_workflow	id, payload?	Disparo manual / prueba	n8n CPU + descendente
activate_workflow	id	Envía a producción	1 llamada API
deactivate_workflow	id	Mantenimiento / reversión	1 llamada API
update_workflow	id, changes	Parcha nodos	1 llamada API
delete_workflow	id	Retira	1 llamada API
list_executions	workflow_id?, status?	Triage	1 llamada API
get_execution	execution_id	Causa raíz	1 llamada API
generate_audit		Revisión de seguridad	1 llamada API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: n8n en sí no tiene límite de velocidad de API más allá de la capacidad de tu propio servidor
Tokens por llamada: JSON de flujo de trabajo puede ser grande — 2-10k tokens por get_workflow en flujos complejos
Monetario: Gratuito si es autohospedado; n8n Cloud facturado por ejecución
Consejo: Usa list_workflows primero, evita get_workflow en flujos enormes a menos que necesites detalles de nodos

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: N8N_API_KEY en env — otorga acceso completo a la API, ajusta el ámbito en consecuencia

Salida de datos: Solo a tu N8N_HOST

Resolución de problemas

Errores comunes y soluciones

401 No autorizado

Clave API incorrecta o la clave carece de permisos — regenera en la UI de n8n

Verificar: curl -H 'X-N8N-API-KEY: <key>' $N8N_HOST/api/v1/workflows

Flujo de trabajo creado pero falla al ejecutarse

Nodos sin credenciales — adjúntalos en la UI después de la creación; MCP no puede configurar secretos

execute_workflow se cuelga

Flujo de larga duración — usa activate + disparador webhook en lugar de ejecución síncrona

Alternativas

n8n-workflow-builder vs otros

Alternativa	Cuándo usarla	Contrapartida
API REST de n8n Directo	Estás escribiendo scripts, no chateando	Escribes la plomería
Zapier MCP	Estás en Zapier, no en n8n	Ecosistema diferente; pagado

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills