Guía Dify + MCP 2026: Conecta agentes IA a cualquier herramienta
El Model Context Protocol (MCP) es el nuevo estándar universal para conectar modelos IA con herramientas externas. Esta guía te muestra cómo integrar servidores MCP en Dify, dando a tus agentes acceso al sistema de archivos, GitHub, Slack, bases de datos y cualquier API a través de una interfaz estandarizada.
¿Qué es MCP (Model Context Protocol)?
El Model Context Protocol (MCP) es un estándar abierto introducido por Anthropic a finales de 2024. Define una forma universal para que los modelos de lenguaje se conecten a herramientas y fuentes de datos externas. Antes de MCP, cada plataforma IA necesitaba sus propias integraciones para cada herramienta — un conector de GitHub, un adaptador de base de datos, un lector de archivos, todos desarrollados por separado. MCP cambia todo esto.
La mejor analogía: MCP es como el USB-C para la IA. Así como USB-C permite conectar cualquier dispositivo a cualquier ordenador, MCP permite que cualquier agente IA se conecte a cualquier servidor de herramientas compatible con MCP. Un estándar, extensibilidad infinita.
Nota técnica: MCP usa una arquitectura cliente-servidor sobre HTTP o stdio. El agente IA (cliente) envía solicitudes a servidores MCP que exponen "herramientas" — funciones que el agente puede llamar. El protocolo es independiente del lenguaje: los servidores pueden escribirse en Node.js, Python, Go o cualquier otro lenguaje.
Estandarizado
Un protocolo para todas las herramientas. Construye una vez, conecta en cualquier lugar.
Open Source
Licencia Apache 2.0. Ecosistema de servidores impulsado por la comunidad.
Seguro
Los servidores corren en local o en tu red privada. Tus datos se quedan contigo.
Extensible
Crea servidores MCP personalizados para cualquier API, base de datos o servicio.
Dify como cliente MCP
Dify soporta MCP de forma nativa como cliente, lo que significa que tus agentes Dify pueden comunicarse con cualquier servidor MCP. Cuando añades un servidor MCP a Dify, descubre automáticamente todas las herramientas expuestas y las hace disponibles en tus aplicaciones Agent. Tu agente IA decide por sí mismo cuándo llamar a qué herramientas.
Esto es un avance significativo respecto a las integraciones API tradicionales. En lugar de definir manualmente cada llamada a la API como una "herramienta personalizada" en Dify, simplemente apuntas Dify a un servidor MCP y todo el catálogo de herramientas se lee automáticamente. Añade un servidor MCP de GitHub y tu agente puede inmediatamente listar repos, leer archivos, crear issues y revisar pull requests.
Qué puedes conectar via MCP
Cómo conectar un servidor MCP a Dify
Añadir un servidor MCP como herramienta en Dify tarda unos 2 minutos. Aquí está el proceso completo paso a paso:
Iniciar tu servidor MCP
Lanza tu servidor MCP en local o en tu servidor. Por ejemplo, para iniciar el servidor filesystem oficial de Anthropic: npx @modelcontextprotocol/server-filesystem /ruta/a/tus/archivos — esto inicia un servidor MCP HTTP en el puerto 3000 por defecto.
Abrir las Herramientas de Dify
En tu instancia Dify, haz clic en Herramientas en la navegación superior. Luego haz clic en Herramientas personalizadas en la barra lateral izquierda.
Crear una nueva herramienta MCP
Haz clic en el botón "+ Crear". En el selector de tipo de herramienta, elige Servidor MCP (no OpenAPI).
Introducir la URL del servidor MCP
Pega la URL de tu servidor MCP, por ejemplo http://localhost:3000/mcp. Si tu servidor requiere autenticación, introduce el token en el campo de encabezado Authorization.
Descubrimiento automático
Dify obtiene automáticamente el manifiesto de herramientas del servidor. Verás una lista de todas las herramientas expuestas — ej. "read_file", "list_directory", "write_file" para un servidor filesystem.
Añadir a tu app Agent
Abre o crea una aplicación Agent en Dify. En la sección Herramientas, haz clic en Añadir herramienta y selecciona tu servidor MCP. Tu agente ya puede usar todas las herramientas descubiertas.
Consejo self-hosted: Si Dify y tu servidor MCP corren en el mismo host, usa la IP interna o el nombre de host del servidor — no localhost, ya que Dify corre dentro de Docker. Por ejemplo: http://172.17.0.1:3000/mcp o http://host.docker.internal:3000/mcp en macOS/Windows.
Servidores MCP populares para Dify
Anthropic y la comunidad mantienen un ecosistema creciente de servidores MCP. Estos son los más útiles para conectar a Dify:
| Servidor MCP | Función | Herramientas principales | Instalación |
|---|---|---|---|
| filesystem | Leer y escribir archivos locales | read_file, write_file, list_directory, search_files | npx @modelcontextprotocol/server-filesystem |
| github | Repos GitHub, PRs, issues | get_file_contents, create_issue, list_pull_requests, search_code | npx @modelcontextprotocol/server-github |
| slack | Mensajes y canales de Slack | list_channels, get_messages, send_message, search_messages | npx @modelcontextprotocol/server-slack |
| postgresql | Acceso SQL de solo lectura | query, list_tables, describe_table | npx @modelcontextprotocol/server-postgres |
| brave-search | Búsqueda web en tiempo real | brave_web_search, brave_local_search | npx @modelcontextprotocol/server-brave-search |
| puppeteer | Automatización navegador y scraping | navigate, screenshot, get_content, click, fill | npx @modelcontextprotocol/server-puppeteer |
| everything | Búsqueda de archivos en Windows | search, get_file_info | npx @modelcontextprotocol/server-everything |
Configurar un servidor MCP: ejemplo paso a paso
Ejemplo completo: configurar el servidor MCP filesystem de Anthropic para que tu agente Dify pueda leer y escribir archivos en tu servidor.
Paso 1: Instalar Node.js 18+ (omitir si ya está instalado)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt-get install -y nodejs
Paso 2: Iniciar el servidor MCP filesystem
npx @modelcontextprotocol/server-filesystem /home/user/documentos
# Servidor iniciado en http://localhost:3000/mcp
Paso 3: Ejecutar como servicio en segundo plano (opcional)
npm install -g pm2 pm2 start "npx @modelcontextprotocol/server-filesystem /home/user/documentos" --name mcp-filesystem pm2 save && pm2 startup
Paso 4: Probar el servidor
curl http://localhost:3000/mcp
# Debería devolver: {"name":"filesystem","version":"...","tools":[...]} Paso 5: Servidor MCP GitHub (con autenticación)
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_tu_token_aqui \ npx @modelcontextprotocol/server-github
# Crear un PAT de GitHub en: github.com/settings/tokens
Casos de uso del mundo real
Tres configuraciones Dify + MCP listas para producción que puedes replicar hoy mismo:
Caso de uso 1: Asistente de documentos IA
Conecta el servidor MCP filesystem a un agente Dify. Tu IA puede ahora explorar tus carpetas de documentos, leer contratos, extraer datos clave, comparar versiones y escribir resúmenes en disco — todo en lenguaje natural. Pide "resume todos los informes PDF en /informes/T1 y crea un resumen ejecutivo" y míralo funcionar.
Caso de uso 2: Revisor de PRs de GitHub
Conecta el servidor MCP de GitHub a Dify. Construye un agente que revise automáticamente los pull requests: lista las PRs abiertas, lee el diff, verifica los estándares de código, identifica bugs potenciales y publica un comentario de revisión — todo desde la interfaz de Dify. Ejecútalo con un calendario via workflows de Dify para revisión de código sin intervención.
Caso de uso 3: Analista de base de datos
Conecta el servidor MCP PostgreSQL a Dify con credenciales de solo lectura. Construye un analista de datos en lenguaje natural: los usuarios hacen preguntas de negocio en español, el agente escribe consultas SQL, las ejecuta contra tu base de datos y devuelve los insights en forma legible. No se necesita conocimiento de SQL por parte de los usuarios finales.
Preguntas frecuentes
¿Qué es MCP (Model Context Protocol)?
MCP es un estándar abierto de Anthropic que define cómo los modelos IA se conectan a herramientas y fuentes de datos externas. Es como el 'USB-C para IA' — en lugar de integraciones personalizadas, un estándar funciona en todas partes. Dify soporta MCP como cliente.
¿Qué puedo conectar a Dify via MCP?
Via MCP puedes conectar Dify a: sistemas de archivos locales, GitHub (repos, PRs, issues), Slack (mensajes, canales), bases de datos PostgreSQL, navegadores web (Puppeteer), búsqueda web (Brave, DuckDuckGo) y cualquier servicio con servidor MCP.
¿Necesito programar para usar MCP con Dify?
Para servidores MCP oficiales (filesystem, GitHub, etc.), solo necesitas un comando npx para iniciarlo, luego añades la URL en Dify. No se necesita código. Construir un servidor MCP personalizado requiere conocimientos básicos de Node.js o Python.
¿Es MCP seguro para producción?
La seguridad de MCP depende de tu configuración. Siempre ejecuta servidores MCP en localhost o una red privada — nunca directamente en internet. Usa tokens de autenticación y limita el acceso al sistema de archivos a directorios específicos.
¿Listo para usar Dify + MCP en producción?
MCP es más potente cuando Dify y los servidores MCP se alojan juntos — en el mismo servidor privado, sin que los datos salgan de tu infraestructura. Hetzner ofrece VPS desde 3,79 €/mes con el rendimiento para ejecutar Dify y múltiples servidores MCP simultáneamente. O usa Elestio para un despliegue Dify completamente gestionado en un clic.