Acceder al servidor MCP de n8n

Acceder al servidor MCP de n8n

Conecta clientes MCP compatibles a tus flujos de trabajo de n8n mediante el servidor MCP integrado en n8n.

Este servidor permite que clientes como Lovable o Claude Desktop se conecten de forma segura a tu instancia de n8n. Una vez conectados, estos clientes pueden:

• Buscar en flujos de trabajo marcados como disponibles para MCP
• Obtener metadatos e información de disparadores de los flujos de trabajo
• Disparar y ejecutar flujos de trabajo habilitados

Diferencias entre el acceso MCP a nivel de instancia y el nodo MCP Server Trigger

El acceso MCP a nivel de instancia te permite crear una única conexión por instancia de n8n, con autenticación centralizada, y seleccionar qué flujos de trabajo estarán accesibles. Los flujos de trabajo habilitados pueden encontrarse y ejecutarse fácilmente sin necesidad de configurar cada uno individualmente.

Por otro lado, el nodo MCP Server Trigger se configura dentro de un único flujo de trabajo. Este nodo expone únicamente las herramientas de ese flujo específico a MCP, lo cual resulta útil cuando deseas personalizar el comportamiento del servidor MCP dentro de un flujo determinado.

Consideraciones importantes al usar el acceso MCP a nivel de instancia

• Esto no es una forma de construir ni editar flujos de trabajo mediante clientes de IA; la creación de flujos de trabajo se realiza exclusivamente en n8n.
• No expone automáticamente todos los flujos de trabajo de tu instancia; primero debes habilitar MCP a nivel de instancia y luego activarlo explícitamente para cada flujo de trabajo.
• El alcance no se diferencia por cliente MCP: cualquier cliente conectado podrá ver todos los flujos de trabajo que hayas habilitado para acceso MCP.

Habilitar el acceso MCP

Para instancias en Cloud y autohospedadas

1. Navega a Configuración > MCP a nivel de instancia
2. Activa Habilitar acceso MCP (requiere permisos de propietario o administrador de la instancia).

Una vez habilitado, verás:

1. Lista de flujos de trabajo abiertos a clientes MCP
2. Lista de clientes OAuth conectados
3. Interruptor principal de MCP para habilitar/deshabilitar el acceso a nivel de instancia
4. Botón Detalles de conexión, que muestra instrucciones detalladas para conectar clientes MCP

Deshabilitar: simplemente desactiva el interruptor principal de MCP.

Para usuarios autohospedados: deshabilitación completa

Para eliminar completamente esta funcionalidad, establece la siguiente variable de entorno:

N8N_DISABLED_MODULES=mcp

Esta acción eliminará los endpoints de MCP y ocultará todos los elementos de interfaz relacionados.

Configurar la autenticación MCP

El menú emergente Detalles de conexión ofrece dos opciones de autenticación para clientes MCP:

• OAuth2
• Token de acceso (Access Token)

Usar OAuth2

Desde la pestaña OAuth, copia la URL de tu servidor de instancia y úsala para configurar tu cliente MCP. Tras la conexión, el cliente te redirigirá a n8n para autorización.

Revocar el acceso del cliente

Para revocar el acceso de un cliente MCP ya conectado:

1. Ve a Configuración > MCP a nivel de instancia.
2. Cambia a la pestaña Clientes conectados, donde verás una tabla con los clientes OAuth conectados.
3. Usa el menú de acciones en la fila de cada cliente para revocar su acceso.

Usar token de acceso

Utiliza la URL de tu servidor de instancia junto con el token personal de acceso MCP que encontrarás en la pestaña Token de acceso del menú Detalles de conexión.

La primera vez que accedas a la página de acceso MCP, n8n generará automáticamente un token personal vinculado a tu cuenta de usuario.

Importante

Copia inmediatamente tu token. En futuras visitas solo verás un valor enmascarado y el botón de copia estará deshabilitado.

Rotar el token

Si pierdes tu token o necesitas renovarlo:

1. Ve a Configuración > MCP a nivel de instancia.
2. Haz clic en el botón de la esquina superior derecha para abrir el menú Detalles de conexión.
3. Cambia a la pestaña Token de acceso.
4. Usa el botón junto al valor enmascarado para generar un nuevo token.

Al generar un nuevo token, n8n revocará automáticamente el anterior.

5. Actualiza todos los clientes MCP conectados con el nuevo valor.

Abrir flujos de trabajo a clientes MCP

Requisitos de elegibilidad

Para que un flujo de trabajo sea accesible desde clientes MCP, debe cumplir las siguientes condiciones:

1. Estar publicado
2. Contener al menos uno de los siguientes nodos disparadores:
   • Webhook
   • Programación
   • Chat
   • Formulario

Por defecto, ningún flujo de trabajo es visible para clientes MCP. Debes habilitar explícitamente el acceso para cada flujo de trabajo que cumpla los requisitos.

Al evaluar la elegibilidad, n8n considera únicamente la versión publicada del flujo de trabajo. Si añades un disparador compatible en una versión de borrador, no se considerará elegible hasta que publiques esa versión.

Importante

Al despublicar un flujo de trabajo, n8n elimina automáticamente su acceso MCP. Si vuelves a publicarlo, deberás volver a habilitar el acceso.

Habilitar el acceso

Método 1: Desde la página de configuración MCP (disponible en n8n v2.2.0+)

1. Haz clic en el botón Habilitar flujos de trabajo (visible en la cabecera de la tabla o en estado vacío)
2. Busca el flujo de trabajo deseado (por nombre o descripción) y selecciónalo en la lista
3. Confirma haciendo clic en Habilitar

Método 2: Desde el editor de flujos de trabajo

1. Abre el flujo de trabajo.
2. Haz clic en el menú principal del flujo de trabajo (los tres puntos ...) en la esquina superior derecha.
3. Selecciona Configuración.
4. Activa la opción Disponible en MCP.

Método 3: Desde la lista de flujos de trabajo

1. Ve a Flujos de trabajo.
2. Abre el menú de la tarjeta del flujo de trabajo.
3. Selecciona Habilitar acceso MCP.

Gestionar permisos de acceso

La página de MCP a nivel de instancia muestra todos los flujos de trabajo disponibles para clientes MCP. Desde esta lista puedes:

• Abrir directamente el flujo de trabajo, su proyecto o carpeta padre
• Revocar el acceso mediante el menú de acciones (o usando Deshabilitar acceso MCP en el menú de la tarjeta)
• Actualizar la descripción del flujo de trabajo (o desde el menú del editor de flujos de trabajo)
• Habilitar el acceso para más flujos de trabajo usando el botón Habilitar flujos de trabajo (disponible en n8n v2.2.0+)

Descripción de flujos de trabajo

Para ayudar a los clientes MCP a identificar los flujos de trabajo, puedes añadir una descripción en texto libre de la siguiente manera:

1. Método 1: Desde la página MCP a nivel de instancia
   1. Ve a Configuración > MCP a nivel de instancia.
   2. Asegúrate de estar en la pestaña Flujos de trabajo.
   3. Usa el menú de acciones en la fila del flujo de trabajo objetivo y selecciona Editar descripción.
   4. Alternativamente, haz clic directamente en el texto de la descripción para abrir el diálogo de edición.
2. Método 2: Desde el editor de flujos de trabajo
   1. Abre el flujo de trabajo.
   2. Haz clic en el menú principal del flujo de trabajo (...) en la esquina superior derecha.
   3. Selecciona Editar descripción.

Ejecutar flujos de trabajo mediante clientes MCP

Los clientes MCP pueden ejecutar flujos de trabajo elegibles según tus solicitudes. Cuando un cliente dispara un flujo de trabajo, este se ejecuta en n8n como siempre, y puedes supervisar su ejecución en la lista de Registros de ejecución. Una vez finalizada la ejecución, el cliente MCP recibe los resultados.

Proporcionar datos de entrada

Normalmente, los clientes MCP pueden evaluar las entradas requeridas por el flujo de trabajo. Si usas un disparador Webhook y notas que el cliente tiene dificultades para determinar las entradas correctas, te recomendamos incluir esta información en la descripción del flujo de trabajo.

Tiempo de espera de flujos de trabajo

n8n aplica un tiempo de espera forzado de 5 minutos para las ejecuciones disparadas por clientes MCP. Si el flujo de trabajo no finaliza a tiempo, n8n detendrá la ejecución y enviará un error al cliente MCP, ignorando cualquier tiempo de espera que hayas configurado específicamente para ejecuciones MCP en la configuración del flujo de trabajo.

Limitaciones

• Si un flujo de trabajo contiene múltiples disparadores compatibles, el cliente MCP podría usar solo uno de ellos (normalmente el primero).
• No se admiten flujos de trabajo con formularios multietapa ni ningún tipo de interacción humana.
• No se admiten datos binarios de entrada; los clientes MCP solo pueden proporcionar entradas basadas en texto.

Ejemplos

Conectar Lovable al servidor MCP de n8n

1. Configura el servidor MCP en Lovable (OAuth).
   • Ve a Configuración > Integraciones de tu espacio de trabajo.
   • En la sección Servidores MCP, busca n8n y haz clic en Conectar.
   • Introduce la URL de tu servidor n8n (mostrada en la página Acceso MCP).
   • Guarda la conexión. Si tiene éxito, n8n te redirigirá para autorizar a Lovable.
2. Verifica la conexión.
   • Tras conectarte, Lovable podrá consultar los flujos de trabajo con acceso MCP habilitado.
   • Ejemplo: Pide a Lovable que cree una interfaz para listar usuarios y permitir su eliminación.

Conectar Claude Desktop al servidor MCP de n8n

Usando OAuth2

1. En Claude Desktop, ve a Configuración > Conectores.
2. Haz clic en Añadir conector personalizado.
3. Introduce los siguientes detalles:
   • Nombre: n8n MCP
   • URL del servidor MCP remoto: tu URL base de n8n (mostrada en la página MCP a nivel de instancia)
4. Guarda el conector.
5. Cuando se te solicite, autoriza a Claude Desktop a acceder a tu instancia de n8n.

Usando token de acceso

Importante

Esta operación requiere la última versión de Node.js.

Añade la siguiente entrada a tu archivo claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://<YOUR_N8N_HOST>/mcp-server/http",
        "--header",
        "authorization: Bearer <YOUR_TOKEN>"
      ]
    }
  }
}

Reemplaza:

• <YOUR_N8N_HOST>: tu URL base de n8n (mostrada en la página MCP a nivel de instancia)
• <YOUR_TOKEN>: tu token generado

Conectar Claude Code al servidor MCP de n8n

Usa el siguiente comando CLI:

claude mcp add --transport http n8n-mcp https://<YOUR_N8N_HOST>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_TOKEN>"

Alternativamente, añade la siguiente entrada a tu archivo claude.json (reemplazando los marcadores de posición como se indicó anteriormente).

Conectar Codex CLI al servidor MCP de n8n

Añade la siguiente entrada a tu archivo ~/.codex/config.toml:

[mcp_servers.n8n_mcp]
command = "npx"
args = [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<YOUR_N8N_HOST>/mcp-server/http",
    "--header",
    "authorization:Bearer <YOUR_TOKEN>"
]

(Reemplaza los marcadores de posición con tu URL base de n8n y tu token generado.)

Conectar un agente de Google ADK al servidor MCP de n8n

A continuación, un ejemplo de código para crear un agente que se conecte a un servidor MCP remoto de n8n:

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://localhost:5678"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={"Authorization": f"Bearer {N8N_MCP_TOKEN}"},
            ),
        )
    ],
)

Para más detalles, consulta Connect ADK agent to n8n.

Solución de problemas

Si tienes problemas al conectar un cliente MCP a tu instancia de n8n, considera los siguientes puntos:

• Si usas un cliente MCP basado en la nube, asegúrate de que tu instancia de n8n sea accesible públicamente.
• Verifica que el acceso MCP esté habilitado en la configuración de n8n.
• Comprueba que el flujo de trabajo que deseas acceder esté marcado como disponible en MCP.
• Confirma que el método de autenticación en el cliente MCP (OAuth2 o token de acceso) esté correctamente configurado.
• Revisa los registros del servidor de n8n en busca de errores relacionados con conexiones MCP.
• Si usas un cliente MCP de escritorio, asegúrate de tener instalada la última versión de Node.js.