Cómo Conectar n8n a Claude Code: Guía Completa con n8n-MCP y n8n-Skills

Conectar n8n a Claude Code te permite crear, editar y ejecutar workflows de automatización directamente desde tu asistente de IA usando el protocolo MCP (Model Context Protocol). Esta guía cubre la conexión del servidor MCP oficial de n8n y la instalación del paquete de skills n8n-skills que potencia la asistencia inteligente.

Requisitos previos

• n8n instalado (Cloud, self-hosted o local)
• Claude Code instalado
• Acceso de administrador a tu instancia de n8n

---

Parte 1 — Conectar n8n como servidor MCP

Paso 1: Obtener la URL del servidor MCP

En n8n, ve a Settings → MCP Server y copia tu URL base, que tiene la forma:

https://<tu-dominio-n8n>/mcp-server/http

Paso 2: Elegir el método de autenticación

Opción A — OAuth2 (Recomendado)

claude mcp add --transport http n8n-mcp https://<tu-dominio-n8n>/mcp-server/http

O edita ~/.claude/claude.json manualmente:

{
  "mcpServers": {
    "n8n-mcp": {
      "type": "http",
      "url": "https://<tu-dominio-n8n>/mcp-server/http"
    }
  }
}

Opción B — Token de acceso

1. En n8n ve a Settings → MCP Server → Generate Access Token
2. Copia el token generado
3. Ejecuta el siguiente comando:

claude mcp add --transport http n8n-mcp https://<tu-dominio-n8n>/mcp-server/http \
  --header "Authorization: Bearer <TU_TOKEN_MCP>"

O en claude.json:

{
  "mcpServers": {
    "n8n-mcp": {
      "type": "http",
      "url": "https://<tu-dominio-n8n>/mcp-server/http",
      "headers": {
        "Authorization": "Bearer <TU_TOKEN_MCP>"
      }
    }
  }
}

Paso 3: Verificar la conexión

Reinicia Claude Code y ejecuta /mcp. Deberías ver n8n-mcp listado como servidor conectado.

Paso 4: Habilitar workflows para acceso MCP

---

Parte 2 — Instalar n8n-skills

El repositorio czlonkowski/n8n-skills proporciona 14 skills especializadas que enseñan a Claude cómo construir workflows de n8n correctamente. Se activan automáticamente según el contexto sin necesidad de seleccionarlas manualmente.

Instalación desde Claude Code (recomendado)

/plugin install czlonkowski/n8n-skills

Instalación manual desde GitHub

# 1. Clonar el repositorio
git clone https://github.com/czlonkowski/n8n-skills.git

# 2. Registrar el marketplace local
claude plugin marketplace add "./n8n-skills/.claude-plugin/marketplace.json"

# 3. Instalar el plugin
claude plugin install n8n-mcp-skills

Las 14 Skills incluidas

#	Skill	Se activa cuando…
1	n8n Expression Syntax	Escribes expresiones {{}}, accedes a $json, $node
2	n8n MCP Tools Expert ⭐	Usas cualquier herramienta n8n-mcp
3	n8n Workflow Patterns	Creas o diseñas workflows
4	n8n Validation Expert	Hay errores de validación
5	n8n Node Configuration	Configuras parámetros de nodos
6	n8n Code JavaScript	Escribes código JS en nodos Code
7	n8n Code Python	Escribes código Python en nodos Code
8	n8n Code Tool	Creas herramientas para agentes IA
9	n8n Error Handling	Manejas errores, retries, fallos silenciosos
10	n8n Binary & Data	Trabajas con archivos, PDFs, imágenes
11	n8n Sub-workflows	Extraes lógica reutilizable
12	n8n AI Agents	Construyes agentes con LangChain nodes
13	n8n Multi-Instance	Tienes múltiples instancias de n8n
14	n8n Self-Hosting	Despliegas n8n en un servidor propio

---

Parte 3 — Uso combinado

Con el servidor MCP conectado y las skills instaladas, puedes pedirle a Claude Code:

“Crea un workflow de n8n que reciba un webhook, consulte una API REST y guarde los resultados en Google Sheets.”

“Encuentra el nodo de Slack y configúralo para enviar un mensaje cuando falle cualquier workflow.”

“Valida mi workflow y corrige los errores de expresión.”

Claude usará automáticamente las herramientas MCP de n8n y las skills relevantes para completar la tarea.

Herramientas MCP disponibles

Categoría	Herramientas
Descubrimiento de nodos	search_nodes, get_node
Validación	validate_node, validate_workflow, n8n_autofix_workflow
Gestión de workflows	n8n_create_workflow, n8n_update_partial_workflow, n8n_list_workflows, n8n_get_workflow
Ejecución	n8n_test_workflow, n8n_executions
Templates	search_templates, get_template, n8n_deploy_template
Credenciales	n8n_manage_credentials
Auditoría	n8n_audit_instance
Multi-instancia	n8n_instances

---

Solución de problemas

Problema	Solución
El servidor MCP no aparece en /mcp	Reinicia Claude Code y verifica la URL y el token
search_workflows no encuentra workflows	Habilita el acceso MCP en Settings del workflow
Errores de autenticación OAuth2	Usa el método de token de acceso como alternativa
Las skills no se activan	Reinicia la sesión de Claude Code tras instalar el plugin
INSTANCE_AMBIGUOUS en credenciales	Usa la skill n8n-multi-instance para seleccionar la instancia

---

Referencias

• 📖 Documentación oficial: Conectar n8n a MCP Server
• 🔧 Repositorio n8n-skills en GitHub
• 🤖 Repositorio n8n-mcp en GitHub

Guías relacionadas

Amplía tu ecosistema de Claude Code combinando n8n con estas integraciones:

• Instalar Royal MCP: WordPress + Claude Code — publica y gestiona WordPress desde los workflows que crees con n8n.
• Cómo instalar Claude SEO en Claude Code — añade auditorías SEO al mismo entorno de Claude Code.
• Integrar Microsoft Clarity con Claude AI vía MCP — automatiza el análisis de comportamiento y CRO de tu sitio.