# n8n-mcp

n8n-mcp es un servidor Model Context Protocol (MCP) que otorga a asistentes de IA como Claude Desktop, Cursor y Windsurf acceso completo a más de 1.084 nodos de n8n, documentación, plantillas y herramientas de gestión, permitiéndoles construir, validar y desplegar de forma autónoma flujos de trabajo listos para producción.

Canonical URL: https://a2a-mcp.org/entry/n8n-mcp-es

Language: es

Category: MCP Servers

Updated: 2026-03-18

## Resumen

n8n-mcp es un servidor open-source Model Context Protocol (MCP) que conecta asistentes de codificación con IA a la plataforma de automatización de flujos de trabajo n8n. Proporciona a herramientas como Claude Desktop, Claude Code, Cursor, Windsurf y VS Code un conocimiento estructurado y en tiempo real de todo el ecosistema de n8n —incluyendo 537 nodos principales + 547 nodos comunitarios (1.084 en total), 2.709 plantillas de flujos de trabajo y lógica de validación específica para IA.

Construido como una aplicación ligera en Node.js con una base de datos SQLite integrada, ofrece respuestas en menos de 12 ms y funciona en modo stdio o HTTP. Conéctalo una sola vez y permite que tu IA construya, valide, pruebe y despliegue flujos de trabajo completos de n8n sin copiar y pegar ni configuración manual.

Hay una versión alojada con un Chat Agent listo para usar disponible en [n8n-mcp.com](https://www.n8n-mcp.com) (nivel gratuito + planes de pago), mientras que el repositorio de GitHub sigue siendo completamente autoalojable bajo la licencia MIT.

## Características principales

- **Base de conocimiento completa de nodos** — Acceso total a 1.084 nodos de n8n con 99 % de cobertura de propiedades, 63,6 % de cobertura de operaciones y 87 % de la documentación oficial (actualizada en menos de 48 horas tras nuevos lanzamientos de n8n).
- **Búsqueda inteligente y descubrimiento** — `search_nodes`, `get_node` (varios modos de detalle) y filtrado de nodos comunitarios por fuente (verificados/comunidad).
- **Ejemplos del mundo real** — 2.646 configuraciones extraídas previamente de plantillas populares.
- **Validación avanzada** — `validate_node` y `validate_workflow` con perfiles de agentes IA, comprobaciones en tiempo de ejecución y análisis de dependencias. Compatible con flujos de trabajo AI Agent de n8n v2.17+.
- **Motor de plantillas** — Busca y recupera más de 2.709 JSON de flujos de trabajo listos para usar con filtrado inteligente.
- **Herramientas de gestión de n8n** (conexión API opcional) — Crea, actualiza, prueba, ejecuta y corrige automáticamente flujos de trabajo directamente en tu instancia de n8n.
- **Rendimiento y compatibilidad** — ~12 ms de respuesta promedio, huella de memoria de 70–120 MB, compatible con cualquier versión de Node.js. Soporta modos stdio (Claude Desktop) y HTTP/SSE.
- **Privacidad y seguridad** — Telemetría anónima opcional (fácil de desactivar), sin credenciales codificadas, modos de seguridad para webhooks.

## Instalación y configuración

### Inicio rápido (npx – sin instalación)
```bash
npx n8n-mcp
```
Añádelo a tu `claude_desktop_config.json` de Claude Desktop con `MCP_MODE=stdio`.

### Docker (recomendado para producción)
```bash
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
```

### Nube (un clic)
Despliega gratis en Railway usando la plantilla del repositorio.

### Compilación local completa
```bash
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start
```

Variables de entorno opcionales: `N8N_API_URL`, `N8N_API_KEY` (para gestión directa de flujos), `LOG_LEVEL=error`, `MCP_MODE=stdio`.

## Asistentes de IA compatibles

- Claude Desktop / Claude Code
- Cursor
- Windsurf
- VS Code + Codex
- Antigravity
- Cualquier cliente compatible con MCP (más de 20 herramientas vía servicio alojado)

## Casos de uso

- **Creación de flujos impulsada por IA** — Describe “monitorear menciones en Twitter y publicar resúmenes en Slack con análisis de sentimiento” → la IA genera, valida y despliega el JSON completo.
- **Mantenimiento de flujos existentes** — La IA lee flujos en vivo, sugiere optimizaciones y aplica actualizaciones puntuales.
- **Exploración de plantillas** — Pide “la mejor plantilla de sincronización CRM usando nodos comunitarios” y recibe JSON listo para importar.
- **Automatización empresarial** — Conecta a instancias autoalojadas de n8n para generación segura y auditada de flujos a escala.
- **Aprendizaje y prototipado** — Usa herramientas de validación para enseñar a la IA las mejores prácticas antes del despliegue en producción.

## MCP nativo de n8n vs n8n-mcp

El servidor MCP nativo de n8n (disponible en versiones recientes) expone tus propios flujos como herramientas. n8n-mcp es un servidor MCP **externo** complementario enfocado en el **conocimiento de nodos de n8n** y la creación asistida por IA. Úsalos juntos para obtener el máximo potencial: servidor nativo para disparar flujos + n8n-mcp para construcción inteligente de flujos.

## Enlaces y recursos

- GitHub: [czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp)
- Chat Agent alojado y Dashboard: [n8n-mcp.com](https://www.n8n-mcp.com)
- Nivel gratuito: 100 llamadas a herramientas/día (alojado) o ilimitado si autoalojas
- Documentación y ejemplos en el repositorio

n8n-mcp convierte cualquier asistente de codificación con IA en un experto completo en flujos de trabajo de n8n —al instante.

## Tags

- mcp-server
- n8n
- ai-assistant
- workflow-automation
- claude-desktop
- cursor
- typescript
- node-js
- mcp
- automation

## Sources

- [Project website](https://github.com/czlonkowski/n8n-mcp)