Conectar un servidor MCP
Conectar uno de estos es como agregar una app a tu teléfono y darle permisos: eliges la app, inicias sesión y decides qué tiene permitido hacer. Nirvai resuelve los detalles técnicos por su cuenta.
Antes de empezar
- Una cuenta en la app que vas a conectar, con permiso para aprobar el acceso.
- En algunas apps, un pequeño paso de configuración dentro de su propio panel de administración — Nirvai te avisa cuándo y te lleva ahí.
Conéctalo
- Abre Integraciones y haz clic en Conectar app.
- Elige la app del catálogo, o elige Otro servidor MCP y pega su dirección.
- Nirvai revisa la dirección y te dice qué encontró — cuántas acciones ofrece y cómo quiere que inicies sesión.
- Inicia sesión con el método que te pida (más abajo).
- Elige las acciones que debería recibir tu agente. Seleccionar recomendadas escoge un conjunto inicial sensato.
- Listo — la conexión aparece en la página de Integraciones.
Cómo te piden iniciar sesión las apps
Nirvai lo detecta por ti; solo verás el caso que corresponde.
| Qué ves | Qué hacer |
|---|---|
| Iniciar sesión con [app] | Se abre una ventana, apruebas y se cierra. Nada que copiar ni pegar. |
| Un campo de código o pase de acceso | La app te dio un código privado. Pégalo ahí. |
| Nada | Algunos servidores están abiertos a todo el mundo, como las consultas de documentación pública. |
| Usar mi propia app | La app exige que registres Nirvai tú mismo primero. Ver más abajo. |
Cuando una app exige su propia app de inicio de sesión
Algunas apps no aceptan una conexión compartida — HubSpot, GitHub y Asana son las que tenemos confirmadas. Quieren que crees una pequeña app de inicio de sesión dentro de su propio panel de administración, dedicada a esta conexión.
Cuando es el caso, Nirvai abre por ti la sección Usar mi propia app OAuth, con un enlace a las instrucciones de esa app. Tendrás que:
- Seguir el enlace y crear la app de inicio de sesión en el panel de administración del proveedor.
- Copiar la dirección de retorno que Nirvai te muestra dentro de los ajustes de esa app — así el proveedor sabe a dónde devolverte.
- Pegar en Nirvai el client ID y el client secret que te entrega el proveedor.
- Continuar con Iniciar sesión, exactamente como siempre.
La app de desarrollador propia de HubSpot no sirve aquí — su conexión MCP requiere una MCP Auth App aparte, creada en Development → MCP Auth Apps dentro de HubSpot. Los datos de una app existente serán rechazados.
Cualquier app ofrece esta opción si prefieres usar tu propia app de inicio de sesión; para la mayoría es opcional.
Mantenerlo al día
- Sincronizar vuelve a leer la lista de acciones de la app. Las nuevas aparecen apagadas para que elijas; las que se quitaron se apagan solas.
- Las acciones que cambiaron quedan marcadas para que las apruebes, así una acción nunca empieza a hacer algo distinto en silencio.
- Probar confirma que la conexión sigue viva.
- Desconectar cierra la sesión y quita las acciones de esa conexión de todos los agentes que las usan. Nirvai te muestra primero a qué agentes afecta.
Tu sesión se renueva sola en segundo plano. Si no puede, la tarjeta se pone ámbar con Requiere iniciar sesión y un clic lo arregla.
Solución de problemas
| Qué ves | Qué significa | Qué hacer |
|---|---|---|
| "No pudimos alcanzar esa dirección" | La dirección está mal, o el servidor está caído | Revisa que empiece con https:// y coincida con la documentación de la app |
| "Requiere iniciar sesión" después de conectar | La ventana de aprobación se cerró o se canceló | Haz clic en Iniciar sesión en la tarjeta y termina la aprobación |
| La tarjeta se pone ámbar más tarde | La sesión venció o fue revocada en la app | Haz clic en Iniciar sesión otra vez; no se pierde nada más |
| "Esta app necesita su propia app de inicio de sesión" | El proveedor no permite conexiones compartidas | Sigue los pasos de arriba para crear una |
| La app no acepta tus datos de inicio de sesión | Usaste una app existente en vez de una dedicada | Crea una app nueva como indican las instrucciones del proveedor |
| Una acción desapareció | La app la quitó | Nada que hacer — queda apagada y tus agentes la omiten |
| Demasiadas acciones para elegir | La app ofrece decenas | Usa Seleccionar recomendadas, o busca y elige unas pocas; agregas más después |