Clase 06 · Módulo 11
Conectar Claude con tu n8n
Conectar Claude con tu n8n
Qué logras en esta clase
Dejas a Claude conectado a tu n8n y capaz de usar solo los flujos que tú elegiste.
- Activas el servidor MCP de la instancia.
- Habilitas flujos uno por uno y los describes.
- Conectas Claude.ai o Claude Code con OAuth.
- Sabes revocar el acceso.
02
Tus flujos pasan a ser herramientas de Claude
Con esta conexión le pides algo a Claude en lenguaje normal y Claude ejecuta el flujo de n8n que corresponde.
03
El recorrido completo
En esta dirección, Claude es el cliente MCP y tu n8n es el servidor. Es el sentido inverso al de un agente de n8n que usa herramientas externas.
04
Antes de empezar
- Rol de propietario o administrador en la instancia.
- Una versión reciente de n8n: el diálogo de conexión actual llegó en la 2.33.0. Mira la tuya contra las notas de versión.
- Para Claude.ai, una instancia alcanzable desde internet.
05
Paso 1: activar el servidor
- En n8n, entra a Settings > Instance-level MCP.
- Pulsa Enable MCP access.
Con eso el servidor existe, pero no ofrece nada todavía.
06
Nada queda expuesto por defecto
Activar el servidor no publica tus flujos. Cada flujo se habilita a mano, uno por uno.
07
Paso 2: habilitar flujos
| Desde dónde | Camino |
|---|---|
| Ajustes | Instance-level MCP > Workflows enabled > Enable workflows |
| El flujo abierto | Menú del flujo (...) > Settings > Available in MCP |
| La lista de flujos | Menú de la tarjeta > Enable MCP access |
| Proyecto o carpeta | Options > Manage MCP access |
La opción por proyecto o carpeta solo afecta a los flujos que ya están ahí.
08
Deja apagada la exposición automática
Existe el ajuste Auto-expose new workflows, que habilita solo los flujos nuevos. Viene apagado.
09
La descripción es lo que lee Claude
Cada flujo habilitado tiene una descripción editable desde el menú del flujo, en Edit description.
Escríbela con el criterio de la clase 3:
- Qué hace el flujo.
- Cuándo usarlo.
- Qué datos necesita.
- Qué devuelve y qué efectos tiene.
Sin descripción, Claude decide por el nombre del flujo.
10
Qué flujos conviene habilitar
| Buen candidato | Mal candidato |
|---|---|
| Consultas: buscar un cliente, ver ventas del día | Flujos a medio construir |
| Acciones internas reversibles: anotar una tarea | Envíos masivos a clientes |
| Flujos con aprobación humana incluida | Pagos o borrados sin aprobación |
Parte por flujos de lectura. Agrega los que actúan cuando ya confías en cómo Claude los elige.
11
Publicado o borrador
Al ejecutar un flujo, Claude usa por defecto el modo de producción: corre la versión publicada. Existe un modo manual que corre la versión actual del editor.
Si editaste un flujo y Claude sigue viendo el comportamiento antiguo, probablemente falta publicar (módulo 2).
12
Paso 3: conectar Claude.ai
- En Instance-level MCP, abre Connect.
- En la pestaña OAuth (recommended), elige Claude.ai en Your client.
- Usa One-click setup, o copia la Server URL (termina en
/mcp-server/http) y pégala como conector nuevo en Claude. - Cuando Claude te redirija a n8n, aprueba el acceso.
En Claude, los conectores de tu cuenta se administran en claude.ai/customize/connectors.
13
Paso 3, alternativa: Claude Code
- En el mismo diálogo, elige Claude Code dentro de los clientes de línea de comandos.
- Ejecuta en tu terminal el comando de instalación que muestra n8n.
- Completa el paso Authenticate y aprueba el acceso en n8n.
14
OAuth o clave
| OAuth | Clave (API key) | |
|---|---|---|
| Recomendado por n8n | Sí | Solo si el cliente no admite OAuth |
| Cómo se entrega | Apruebas en el navegador | Copias un token |
| Aparece en la tabla de clientes | Sí | No |
| Cómo se corta | Revocas ese cliente | Renuevas el token y el anterior deja de servir |
El token solo se muestra completo la primera vez. Guárdalo en un gestor de contraseñas, nunca en un flujo.
15
Lo que Claude puede hacer una vez dentro
- Buscar flujos: ve una vista previa de todos los que tu usuario puede ver.
- Leer el detalle y ejecutar los que habilitaste.
- Crear y editar flujos y tablas de datos (desde la 2.13.0).
- Gestionar agentes, en vista previa (desde la 2.34.0).
16
Claude también puede construir
Que Claude cree y edite flujos acelera el trabajo. Nada de lo que construya se publica sin que tú lo hayas revisado.
17
Revisar antes de publicar
Cuando Claude arme o modifique un flujo, haz lo mismo que con el código del módulo 3:
- Ábrelo en el editor y recorre los nodos.
- Revisa qué credenciales usa y con qué alcance.
- Ejecútalo con datos de prueba.
- Publica solo si entiendes cada paso.
18
Primera prueba
- Habilita un flujo de lectura con una descripción clara.
- En Claude, pide la lista de flujos disponibles en tu n8n.
- Pide una tarea que ese flujo resuelve, sin nombrarlo.
- En n8n, abre la pestaña Executions del flujo y confirma la corrida.
Si Claude eligió otro flujo o ninguno, mejora la descripción y repite.
19
Límites que debes conocer
- El acceso no se separa por cliente: todo cliente conectado ve todos los flujos habilitados, según los permisos de tu usuario.
- Los clientes en la nube necesitan llegar a tu instancia desde internet.
- Detrás de un proxy inverso, este debe dejar pasar las cabeceras
MCP-Protocol-Version,Mcp-MethodyMcp-Name.
Con n8n en tu computador, usa un túnel con nombre o un servidor (módulo 14); el túnel rápido cambia de dirección.
20
Si no conecta
| Síntoma | Qué revisar |
|---|---|
| Mensaje de permisos insuficientes al autorizar | Que el acceso MCP esté activado en la instancia |
| Claude no encuentra el flujo | Que tenga Available in MCP |
| Falla solo detrás de un proxy | Las tres cabeceras MCP |
| Claude.ai no llega | Que la dirección sea pública y estable |
21
Cerrar la puerta
| Qué cortar | Dónde |
|---|---|
| Un cliente | Connected clients > Revoke access; se desconecta al instante |
| Una clave | Renuévala; la anterior deja de servir |
| Todo | Connection details > MCP status > Disable |
| Retornos de OAuth | Access > Allowed callback URLs > Only trusted URLs |
En una instalación propia, la variable N8N_DISABLED_MODULES=mcp quita la función por completo.
22
Errores comunes
- Habilitar todos los flujos de un proyecto para «probar rápido».
- Dejar flujos sin descripción y culpar a Claude por elegir mal.
- Editar un flujo y olvidar publicarlo.
- Compartir la clave por chat o guardarla en una planilla.
23
Lo que te llevas
- El servidor se activa en Settings > Instance-level MCP y no expone nada por sí solo.
- Cada flujo se habilita a mano y su descripción guía a Claude.
- OAuth es la vía recomendada; la clave se guarda como una contraseña.
- Claude ejecuta la versión publicada; lo que cree o edite lo revisas tú antes de publicar.
- Revocar toma un clic: úsalo.
24
Hazlo ahora
Quince minutos, con tu instancia alcanzable desde internet.
- Activa el servidor MCP de la instancia.
- Habilita un solo flujo de lectura y escríbele su descripción.
- Conecta Claude con OAuth.
- Pídele una tarea que ese flujo resuelva y verifica la corrida en Executions.
- Revoca el acceso y confirma que Claude ya no puede usarlo. Vuelve a conectar si lo vas a seguir usando.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026