mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
74 lines
4.6 KiB
Plaintext
74 lines
4.6 KiB
Plaintext
---
|
|
title: "Conectar integraciones"
|
|
description: "Conecta servicios externos como Linear, Notion, Slack y HubSpot para que el agente de Mintlify los use como contexto al redactar la documentación."
|
|
keywords: ["integraciones", "Composio", "Linear", "Notion", "HubSpot", "integraciones del agente", "herramientas de terceros"]
|
|
---
|
|
|
|
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](https://docs.composio.dev/toolkits) para admitir un amplio catálogo de integraciones, incluidos rastreadores de incidencias, bases de conocimiento, CRMs, herramientas de analítica y herramientas para desarrolladores.
|
|
|
|
<Note>
|
|
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.
|
|
</Note>
|
|
|
|
<Note>
|
|
GitHub y GitLab deben configurarse a través de Mintlify, no de Composio. Usa la [aplicación de GitHub](/es/deploy/github) o la [integración de GitLab](/es/deploy/gitlab) para controlar a qué repositorios puede acceder el agente.
|
|
</Note>
|
|
|
|
<div id="organization-level-vs-personal-integrations">
|
|
## Integraciones a nivel de organización frente a personales
|
|
</div>
|
|
|
|
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](/es/agent/slack#connect-additional-integrations-from-slack).
|
|
|
|
<div id="install-an-integration">
|
|
## Instalar una integración
|
|
</div>
|
|
|
|
1. Ve a **Settings → Integrations** en tu [panel](https://dashboard.mintlify.com/settings/organization/integrations).
|
|
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.
|
|
|
|
<div id="configure-or-disconnect-an-integration">
|
|
## Configurar o desconectar una integración
|
|
</div>
|
|
|
|
Para desconectar una integración:
|
|
|
|
1. Ve a **Settings → Integrations** en tu [panel](https://dashboard.mintlify.com/settings/organization/integrations).
|
|
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**.
|
|
|
|
<div id="expired-or-revoked-connections">
|
|
## Conexiones expiradas o revocadas
|
|
</div>
|
|
|
|
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.
|
|
|
|
<div id="next-steps">
|
|
## Próximos pasos
|
|
</div>
|
|
|
|
<Card title="Añade el agente a Slack" horizontal icon="slack" href="/es/agent/slack">
|
|
Permite que tus compañeros instalen sus propias integraciones personales desde Slack.
|
|
</Card>
|
|
<Card title="Personalizar el comportamiento del agente" horizontal icon="wrench" href="/es/agent/customize">
|
|
Usa un archivo `AGENTS.md` para indicarle al agente cómo usar el contexto que obtiene de tus integraciones.
|
|
</Card>
|