Integraciones
Conectar un servidor MCP
Qué es un servidor MCP y cómo conectarlo, iniciar sesión y elegir cuáles de sus acciones puede usar tu agente.
Normalmente le enseñas a tu agente una acción a la vez. Un servidor MCP se salta eso: conectarlo es como agregar una app a tu teléfono y darle permisos. La app publica una lista de todo lo que sabe hacer, y tu agente lee esa lista apenas la conectas — decenas de acciones listas a partir de un solo inicio de sesión.
MCP significa Model Context Protocol, un estándar compartido que apps como Linear, Notion, Stripe y GitHub ya hablan. Nunca tienes que aprenderlo; solo conectas la app.
| Herramienta personalizada | Servidor MCP | |
|---|---|---|
| Configuración | Tú defines cada acción | La app las entrega todas |
| Ideal para | Una cosa concreta que necesitas | Trabajar ampliamente dentro de una app |
| Quién lo mantiene | Tú | Quienes hacen la app |
| Se mantiene al día | Tú lo actualizas | Las acciones nuevas aparecen al sincronizar |
Si una app que usas ofrece uno, casi siempre es el camino más rápido. El catálogo de Nirvai es una comodidad, no un límite: si una app publica una dirección MCP — o tu equipo tiene la suya propia — pegas la dirección y se conecta igual.
Esta página trata sobre tu agente de Nirvai usando una app externa. Conecta tu agente es lo contrario: permitir que un asistente externo como Claude Code use tu cuenta de Nirvai. Ambos usan MCP, en direcciones opuestas.
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.
- Crear incidencia
linear_create_issueMCPGestionada por la app - Listar incidencias
linear_list_issuesMCPGestionada por la app - Buscar proyectos
linear_search_projectsMCPGestionada por la app
Aparece en la página de Integraciones como cualquier otra conexión, con una etiqueta MCP y un candado en cada acción. Activa solo las acciones que necesitas — un servidor puede ofrecer sesenta, y unas pocas bien elegidas mantienen a tu agente rápido. Las acciones son de solo lectura: la app decide qué hace cada una, así que puedes encenderlas y apagarlas, pero no reescribirlas. Para cambiar el comportamiento, dile a tu agente cuándo usarlas en sus instrucciones.
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 clave o token | La app te dio una credencial — 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 |