Cómo conectar Dify con MCP: Guía Completa de Integración

Si utilizas Dify para crear agentes, chatbots o flujos de trabajo con inteligencia artificial, el Model Context Protocol permite llevar esas aplicaciones más allá de su interfaz habitual. Gracias a MCP, puedes publicar una aplicación de Dify como una herramienta disponible en clientes compatibles como Claude Desktop o Cursor.

La integración también funciona en sentido contrario. Dify puede conectarse a servidores MCP externos e importar sus herramientas para utilizarlas dentro de workflows, chatflows y agentes. De esta forma, una aplicación puede consultar servicios externos, interactuar con bases de datos o ejecutar acciones sin desarrollar una integración independiente para cada plataforma.

En esta guía veremos cómo conectar Dify con MCP en ambas direcciones, cómo proteger la URL de acceso, cómo añadir la aplicación a Claude Desktop y Cursor y qué debes revisar si el servidor no aparece o sus herramientas no funcionan correctamente.

Dify está disponible como servicio administrado en la nube y como plataforma autogestionada. En Dify Cloud, el proveedor se ocupa de buena parte de la infraestructura; en una instalación propia, las actualizaciones, la seguridad, la disponibilidad y la configuración de red quedan bajo tu responsabilidad.

Qué permite hacer la integración de Dify con MCP

El Model Context Protocol es un estándar abierto que permite conectar aplicaciones de inteligencia artificial con herramientas, fuentes de datos y otros sistemas externos. Su objetivo es evitar que cada servicio necesite una integración completamente diferente.

Dentro de Dify existen dos formas principales de utilizarlo:

• Dify como servidor MCP: publica una aplicación para que Claude Desktop, Cursor y otros clientes puedan utilizarla como una herramienta externa.
• Dify como cliente MCP: conecta servidores remotos e importa sus herramientas para incorporarlas a las aplicaciones creadas en Dify.

Esta diferencia es importante. Al funcionar como servidor, Dify ofrece las capacidades de una aplicación ya creada. Cuando actúa como cliente, es Dify quien consume las herramientas proporcionadas por otros servidores.

Cómo convertir una aplicación de Dify en un servidor MCP

Para empezar, abre en Dify la aplicación que quieres compartir. Puede ser, por ejemplo, un asistente conectado a una base de conocimiento o un workflow que procese documentos y devuelva un resultado estructurado.

Entra en las opciones de publicación o configuración de la aplicación y busca el módulo denominado MCP Server. La función aparece desactivada inicialmente. Al habilitarla, Dify genera una dirección única que actuará como punto de conexión para los clientes externos.

Antes de copiarla, comprueba que la versión publicada de la aplicación funciona correctamente y que sus entradas están bien definidas. Los clientes MCP necesitan conocer qué hace la herramienta y qué parámetros deben enviar, por lo que las descripciones ambiguas pueden provocar invocaciones incorrectas.

Cómo definir las entradas de la aplicación

Los campos de entrada deben tener nombres claros, tipos adecuados y descripciones suficientemente precisas. No es recomendable utilizar parámetros genéricos como data o input sin explicar qué información contienen.

Por ejemplo, en lugar de describir un campo como «datos del usuario», puedes indicar que espera un objeto con el nombre, el correo electrónico y las preferencias del cliente. De este modo, el modelo que utilice la herramienta tendrá más posibilidades de construir correctamente la llamada.

También conviene evitar parámetros innecesarios. Cada campo adicional aumenta la posibilidad de que el cliente envíe información incompleta o con un formato incorrecto.

Cómo proteger la URL del servidor MCP de Dify

La dirección generada por Dify contiene las credenciales necesarias para acceder a la aplicación. Por tanto, debes tratarla como si fuera una clave de API secreta.

No la publiques en capturas de pantalla, repositorios, documentos compartidos o registros accesibles públicamente. Si vas a añadirla a un archivo de configuración, comprueba que dicho archivo no termine accidentalmente dentro de Git.

Si sospechas que la dirección se ha filtrado, utiliza el botón de regeneración disponible en Dify. La plataforma creará una URL nueva y la dirección anterior dejará de funcionar inmediatamente. Después tendrás que sustituirla en todos los clientes conectados.

También debes limitar las acciones que la aplicación puede ejecutar. Un servidor MCP que permite modificar bases de datos, enviar mensajes o acceder a información privada requiere más controles que una herramienta dedicada únicamente a resumir texto.

Cómo conectar la aplicación de Dify con Claude Desktop

Una vez habilitado el servidor, copia su URL y abre Claude Desktop. El procedimiento indicado por Dify consiste en entrar en el perfil, abrir Settings, acceder a Integrations y seleccionar la opción para añadir una nueva integración.

Pega la dirección generada por Dify en el campo correspondiente a la URL del servidor y completa la conexión. Cuando Claude reconozca el servidor, la aplicación aparecerá entre las herramientas disponibles.

Antes de utilizarla en una tarea importante, realiza una prueba sencilla. Pide a Claude que identifique las herramientas conectadas y ejecuta una llamada con datos que no sean sensibles. Esto permite comprobar que las entradas se interpretan correctamente y que Dify devuelve el resultado esperado.

La ubicación y denominación de los menús de Claude pueden cambiar entre versiones. Si no aparece el apartado de integraciones, comprueba que estás utilizando una versión actual del cliente y que la función está disponible en tu cuenta.

Cómo conectar Dify con MCP en Cursor

Cursor permite configurar servidores MCP dentro de un proyecto mediante el archivo .cursor/mcp.json. Si la carpeta o el archivo no existen, puedes crearlos en el directorio raíz del proyecto.

La configuración básica es la siguiente:

{
  "mcpServers": {
    "dify-app": {
      "url": "URL_DEL_SERVIDOR_MCP_DE_DIFY"
    }
  }
}

Sustituye URL_DEL_SERVIDOR_MCP_DE_DIFY por la dirección proporcionada por Dify. El nombre dify-app es un identificador local y puedes cambiarlo por otro que describa mejor la función de la aplicación.

Cursor debería detectar el servidor y mostrar sus herramientas. Si no aparece, revisa que el archivo contenga un JSON válido, que esté guardado en la ubicación correcta y que la URL no incluya espacios o caracteres añadidos al copiarla.

Si trabajas con un repositorio compartido, evita subir una dirección que contenga credenciales. Incluye el archivo en las exclusiones de Git o utiliza el mecanismo de gestión de secretos admitido por tu entorno.

Cómo utilizar Dify como cliente MCP

Dify también puede conectarse a servidores MCP externos e importar las herramientas que estos publican. La configuración actual se encuentra en Integraciones > Herramientas, dentro del apartado correspondiente a MCP.

Para añadir un servidor necesitas proporcionar:

• La URL del servidor MCP.
• Un nombre que permita identificarlo en el espacio de trabajo.
• Un identificador único utilizado internamente por las aplicaciones.

Dify se conecta al servidor, obtiene la lista de herramientas y permite utilizarlas como cualquier otra herramienta de la plataforma. Pueden añadirse como nodos independientes dentro de un Workflow o Chatflow, o ponerse a disposición de un nodo de agente para que el modelo decida cuándo utilizarlas.

Actualmente, Dify admite en esta integración servidores MCP remotos con transporte HTTP. Un servidor local configurado únicamente mediante stdio no puede añadirse pegando su comando de ejecución en este apartado. En ese caso necesitarás una versión remota compatible con HTTP o una pasarela que publique el servicio mediante un transporte admitido.

Configurar la autenticación del servidor

Algunos servidores pueden conectarse sin autenticación, mientras que otros emplean OAuth, tokens o claves de API. Dify admite el registro dinámico de clientes para los servidores compatibles con OAuth.

Si el servidor no permite el registro automático, puedes desactivarlo e introducir el identificador y el secreto del cliente proporcionados por el servicio. Dify mostrará la URL de redirección que deberás registrar en el servidor.

Para los servicios que esperan un token estático, se pueden configurar headers personalizados. Un ejemplo habitual es:

Authorization: Bearer TU_TOKEN

No compartas capturas en las que aparezca el valor completo ni introduzcas secretos directamente en campos destinados a las instrucciones del modelo.

Actualizar las herramientas importadas

Cuando el servidor añade, elimina o modifica herramientas, puedes actualizar su catálogo desde Dify. Sin embargo, debes hacerlo con cuidado: si una aplicación utiliza una herramienta que ha desaparecido o cuyos parámetros han cambiado, el flujo puede dejar de funcionar.

El identificador del servidor también debe mantenerse estable. Las aplicaciones hacen referencia a él y, si lo cambias, tendrás que volver a añadir las herramientas correspondientes en cada flujo afectado.

Cuando exportes una aplicación para utilizarla en otro espacio de trabajo, deberás recrear allí el servidor MCP con el mismo identificador. Las credenciales y conexiones externas no se trasladan automáticamente con la aplicación.

Cómo utilizar herramientas MCP dentro de un agente de Dify

Una vez conectado el servidor, crea o abre un Workflow, Chatflow o agente y añade las herramientas importadas. Puedes utilizarlas mediante un nodo de herramienta cuando quieras controlar exactamente en qué momento se ejecutan.

La otra posibilidad es incorporarlas a un nodo Agent. En este caso, el modelo recibe la descripción de las herramientas y decide cuál debe invocar según la petición del usuario.

Dify permite trabajar con estrategias como Function Calling y ReAct. La primera aprovecha la capacidad nativa del modelo para llamar a herramientas. ReAct utiliza un ciclo de razonamiento, acción y observación para decidir los siguientes pasos.

El agente debe tener un límite razonable de iteraciones para impedir bucles y costes inesperados. Además, solo debería acceder a las herramientas imprescindibles para su tarea. Darle acceso indiscriminado a numerosos servidores dificulta la selección y aumenta el impacto de una posible instrucción maliciosa.

¿Sigue siendo necesario instalar un plugin MCP en Dify?

Antes de que Dify incorporase estas funciones de forma nativa, era habitual recurrir a plugins comunitarios. Uno de los más conocidos es mcp-server, que permite publicar aplicaciones mediante Streamable HTTP o el antiguo transporte SSE.

Para una instalación actual, la opción nativa de Dify es normalmente la alternativa más sencilla. El plugin comunitario puede seguir siendo útil en implementaciones antiguas o escenarios muy concretos, pero añade una dependencia adicional y no debe confundirse con la función oficial.

El propio autor del plugin recomienda utilizarlo exclusivamente dentro de una red privada. Por tanto, no conviene presentar su endpoint directamente en Internet sin comprender sus mecanismos de autenticación y sus riesgos.

Consejos para diseñar una integración MCP fiable

Describe con precisión las herramientas

El nombre, la descripción y los parámetros influyen directamente en la decisión del modelo. Explica qué hace la herramienta, cuándo debe utilizarse, qué datos necesita y qué devuelve.

Si dos herramientas tienen funciones parecidas, especifica claramente sus diferencias. De lo contrario, el agente puede elegir una opción incorrecta o realizar llamadas innecesarias.

Controla los permisos

No todas las aplicaciones necesitan herramientas capaces de modificar información. Siempre que sea posible, separa las operaciones de lectura de las acciones destructivas y exige confirmación para enviar mensajes, borrar registros o realizar compras.

También debes considerar los ataques de prompt injection. Un servidor que recupera contenido externo puede introducir instrucciones maliciosas dentro del contexto del agente. Limita las herramientas disponibles y valida los datos antes de ejecutar acciones sensibles.

Ajusta los tiempos de espera

MCP normaliza la comunicación, pero no acelera automáticamente la aplicación. Si el workflow de Dify tarda 30 segundos, ese retraso también se percibirá desde Claude o Cursor.

Dify permite ajustar el tiempo de espera de las solicitudes y de la lectura de respuestas transmitidas. No conviene aumentarlo sin motivo: primero revisa qué nodo, modelo o servicio externo está provocando el retraso.

Cuando una operación sea demasiado grande, puede resultar útil dividirla en herramientas más pequeñas y específicas. Además de reducir la latencia percibida, esto ayuda al modelo a elegir con mayor precisión qué acción debe ejecutar.

Errores frecuentes al conectar Dify con MCP

El cliente no reconoce la URL de Dify

Comprueba que el servidor MCP está activado, que has copiado la dirección completa y que no estás utilizando una URL regenerada anteriormente. Si cambiaste la dirección en Dify, debes actualizarla en todos los clientes.

Cursor no muestra la herramienta

Valida el contenido de .cursor/mcp.json, comprueba que se encuentra en la raíz del proyecto y reinicia Cursor si la configuración no se actualiza automáticamente.

Dify no conecta con un servidor externo

Verifica que el servidor utiliza un transporte HTTP compatible y que puede alcanzarse desde la red donde se ejecuta Dify. En una instalación mediante Docker, localhost dentro del contenedor no suele apuntar al ordenador anfitrión.

Revisa también el método de autenticación, los headers personalizados y los tiempos de espera. Los registros de Dify y del servidor pueden revelar errores de autorización, certificados, DNS o conexión.

Las herramientas dejan de funcionar después de actualizarlas

Es posible que el servidor haya cambiado el nombre, los parámetros o el esquema de una herramienta. Actualiza el catálogo y vuelve a configurar los nodos afectados. No cambies el identificador del servidor sin revisar antes todas las aplicaciones que dependen de él.

El agente elige la herramienta equivocada

Mejora las descripciones, reduce el número de herramientas disponibles y utiliza nombres diferenciados. También puedes recurrir a un nodo de herramienta convencional cuando necesites controlar exactamente qué operación debe ejecutarse.

Conectar Dify con MCP permite transformar una aplicación en una herramienta reutilizable desde Claude Desktop, Cursor y otros clientes compatibles. Al mismo tiempo, Dify puede importar herramientas procedentes de servidores remotos y utilizarlas dentro de workflows, chatflows y agentes.

La parte más importante no es únicamente conseguir que la conexión responda. También debes proteger las URLs y credenciales, definir entradas comprensibles, limitar los permisos y comprobar cómo se comportan las herramientas antes de utilizarlas con información real. Con estas precauciones, MCP puede convertir aplicaciones aisladas en un ecosistema modular de agentes y servicios interconectados.