Ir al contenido principal
Español— Elegir un idioma
Menú

Integrar un servidor personalizado en Vibe

Lección 13 de 14 Actualizado el 2 de noviembre de 2026 Desarrollador
En esta página
  1. Conectar tu servidor MCP a Vibe
  2. Añadir el conector
  3. Qué ocurre en la conversación
  4. Cuando no funciona
  5. El inspector MCP: úsalo antes que Vibe
  6. Convivir con múltiples servidores
  7. Puntos clave

Actualización del 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 accesible en el modo Chat; en el modo Work, los agentes se han convertido en habilidades (que se invocan con @), las memorias son ahora la base de conocimientos y la búsqueda profunda se ha transformado en la habilidad Deep Research. Los planes se denominan ahora Mistral Free, Pro, Team y Enterprise. Esta lección utiliza el nombre Vibe; ten en cuenta que algunos menús descritos aquí pueden haber cambiado de nombre o de ubicación.

Conectar tu servidor MCP a Vibe

Tu servidor está desplegado y responde mediante HTTPS en una dirección estable. Ahora llega el paso que da sentido a todo tu trabajo anterior: hacerlo usable en una conversación para tu audiencia prevista, incluidos aquellos que nunca abrirán un terminal. Vibe acepta cualquier servidor MCP compatible como conector personalizado. Esta lección cubre cómo añadir el conector, recorrer los flujos de llamada en una conversación y diagnosticar fallos, porque el primer intento suele fallar.

Añadir el conector

Abre Vibe en chat.mistral.ai y navega hasta la pestaña Connectors de la barra lateral. Encontrarás dos secciones distintas: conectores destacados, preconfigurados por Mistral (GitHub, Notion y otros), y tus propios conectores personalizados, inicialmente vacíos. Haz clic en Add Custom Connector y rellena los campos:

  1. Name: Un nombre descriptivo (p. ej., “Task Manager”)
  2. Server URL: La URL completa de tu punto final MCP (p. ej., https://my-server.com/tasks/mcp)
  3. Description: Qué hace tu servidor (opcional, pero recomendado)

A continuación, elige tu método de autenticación: No authentication para un servidor público, Token si pegas tu token de API, u OAuth 2.0 para un flujo de consentimiento completo. Al hacer clic en Connect se inicia el descubrimiento: si tiene éxito, Vibe muestra la lista de herramientas encontradas en tu servidor, con el nombre y la descripción de cada una. Esta es tu primera retroalimentación real sobre la calidad de tus docstrings: las lees aquí exactamente igual que las recibirá el modelo.

Qué ocurre en la conversación

Una vez conectado, tu servidor aparece en la sección Tools de la barra lateral del chat, marcada con un icono que indica la disponibilidad de herramientas externas. El usuario expresa su solicitud en lenguaje natural y el modelo la traduce:

Usuario: Crea una tarea de alta prioridad para preparar la demo de MCP

Vibe: [Llamando a create_task con los siguientes argumentos]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → ¿Quieres autorizar esta llamada a la herramienta?

Usuario: [Autorizar]

Vibe: La tarea "Prepare the MCP demo" se ha creado correctamente
con alta prioridad. Su ID es abc123.

Este aviso de confirmación es el comportamiento predeterminado. Puedes aprobarlo ad hoc o cambiar una herramienta a autorización permanente. Resiste la tentación de hacer esto con cualquier servidor que no sea de tu propiedad. La confirmación protege no solo contra errores; es tu única defensa contra las inyecciones de prompts, donde instrucciones ocultas en los datos devueltos por una herramienta dirigen al modelo hacia llamadas que nadie ha solicitado. Ver los argumentos pasar antes de la validación es lo que te permite detectar la anomalía.

Cuando no funciona

El mensaje “Unable to connect” casi siempre se debe a una de estas cuatro causas: la URL es inaccesible desde el exterior, el protocolo no es HTTPS (que Vibe requiere), el servidor simplemente no está en ejecución o CORS no está configurado, aunque Vibe envíe solicitudes desde un navegador. El siguiente comando distingue entre las dos primeras hipótesis en segundos:

# Probar accesibilidad
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Si la conexión tiene éxito pero no aparecen herramientas, rastrea la cadena hacia atrás en el lado del servidor: verifica que el decorador @app.tool() esté presente en cada función, que no falten docstrings y que el servidor MCP esté montado en la ruta que crees que es. Usa MCP Inspector antes de cualquier otra investigación.

El caso más confuso es cuando todo funciona, pero el modelo llama a la herramienta equivocada o a ninguna. El problema entonces no es técnico: el modelo elige basándose en las descripciones, y si dos herramientas se parecen o si una permanece vaga, elige mal. Usa tres palancas, en este orden: haz la descripción más específica aclarando el caso de uso, cambia el nombre de la herramienta para eliminar la ambigüedad y reduce el número de herramientas activas simultáneamente. Por último, si una herramienta devuelve un error, revisa los registros del servidor, reproduce la llamada manualmente en el inspector y verifica que las variables de entorno estén establecidas y que el token o los ámbitos de OAuth otorguen los permisos esperados.

El inspector MCP: úsalo antes que Vibe

El inspector prueba tus herramientas sin involucrar al modelo, aislando la mitad de las variables del problema:

npx @modelcontextprotocol/inspector

Abre una interfaz web donde te conectas a tu servidor remoto mediante su URL, listas todas las herramientas con sus descripciones y parámetros, ejecutas una herramienta con argumentos de tu elección y lees la respuesta cruda del servidor. Acostúmbrate a realizar esta comprobación sistemáticamente antes de añadir un servidor a Vibe, ya que te ofrece un diagnóstico inmediato: si una herramienta responde correctamente en el inspector pero falla en Vibe, el servidor no tiene la culpa y el problema reside en la descripción o en el prompt.

Convivir con múltiples servidores

Una vez que hayas instalado varios conectores, la disciplina se convierte en el factor principal de calidad. Vibe te permite activar o desactivar cada conector: mantén activas solo las herramientas necesarias para la tarea actual, porque un modelo ahogado en cincuenta herramientas elige con menos precisión y responde más lentamente. Esta higiene se basa en la separación de dominios tratada en la Lección 10: un servidor para la gestión de proyectos, uno para la monitorización y otro para herramientas internas, ya que así solo necesitas activar el que coincide con la conversación actual.

Por último, adapta tus prompts a las capacidades realmente expuestas:

# Correcto: refleja las capacidades de la herramienta
"Crea una tarea de alta prioridad titulada 'Prepare the demo'"

# Incorrecto: demasiado vago, el modelo no sabe qué herramienta usar
"Gestiona mi proyecto"

Un último punto que vale la pena conocer antes de diseñar tus servidores: los conectores MCP configurados en Vibe siguen disponibles en la aplicación móvil. Tus herramientas internas se vuelven así accesibles desde un teléfono, abriendo escenarios de uso sobre el terreno que quizás no consideraras al desarrollar en un escritorio.

Puntos clave

  • Añadir un conector personalizado en Vibe requiere 3 pasos: nombre, URL y autenticación
  • Mantén habilitada la confirmación manual de las llamadas a herramientas por seguridad
  • Usa el MCP Inspector para probar y depurar antes de integrar en Vibe
  • Mejora las descripciones de las herramientas si el modelo no las usa correctamente
  • Mantén activas solo las herramientas necesarias para la tarea actual
  • Tus servidores MCP también son accesibles en móviles