Añadir un conector MCP personalizado
En esta página
Actualizado el 2 de noviembre de 2026 — Le Chat es ahora Vibe. Desde el 28 de mayo de 2026, Le Chat ha cambiado de marca para convertirse en Vibe (todavía en chat.mistral.ai): un único agente para el trabajo y el código que conserva tus conversaciones, configuraciones y suscripciones. La experiencia heredada de Le Chat sigue disponible en el modo Chat; en el modo Work, los agentes son ahora habilidades (que se invocan con
@), las memorias actúan como base de conocimientos y la búsqueda profunda es la habilidad Deep Research. Los planes se llaman ahora Mistral Free, Pro, Team y Enterprise. Esta lección utiliza el nombre Vibe; es posible que algunos menús descritos aquí hayan cambiado de nombre o de ubicación.
Más allá del directorio oficial
Los conectores integrados cubren muchos casos de uso, pero es probable que tu organización dependa de herramientas internas, API propietarias o servicios de nicho que no figuran en el directorio de Vibe. Aquí es donde entran en juego los conectores personalizados: puedes añadir cualquier servidor MCP remoto a Vibe simplemente proporcionando su URL. Ese CRM interno desarrollado hace seis años se vuelve utilizable en una conversación, igual que GitHub o Notion.
El proceso de adición
Añadir un conector requiere solo unos pocos clics en la interfaz. Abre la pestaña Connectors, haz clic en Add a custom connector en la parte inferior de la lista y rellena los detalles requeridos:
- Name: Un nombre descriptivo para identificar el conector (por ejemplo, «Internal CRM» o «Weather API»)
- Server URL: La dirección pública de tu servidor MCP, incluyendo el punto final
/mcp(por ejemplo,https://mon-serveur.example.com/mcp) - Description: Una breve explicación de lo que hace el conector (opcional, pero recomendada)
- Authentication method: None, Token u OAuth 2.0
Por último, haz clic en Create para guardar el conector. Vibe consulta automáticamente al servidor para descubrir las herramientas disponibles: aparece la lista de funciones expuestas y puedes empezar a usarlas en tus conversaciones.
Esta solicitud de descubrimiento devuelve el name, la description en texto, los parameters esperados (con su nombre, tipo y descripción) y el return type de cada herramienta. Estos son los únicos detalles que el modelo de Mistral utiliza para decidir cuándo y cómo invocar cada herramienta; por eso la siguiente lección se centra tanto en la calidad de la descripción. Una herramienta bien escrita con una descripción deficiente permanece invisible para el modelo.
Métodos de autenticación
El caso más sencillo es la ausencia de autenticación: tu servidor MCP es accesible para cualquiera que conozca su URL. Esto funciona para herramientas públicas que no manejan datos sensibles, prototipos, demostraciones y servidores MCP que envuelven API públicas. La autenticación por token implica proporcionar una clave que se envía con cada solicitud al servidor; Vibe almacena el token de forma segura. Elige esta opción para API internas protegidas por una clave de API, servidores que necesitan identificar al llamador y cualquier escenario en el que quieras restringir el acceso. Por último, está OAuth 2.0, el flujo completo con redirección a la página de autorización del servicio: es el mecanismo más seguro, pero también el más complejo de implementar en el lado del servidor, y se tratará en profundidad en futuras guías de Mistral AI.
Requisitos previos para tu servidor MCP
- Accesible mediante una URL pública (no localhost)
- Expone un punto final en formato Streamable HTTP (
/mcp) - Responde a solicitudes de descubrimiento de herramientas en formato MCP JSON estándar
- Gestiona correctamente las llamadas a herramientas y devuelve resultados en el formato esperado
El requisito de la URL pública podría parecer un obstáculo para el desarrollo local, pero existe una solución durante la fase de depuración. Si estás desarrollando en tu máquina y quieres probar con Vibe antes de desplegar, abre un túnel hacia tu servidor local usando ngrok:
ngrok http 8000
ngrok te proporciona una URL pública temporal que puedes usar como URL del conector en Vibe. Este enfoque es ideal para el desarrollo y las pruebas: modificas tu código, reinicias y Vibe ve inmediatamente la nueva versión sin necesidad de ningún despliegue.
Pruebas con MCP Inspector
Antes de añadir tu servidor a Vibe, pruébalo con MCP Inspector, una herramienta de código abierto que verifica que tu servidor responde correctamente a las solicitudes de descubrimiento, enumera las herramientas disponibles con sus descripciones y parámetros, ejecuta llamadas a herramientas manualmente para comprobar los resultados y ayuda a depurar problemas de formato o de tipado. Lánzalo con un sencillo comando npx:
npx @modelcontextprotocol/inspector
Inspector abre una interfaz web local donde conectas tu servidor MCP y pruebas cada herramienta individualmente. Este paso no es un mero trámite: te evita gastar mensajes de conversación en la depuración y aísla claramente los errores del servidor de los errores de interpretación del modelo.
Gestión organizativa
Si formas parte de una organización en Vibe, ten en cuenta que los conectores personalizados que añadas son visibles para otros miembros. Un administrador puede desactivar cualquier conector para toda la organización si lo considera inadecuado o inseguro. Sin embargo, cada usuario debe proporcionar sus propias credenciales (token u OAuth) para los conectores que requieren autenticación: compartir un conector nunca significa compartir las credenciales de acceso.
Seguridad de los conectores personalizados
A diferencia de los conectores oficiales validados por Mistral AI, un conector personalizado puede ejecutar código arbitrario en el lado del servidor, y la descripción de texto que ves no garantiza nada sobre lo que el servidor hace realmente. Limítate a servidores que hayas desarrollado tú mismo, los de colegas o socios de confianza y los servidores de código abierto cuyo código hayas verificado. Incluso con tus propios conectores, mantén la validación humana activada durante toda la fase de depuración; una vez que estés seguro de que todo funciona, puedes plantearte configurar las herramientas de solo lectura como «Always Allow».
Puntos clave
- Puedes añadir cualquier servidor MCP remoto como conector personalizado en Vibe
- El servidor debe ser accesible mediante una URL pública con un punto final
/mcp - Se admiten tres métodos de autenticación: none, token y OAuth 2.0
- Usa ngrok para probar tu servidor local con Vibe antes de desplegarlo
- MCP Inspector es esencial para depurar tu servidor antes de la integración
- Añade solo conectores de fuentes de confianza y mantén la validación humana activada