Imagina que tu agente de IA en n8n pudiera consultar tu base de datos PostgreSQL, leer archivos de tu servidor o interactuar con GitHub sin necesidad de configurar decenas de nodos HTTP Request. Eso es exactamente lo que permite configurar un n8n cliente MCP. El Model Context Protocol está revolucionando la forma en que los flujos de automatización se conectan con herramientas externas, y hoy te voy a mostrar paso a paso cómo aprovecharlo desde tu instancia de n8n, ya sea cloud o self-hosted. No necesitas ser experto en APIs, solo seguir esta guía práctica.
¿Qué es n8n cliente MCP?
Para entender esto, primero hay que clarificar dos conceptos que suelen confundirse. El Model Context Protocol (MCP) es un estándar creado por Anthropic que permite a las aplicaciones de IA conectarse con fuentes de datos y herramientas externas de forma estandarizada. Dentro de este ecosistema existen dos roles: el servidor MCP (que expone recursos y herramientas) y el cliente MCP (que consume esos recursos).
Cuando hablamos de n8n cliente MCP, nos referimos a configurar n8n para que actúe como consumidor de servidores MCP. En otras palabras, tus flujos de trabajo pueden invocar herramientas expuestas por servidores MCP externos, como bases de datos, sistemas de archivos, APIs de terceros o incluso automatizaciones de GitHub. Esto es diferente a configurar n8n como servidor MCP, donde n8n expone sus workflows para que otros clientes (como Claude Desktop o IDEs) los consuman.
La ventaja de usar n8n como cliente es que puedes orquestar múltiples servidores MCP simultáneamente, combinarlos con nodos nativos de n8n (como Telegram, Slack o email), y crear agentes de IA superpoderosos que interactúan con todo tu stack tecnológico sin escribir código de integración específico para cada herramienta.
Cómo configurar n8n como cliente MCP paso a paso
Ahora sí, vamos a lo práctico. Configurar el cliente MCP en n8n es más sencillo de lo que parece, especialmente si usas la versión desktop o self-hosted donde tienes control total sobre el entorno. Si usas n8n Cloud, también es posible, pero con algunas limitaciones que veremos más adelante.
Requisitos previos antes de empezar
Necesitas tener n8n actualizado a una versión reciente (preferiblemente 1.50 o superior donde hay mejor soporte para MCP). También debes tener acceso a un servidor MCP funcionando. Puedes usar servidores oficiales como @modelcontextprotocol/server-postgres para PostgreSQL, @modelcontextprotocol/server-filesystem para archivos locales, o cualquier otro compatible con el protocolo STDIO (Standard Input/Output).
Importante: asegúrate de tener Node.js instalado en tu sistema si vas a ejecutar servidores MCP basados en Node, o Python si usas servidores en ese lenguaje. El nodo MCP Client en n8n se comunica con estos servidores mediante el protocolo STDIO, por lo que el comando debe poder ejecutarse en tu terminal.
Paso 1: Agregar el nodo MCP Client a tu workflow
En el canvas de n8n, busca el nodo llamado «MCP Client» o «MCP Client Tool» en la paleta de nodos. Si no lo encuentras, asegúrate de tener habilitados los nodos de la comunidad o busca en la sección de IA/Agentes. Arrastra el nodo a tu flujo.
Este nodo tiene dos modos principales de operación: «List Tools» (para descubrir qué herramientas ofrece el servidor) y «Execute Tool» (para invocar una herramienta específica). Normalmente usarás ambos: primero para ver qué está disponible durante el desarrollo, y luego el modo ejecución para producción.
Paso 2: Configurar la conexión al servidor MCP
Aquí viene la parte técnica. En la configuración del nodo, debes especificar el «Command» (comando) que inicia tu servidor MCP. Por ejemplo, si quieres conectar con una base de datos PostgreSQL, el comando podría ser:
npx -y @modelcontextprotocol/server-postgres postgresql://usuario:password@localhost:5432/mibasededatos
O para el servidor de filesystem:
npx -y @modelcontextprotocol/server-filesystem /ruta/a/tus/archivos
En el campo «Environment Variables» (Variables de entorno), puedes agregar credenciales sensibles si prefieres no ponerlas directamente en el comando. Esto es más seguro y te permite rotar credenciales sin modificar el workflow.
Configura también el timeout según la operación: consultas a bases de datos pueden tardar varios segundos, mientras que operaciones de filesystem suelen ser instantáneas.
Paso 3: Listar y mapear las herramientas disponibles
Antes de usar una herramienta específica, es recomendable hacer una prueba con el modo «List Tools». Conecta el nodo MCP Client a un nodo «Code» o «Set» y ejecútalo. Deberías recibir un JSON con todas las herramientas disponibles en ese servidor, incluyendo sus nombres, descripciones y parámetros requeridos.
Por ejemplo, el servidor PostgreSQL suele exponer herramientas como «query» (para consultas SELECT) y «execute» (para INSERT/UPDATE). Anota exactamente los nombres de las herramientas y los parámetros que necesitan, porque los usarás en el siguiente paso.
Paso 4: Invocar herramientas en tus agentes de IA
Este es donde la magia sucede. Si estás construyendo un agente de IA con n8n, puedes añadir el nodo MCP Client como una «Tool» (herramienta) disponible para el agente. Configura el modo «Execute Tool» y especifica el nombre exacto de la herramienta que descubriste en el paso anterior.
Mapea los parámetros usando expresiones de n8n. Por ejemplo, si la herramienta «query» necesita un parámetro «sql», puedes pasarle: {{ $json.userQuery }} o directamente el input del usuario. El agente de IA interpretará cuándo usar esta herramienta basándose en la descripción que le proporciones en la configuración del nodo Agent.
Prueba tu flujo con preguntas como «¿Cuántos usuarios registrados tenemos esta semana?» y observa cómo el agente invoca automáticamente el servidor MCP para consultar la base de datos y devolver la respuesta estructurada.
Errores comunes al configurar el cliente MCP y cómo solucionarlos
Aunque el protocolo está diseñado para estandarizar conexiones, en la práctica suele haber tropiezos. Aquí te dejo los problemas más frecuentes que veo en la comunidad latinoamericana de n8n y sus soluciones.
Confundir cliente con servidor: Muchos creen que al configurar el nodo MCP Client están exponiendo sus flujos para uso externo. Recuerda: cliente consume, servidor expone. Si necesitas que Claude Desktop o Cursor IDE usen tus workflows de n8n, necesitas configurar n8n como servidor MCP, no cliente.
Problemas con el PATH y dependencias: Cuando n8n ejecuta el comando para iniciar el servidor MCP, a veces no encuentra Node.js o Python porque el PATH del proceso es diferente al de tu terminal. Solución: usa rutas absolutas en el comando (ej: /usr/local/bin/npx en lugar de solo npx) o configura las variables de entorno PATH explícitamente en el nodo.
Timeouts en operaciones largas: Por defecto, muchos nodos tienen timeouts cortos (30-60 segundos). Si tu consulta SQL analiza millones de registros, el servidor MCP puede tardar minutos. Aumenta el timeout en la configuración avanzada del nodo MCP Client y también revisa los límites de tu instancia de n8n.
Formato incorrecto de parámetros: Los servidores MCP son estrictos con los tipos de datos. Si una herramienta espera un número y le envías un string desde n8n (incluso si «parece» número), fallará. Usa la función $json.variable.toNumber() o asegúrate de tipificar correctamente los datos antes de enviarlos al nodo MCP.
CORS y conexiones remotas: Si intentas conectar con un servidor MCP que corre en otra máquina vía HTTP/SSE (en lugar de STDIO local), verifica problemas de CORS y firewalls. El protocolo STDIO es más estable para conexiones locales, mientras que SSE es mejor para servicios en la nube pero requiere configuración adicional de red.
Ejemplos reales de uso de n8n cliente MCP
Te comparto tres escenarios concretos donde el cliente MCP transforma completamente la forma de trabajar con n8n, especialmente cuando combinamos esta tecnología con vector stores y embeddings para crear sistemas RAG potentes.
Automatización de soporte técnico con acceso a base de datos
Una empresa de software usa n8n para gestionar tickets de soporte. Configuran el cliente MCP conectado a su servidor PostgreSQL. Cuando un cliente pregunta por WhatsApp «¿Cuál es el estado de mi ticket #1234?», el agente de IA en n8n no busca en una hoja de cálculo estática, sino que invoca el servidor MCP para hacer una consulta SQL en tiempo real a la base de datos de tickets. La respuesta es precisa, actualizada al segundo, y no requiere mantener sincronizaciones manuales entre la DB y el flujo de n8n.
Análisis de documentos financieros en filesystem local
Un contador independiente automatiza la extracción de datos de facturas PDF. Usa el servidor MCP de filesystem para dar acceso seguro a una carpeta específica de su computadora. El flujo de n8n (cliente MCP) lista los archivos nuevos, invoca herramientas del servidor para leer el contenido, y luego procesa la información con un nodo de IA para clasificar gastos. Todo sin subir documentos sensibles a servicios en la nube, manteniendo la privacidad local pero aprovechando el poder de la automatización.
Orquestación multi-servidor: Base de datos + GitHub + Notion
Un equipo de producto configura n8n como cliente de tres servidores MCP simultáneamente: PostgreSQL (métricas), GitHub (issues y código) y Notion (documentación). Cuando el agente de IA recibe la pregunta «¿Cuántos bugs críticos tenemos en el módulo de pagos y están documentados?», el flujo consulta GitHub vía MCP para contar issues con label ‘critical’, verifica en PostgreSQL si esos errores afectan transacciones reales, y revisa Notion vía su integración nativa o MCP para ver si existe documentación técnica. La respuesta consolidada se envía al Slack del equipo técnico automáticamente.
Preguntas frecuentes sobre n8n cliente MCP
faq
Preguntas frecuentes
¿Qué diferencia hay exactamente entre n8n cliente MCP y servidor MCP?
La diferencia es el sentido de la comunicación. Cuando n8n es cliente MCP, consume herramientas y datos de servidores externos (como una base de datos o sistema de archivos). Cuando n8n es servidor MCP, expone tus workflows para que otros clientes (como Claude Desktop, Cursor o aplicaciones externas) puedan ejecutar tus flujos de n8n. En resumen: cliente = n8n pide datos, servidor = n8n da servicios.
¿Necesito saber programar para usar el cliente MCP en n8n?
No necesariamente, pero ayuda entender conceptos básicos. Para configurar el nodo necesitas saber qué comando ejecuta tu servidor MCP (generalmente copias y pegas de la documentación del servidor) y entender cómo pasar parámetros. No requieres escribir código complejo porque n8n abstrae la comunicación con el protocolo, pero sí debes comprender qué hace cada herramienta del servidor que estás consumiendo.
¿Puedo conectar múltiples servidores MCP en un solo workflow de n8n?
Sí, absolutamente. Una de las ventajas de usar n8n como orquestador es que puedes tener varios nodos MCP Client, cada uno conectado a un servidor diferente (PostgreSQL, GitHub, filesystem, etc.), y combinarlos en un solo flujo. Incluso puedes pasar datos de un servidor MCP a otro, por ejemplo, leer un archivo del servidor de filesystem y guardarlo en la base de datos vía el servidor PostgreSQL.
¿Funciona n8n cliente MCP en la versión Cloud o solo en self-hosted?
Funciona en ambas, pero con matices. En n8n Cloud tienes limitaciones de seguridad: no puedes ejecutar comandos arbitrarios del sistema operativo ni instalar paquetes NPM libremente. Por tanto, solo podrás conectar servidores MCP que estén expuestos vía HTTP/SSE (servidor-remoto) o que ya vengan pre-instalados. En self-hosted tienes libertad total para ejecutar cualquier servidor MCP local vía STDIO.
¿Qué servidores MCP recomiendas para empezar a probar con n8n?
Para empezar, te sugiero el servidor de filesystem (@modelcontextprotocol/server-filesystem) si usas n8n local, porque es seguro (solo accede a carpetas que especifiques) y muy visual. Luego el de PostgreSQL si tienes bases de datos, y el de Brave Search si quieres dar capacidad de búsqueda web a tus agentes. Evita empezar con servidores que requieran autenticación OAuth compleja hasta que domines el flujo básico.
¿Listo para empezar?
¿Listo para expandir las capacidades de tus agentes de IA?
Configurar n8n como cliente MCP es como darle superpoderes a tus automatizaciones: de repente, tus flujos pueden interactuar con prácticamente cualquier sistema que tenga un servidor MCP disponible, sin depender de que exista un nodo nativo específico en n8n. Ya no estás limitado a las integraciones oficiales; el protocolo abre un universo de posibilidades.
Recuerda empezar con un servidor sencillo como filesystem o una base de datos local, domina la configuración del comando y las variables de entorno, y luego escala a orquestaciones complejas con múltiples fuentes de datos. Si ya tienes experiencia creando sistemas RAG, añadir MCP es el siguiente nivel para que tus agentes no solo lean documentos estáticos, sino que interactúen con sistemas vivos en tiempo real.
Te recomiendo revisar la documentación oficial del Model Context Protocol para mantenerte actualizado sobre nuevos servidores disponibles. ¿Qué servidor MCP vas a conectar primero? Cuéntame en los comentarios si te surgen dudas al implementarlo, ¡y happy automating!
