¿No funciona MCP en n8n? Lista de comprobación para descubrir herramientas y llamarlas
¿No funciona MCP en n8n? Aísla problemas de endpoint, transporte, autenticación, descubrimiento y ejecución con una comprobación repetible de solo lectura.
Comprobado con las fuentes citadas el .
Delimita los problemas de MCP en n8n antes de cambiar ajustes
¿No funciona MCP en n8n en tu flujo de trabajo? Separa la conexión, el descubrimiento de herramientas y su ejecución. Esta lista se centra en MCP Server Trigger, que expone herramientas de un único flujo; la configuración de MCP a nivel de instancia es distinta.
Las comprobaciones y los criterios de finalización siguientes son nuestra propuesta para diagnosticar problemas, no normas obligatorias de MCP ni un procedimiento probado. Estas comprobaciones no acreditan la compatibilidad entre versiones de n8n y del cliente; contrástalas con tus versiones instaladas. Empieza registrando la configuración para tener una referencia clara al hacer cambios posteriores.
Creemos que el hábito más útil al depurar es identificar el límite en el que se produce el fallo antes de cambiar ajustes. Una herramienta que no aparece y un resultado incorrecto requieren investigaciones diferentes.
Sources: n8n-docs/docs/connect/connect-to-n8n-mcp-server.md at main · n8n-io/n8n-docs · GitHub
Comprueba la disponibilidad del endpoint, el transporte y la autenticación
En un flujo inactivo, n8n registra la URL de prueba de MCP Server Trigger cuando seleccionas Listen for Test Event o Execute workflow. Al publicar se registra la URL de producción.
El trigger admite SSE y HTTP transmisible, pero no stdio directo. Una pasarela que conecta un cliente stdio requiere una configuración aparte. Las opciones de autenticación son None, Bearer auth y Header auth; recomendamos el acceso autenticado para esta comprobación en equipo, aunque no es un requisito universal de la plataforma.
Si MCP en n8n falla al conectar, investiga cada límite por separado en lugar de interpretar cualquier fallo como prueba de un token inválido. Para despliegues con proxy inverso, la comprobación del almacenamiento en búfer que aparece a continuación refleja el requisito documentado de n8n, no una configuración completa del proxy. Utiliza los siguientes criterios de comprobación propuestos.
Sources: n8n-docs/docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md at main · n8n-io/n8n-docs · GitHub, MCP Server Trigger | Nodes | n8n Docs
Comprueba el descubrimiento con una herramienta mínima de solo lectura
Proponemos una configuración de prueba: un flujo de diagnóstico con MCP Server Trigger y una herramienta Code Tool de JavaScript conectada que devuelva una cadena fija, por ejemplo return 'mcp-check-ok';. Excluye las API externas y las operaciones de escritura. La implementación de Code Tool de n8n en la rama master del repositorio describe la salida como una única cadena; este ejemplo no está probado y debe verificarse con tu versión instalada.
La guía del proveedor n8nlogic de marzo de 2026 describe el trigger como un ejecutor de nodos de herramientas conectados, en lugar de un flujo lineal convencional. Usa esa explicación de las conexiones como pista para el diagnóstico: inspecciona la conexión de la herramienta de diagnóstico antes de cambiar su código.
El nodo MCP Client estándar de n8n obtiene automáticamente las herramientas seleccionables del servidor externo. Configúralo para tu endpoint e inspecciona esa lista. El descubrimiento se completa cuando aparece la herramienta de diagnóstico; que sea visible no demuestra que se ejecute correctamente.
En nuestra opinión, una configuración de prueba deliberadamente sencilla es el punto de partida adecuado. Eliminaríamos la lógica de negocio hasta comprender la conexión y el límite de la herramienta.
Sources: n8n MCP Server: How to Expose Your Workflows to AI Agents | n8nlogic, n8n-docs/docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md at main · n8n-io/n8n-docs · GitHub, n8n/packages/@n8n/nodes-langchain/nodes/tools/ToolCode/ToolCode.node.ts at master · n8n-io/n8n · GitHub
Comprueba la llamada y vuelve a recoger las mismas evidencias
¿MCP en n8n sigue sin funcionar aunque el descubrimiento haya tenido éxito? Llama a la herramienta seleccionada con entradas que coincidan con su esquema descubierto. MCP Client de n8n admite parámetros introducidos manualmente o un objeto JSON. Para esta configuración de prueba propuesta, completar la comprobación significa que la respuesta contiene mcp-check-ok y que puedes inspeccionar la ejecución correspondiente.
Inspecciona las ejecuciones de producción en la vista de ejecuciones, en lugar de consultar la salida en directo del lienzo. La vista de ejecuciones permite filtrar las ejecuciones accesibles por flujo, estado y hora de inicio; el acceso depende de los permisos del flujo, y eliminar un flujo borra su historial de ejecuciones. El estado Success por sí solo no demuestra que la salida sea correcta.
Utiliza esta lista propuesta para el traspaso de información después de cada cambio de configuración. Comprueba el límite de respuesta constante, no las API específicas de la aplicación, los permisos de los sistemas posteriores ni la corrección de los datos de negocio, y no ofrece ninguna garantía de fiabilidad.
Sources: n8n-docs/docs/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md at main · n8n-io/n8n-docs · GitHub, MCP Client | Nodes | n8n Docs, View all executions | Build | n8n Docs
