Conectar integraciones

Conecta servicios externos como Linear, Notion, Slack y HubSpot para que el agente de Mintlify los use como contexto al redactar la documentación.

Conecta servicios de terceros a tu organización de Mintlify para que el agente pueda leer tickets, documentos, grabaciones y otro contenido de esos servicios cuando investigue y escriba documentación.

Mintlify usa Composio para admitir un amplio catálogo de integraciones, incluidos rastreadores de incidencias, bases de conocimiento, CRMs, herramientas de analítica y herramientas para desarrolladores.

Instalar integraciones a nivel de organización requiere el rol Administrador. La página Integrations se oculta de la barra lateral de configuración para los usuarios que no tienen permiso para gestionar el agente.

GitHub y GitLab deben configurarse a través de Mintlify, no de Composio. Usa la aplicación de GitHub o la integración de GitLab para controlar a qué repositorios puede acceder el agente.

​

Integraciones a nivel de organización frente a personales

El agente admite dos tipos de conexiones de integración:

• Las integraciones a nivel de organización las instala una vez un administrador y las comparten todas las personas de tu organización. El agente las usa como alternativa cuando no hay una conexión personal disponible. Gestiónalas desde la página Settings → Integrations del panel.
• Las integraciones personales las instalan los usuarios individuales desde Slack y solo se aplican a ese usuario. El agente usa la conexión de quien haya enviado el mensaje. Consulta Conectar integraciones adicionales desde Slack.

​

Instalar una integración

1. Ve a Settings → Integrations en tu panel.
2. En Available to your team, encuentra el servicio que quieres conectar. Usa el campo de búsqueda para filtrar la lista o haz clic en Show more para cargar más toolkits.
3. Haz clic en la tarjeta de la integración y luego en Connect en el cuadro de diálogo.
4. Se abre una ventana emergente con la página de autorización del proveedor. Inicia sesión en el servicio de terceros y aprueba los permisos solicitados.
5. Después de autorizar, la ventana emergente se cierra automáticamente y la integración aparece en Enabled Integrations con un mensaje de confirmación.

Si el navegador bloquea la ventana emergente, permite las ventanas emergentes para dashboard.mintlify.com e inténtalo de nuevo. Si no completas la autorización en cinco minutos, la conexión expira y puedes volver a intentarlo.

​

Configurar o desconectar una integración

Para desconectar una integración:

1. Ve a Settings → Integrations en tu panel.
2. En Enabled Integrations, haz clic en el icono de engranaje de la integración que quieres gestionar.
3. Haz clic en Disconnect en el cuadro de diálogo.

Después de desconectar, el agente deja de usar el servicio como contexto. Para volver a conectar más tarde, instala la integración de nuevo desde la sección Available to your team.

​

Conexiones expiradas o revocadas

Mintlify mantiene sincronizado el estado de los servicios conectados con Composio. Una conexión deja de estar activa cuando:

• El proveedor de terceros expira o revoca las credenciales.
• El proveedor marca la conexión como inactiva.
• Un administrador desconecta la integración.

Las integraciones inactivas dejan de aparecer en Enabled Integrations. Reinstala la integración desde la sección Available to your team para restaurar el acceso.

​

Próximos pasos

Añade el agente a Slack

Permite que tus compañeros instalen sus propias integraciones personales desde Slack.

Personalizar el comportamiento del agente

Usa un archivo AGENTS.md para indicarle al agente cómo usar el contexto que obtiene de tus integraciones.