MCP Server Trigger de n8n: URL, configuración de Claude y ejemplos

El MCP Server Trigger de n8n convierte un flujo de trabajo común en un servidor MCP al que Claude puede llamar. Añades el nodo, conectas unos cuantos nodos de herramienta, copias una URL y Claude puede de pronto leer una hoja de cálculo, publicar en Slack, ejecutar un subflujo o iniciar un trabajo de imagen, sin escribir código de servidor. Tres detalles deciden si eso funciona o falla en silencio: qué URL copias, cómo la proteges y cómo se conecta Claude a ella.

Este artículo aclara los tres. Obtienes un archivo de configuración que puedes pegar, cuatro flujos de trabajo de ejemplo, una tabla con los fallos que más aparecen y los nombres exactos de las opciones que n8n usa en el editor, tomados de la documentación del nodo.

Qué hace realmente el trigger

La mayoría de los triggers de n8n inician un flujo de trabajo y pasan datos al siguiente nodo. El MCP Server Trigger funciona de otra manera. No pasa datos hacia abajo. Solo se conecta a nodos de herramienta y los expone a cualquier cliente MCP que conozca su URL. Cuando Claude pregunta qué puede hacer el servidor, n8n responde con la lista de herramientas conectadas. Cuando Claude elige una, n8n la ejecuta y devuelve el resultado.

Eso hace que el lienzo se parezca más a una definición de API que a una automatización. Cada herramienta es una capacidad, y el nombre de la herramienta junto con su descripción es lo que Claude lee para decidir cuándo usarla. El nodo habla Server-Sent Events (SSE) y streamable HTTP. No admite stdio, por eso Claude Desktop necesita un pequeño puente, que se muestra más adelante.

Un nodo, muchas herramientas

Conecta tantos nodos de herramienta como necesites: Google Sheets Tool, Gmail Tool, HTTP Request Tool, Code Tool, Calculator o la Custom n8n Workflow Tool, que llama a otro flujo de trabajo. Esta última es la que más importa en la práctica. Te permite mantener la lógica pesada en flujos de trabajo normales y exponer solo un punto de entrada ligero y con un nombre claro.

💡 Nombra las herramientas como verbos y describe cada una en una frase sencilla. "find_order: busca un pedido por su número y devuelve el estado y la fecha de envío" es mejor que "orders_tool" en todos los casos, porque Claude elige las herramientas solo a partir de ese texto.

Trigger de servidor frente a herramienta cliente

n8n incluye dos nodos MCP que la gente suele confundir. Van en direcciones opuestas.

Si quieres que Claude use n8n, necesitas el trigger. Si quieres que un agente de n8n use las herramientas de otro, necesitas la herramienta cliente.

Encontrar la URL MCP correcta

Abre el trigger y verás dos URL en la parte superior del panel del nodo. Copiar la equivocada es el error más común al empezar, y produce el síntoma más confuso: todo funciona mientras el editor está abierto y deja de funcionar en cuanto lo cierras.

URL de prueba frente a URL de producción

Si apuntas a Claude a la URL de prueba, la demo funciona y se rompe en cuanto sales de la pestaña. Si la apuntas a la URL de producción, el flujo de trabajo responde en todo momento, y cada llamada queda registrada en Executions, donde puedes revisar las entradas y las salidas.

💡 Copia la URL directamente desde el nodo en lugar de escribirla. En la mayoría de las instalaciones, la dirección de producción tiene este aspecto https://n8n.example.com/mcp/your-path, y la de prueba cambia /mcp/ por /mcp-test/. Toma esa forma como una pista y confía en lo que muestre el nodo.

Elige una ruta estable

El parámetro Path llega con una cadena aleatoria para que dos flujos de trabajo nunca coincidan. Puedes reemplazarlo por algo legible, incluidos los parámetros de ruta, para que tu configuración de Claude sobreviva a una reconstrucción del flujo de trabajo. Usa una ruta por asistente: orders-assistant, support-lookup, image-studio.

Otra regla que confunde a la gente: un flujo de trabajo inactivo no atiende solicitudes MCP. Si Claude se conecta pero no ve herramientas, comprueba antes que nada que el flujo de trabajo esté publicado.

Bloquéalo con autenticación Bearer

El trigger ofrece tres opciones de Authentication: None, Bearer auth y Header auth. None sirve para una prueba desechable en tu equipo portátil. Cualquier cosa accesible desde fuera de una red de confianza necesita una de las otras dos, porque una URL MCP pública sin autenticación es un botón público que ejecuta tus flujos de trabajo.

Bearer o autenticación por cabecera

Con Bearer auth, el cliente envía una cabecera Authorization: Bearer <token>. Con Header auth, tú eliges el nombre y el valor de la cabecera, por ejemplo X-MCP-Token. Elige Bearer salvo que una pasarela delante de n8n ya espere una cabecera personalizada.

1. Abre el trigger y pon Authentication en Bearer auth.
2. Crea una credencial y pega un token aleatorio largo. openssl rand -hex 32 genera uno bueno.
3. Guarda el token en un gestor de contraseñas. Lo volverás a necesitar para la configuración de Claude.
4. Guarda y vuelve a publicar el flujo de trabajo para que el cambio entre en vigor.

Mantén corta la lista de herramientas

Cada herramienta conectada es algo que un prompt puede activar. Un modelo que puede leer filas y también borrarlas acabará borrando una cuando una petición sea ambigua. Asigna a cada asistente un conjunto reducido de herramientas, de solo lectura siempre que sea posible, y fija los parámetros arriesgados, como el canal de Slack o el ID de la hoja de cálculo, en lugar de dejar que Claude los elija.

El modelo del otro extremo también importa. Los modelos sólidos para llamar herramientas, como Claude Sonnet 5 y Claude Fable 5, son buenos compañeros de prueba en PicassoIA: pega las descripciones de tus herramientas en un chat, envía diez peticiones de ejemplo y comprueba qué herramienta elegiría el modelo en cada caso. Reescribe cualquier descripción que provoque una elección errónea antes de tocar el flujo de trabajo.

Conecta Claude a tu servidor

Claude llega a un servidor MCP por tres puertas diferentes, y cada una necesita la misma URL de producción envuelta de una forma ligeramente distinta.

Claude Desktop con mcp-remote

Claude Desktop inicia servidores stdio locales, y el trigger no habla stdio. El paquete mcp-remote se sitúa en medio y hace la traducción. Abre el archivo de configuración (en Windows %APPDATA%\Claude\claude_desktop_config.json, en macOS ~/Library/Application Support/Claude/claude_desktop_config.json) y añade esta entrada:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://n8n.example.com/mcp/orders-assistant",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "paste-your-bearer-token-here"
      }
    }
  }
}

Copiar prompt

El token vive en env y el argumento de la cabecera lo referencia, de modo que el argumento sigue siendo una única cadena limpia. Necesitas tener Node.js instalado porque npx descarga el puente en el primer inicio. Cierra por completo Claude Desktop, vuelve a abrirlo y las herramientas aparecerán en el menú de herramientas de un chat nuevo.

Claude Code desde la terminal

Claude Code puede conectarse directamente a servidores remotos, así que no hace falta puente:

claude mcp add --transport http n8n https://n8n.example.com/mcp/orders-assistant \
  --header "Authorization: Bearer YOUR_TOKEN"

Copiar prompt

Usa --transport http para streamable HTTP. Si tu versión de n8n solo expone el endpoint SSE más antiguo, cambia el flag a --transport sse. Ejecuta claude mcp list para confirmar que el servidor aparece como conectado y luego pídele a Claude Code que "liste las herramientas de n8n" como primera comprobación.

Conectores personalizados en claude.ai

En claude.ai, abre la configuración de conectores y añade un conector personalizado con la URL de producción. Las peticiones salen desde el lado de Anthropic, no desde tu equipo portátil, así que la dirección debe ser accesible desde internet por HTTPS. Una dirección localhost o una IP privada no funcionará. Pon n8n detrás de un proxy inverso o de un túnel antes.

💡 n8n documenta una peculiaridad: claude.ai pide iniciar sesión aunque el trigger tenga la autenticación desactivada, porque asume que cada endpoint MCP usa autenticación de usuario. Que aparezca una petición de inicio de sesión no significa que el trigger esté mal configurado.

Cuatro ejemplos que vale la pena construir

Cada ejemplo siguiente es un nodo de herramienta conectado al mismo trigger. Empieza por el primero, confirma que Claude puede llamarlo y luego añade el resto uno a uno.

Buscar filas en Sheets

Conecta una Google Sheets Tool, pon la operación en obtener filas y filtra la columna del número de pedido con una expresión que permita a Claude rellenar el valor:

{{ $fromAI('order_number', 'The order number the customer gave', 'string') }}

Copiar prompt

Ahora "¿Dónde está el pedido 48213?" se convierte en una búsqueda real. Descripción de la herramienta: Busca un pedido por número y devuelve el estado y la fecha de envío. Es de solo lectura, así que es la herramienta más segura para empezar a exponer.

Publicar un resumen en Slack

Añade una Slack Tool con la operación enviar mensaje. Fija el canal y deja que Claude rellene solo el texto:

{{ $fromAI('summary', 'A two sentence summary to post', 'string') }}

Copiar prompt

Como el canal está fijado en el nodo, un prompt confuso no puede publicar en ningún otro sitio. Esa decisión elimina la mayor parte del riesgo de dar acceso de escritura a un asistente.

Llamar a un subflujo

La Custom n8n Workflow Tool ejecuta otro flujo de trabajo que empieza con un Execute Workflow Trigger. Aquí es donde deben ir los trabajos de varios pasos: enriquecer un contacto, consultar el CRM, escribir una página en Notion y devolver un resultado breve. Claude ve una herramienta con una descripción, y toda la lógica de ramificación queda en un flujo de trabajo que puedes probar por separado.

Generar imágenes a través de una API

Una HTTP Request Tool permite a Claude iniciar trabajos de imagen desde un chat. La API de PicassoIA usa un diseño al estilo de Replicate: creas una predicción y luego la consultas hasta que el resultado está listo. La dirección base es https://api.picassoia.com/v1 y las llamadas usan un token Bearer que empieza por pia_sk_, creado en la página de la API de PicassoIA.

1. Añade una HTTP Request Tool llamada create_image con la descripción Crea una imagen fotorrealista 16:9 a partir de un prompt de texto y devuelve el id de la predicción.
2. Pon el método en POST y la URL en https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions.
3. Configura la autenticación como Bearer y pega tu token pia_sk_.
4. Envía un cuerpo JSON con un objeto input cuyo prompt proceda de $fromAI.
5. Añade una segunda HTTP Request Tool llamada get_image que envíe un GET a https://api.picassoia.com/v1/predictions/ seguido del id de la predicción que Claude pase.

Claude crea el trabajo, espera unos segundos, consulta get_image y te muestra la URL final. El modelo detrás de la primera llamada es PicassoIA Image, y PicassoIA Image Editor Pro se encarga de las ediciones con el mismo patrón. Las cuentas ejecutan hasta 5 predicciones a la vez, y los prompts pueden llegar a 4.000 caracteres, así que escribe la descripción de la herramienta para indicarle a Claude que envíe una petición cada vez. Consulta la página de la API para los campos de respuesta y los requisitos del plan antes de confiar en esto en producción.

Solución de fallos habituales

La mayoría de los problemas del MCP Server Trigger vienen de una de unas pocas causas. Antes de cambiar nada, abre la pestaña Executions. Una llamada que no aparece ahí nunca llegó a n8n, lo que apunta a la URL, al proxy o a la configuración de Claude. Una llamada que aparece con un error apunta al propio nodo de herramienta.

Las conexiones se cortan detrás de nginx

SSE y streamable HTTP son conexiones de larga duración. Un proxy inverso que almacena respuestas en búfer retiene el stream hasta llenarlo, y Claude ve un bloqueo. n8n recomienda desactivar el búfer del proxy, la compresión gzip y la codificación de transferencia por fragmentos en la ruta MCP, y eliminar la cabecera Connection:

location /mcp/ {
    proxy_pass http://n8n:5678;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    proxy_buffering off;
    gzip off;
    chunked_transfer_encoding off;
}

Copiar prompt

Enrutamiento en modo cola

En modo cola con varias réplicas de webhook, cada conexión persistente debe quedarse en la instancia que la abrió. n8n documenta que todas las peticiones de /mcp* se dirijan a una única réplica de webhook dedicada. Añade una regla en tu balanceador de carga para esa ruta y los fallos aleatorios desaparecerán.

Pruébalo con tus propias imágenes

Ya tienes el ciclo completo: un nodo trigger, una URL de producción, autenticación Bearer, una configuración de Claude que apunta a ella y herramientas que hacen trabajo real. El flujo de trabajo de imágenes es el más divertido para probar primero, porque el resultado aparece en tu chat y puedes juzgarlo en segundos.

Abre Picasso IA y lanza algunos prompts a mano antes de conectar la API. Compara GPT Image 2, Seedream 4.5 y Nano Banana 2 Lite con el mismo prompt y quédate con el estilo que encaje en tu proyecto. Cuando sepas qué formas de prompt funcionan, inclúyelas en la descripción de la herramienta para que Claude escriba mejores prompts por su cuenta.

Construye la primera herramienta hoy: un trigger, una herramienta de solo lectura y una conexión con Claude. Añade una segunda herramienta solo cuando la primera funcione sin errores, y tu asistente crecerá sin sorprenderte nunca.