From b0f2e07f2adb3f08d2824ae1075a9f8d7c454eef Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 15 May 2026 03:01:56 +0000 Subject: [PATCH 1/2] docs: document Settings Integrations page for agent --- agent/integrations.mdx | 63 ++++++++++++++++++++++++++++++++++++++++++ agent/slack.mdx | 4 +-- docs.json | 1 + 3 files changed, 66 insertions(+), 2 deletions(-) create mode 100644 agent/integrations.mdx diff --git a/agent/integrations.mdx b/agent/integrations.mdx new file mode 100644 index 000000000..dfa19a4d8 --- /dev/null +++ b/agent/integrations.mdx @@ -0,0 +1,63 @@ +--- +title: "Connect integrations" +description: "Connect third-party services like Linear, Notion, Slack, and HubSpot so the Mintlify agent can use them as context when it writes documentation." +keywords: ["integrations", "Composio", "Linear", "Notion", "HubSpot", "agent integrations", "third-party tools"] +--- + +Connect third-party services to your Mintlify organization so the agent can read tickets, docs, recordings, and other content from those services when it researches and writes documentation. + +Mintlify uses [Composio](https://docs.composio.dev/toolkits) to support a broad catalog of integrations, including issue trackers, knowledge bases, CRMs, analytics tools, and developer tools. + + + Installing organization-level integrations requires the **Admin** role. The **Integrations** page is hidden from the settings sidebar for users without permission to manage the agent. + + + + You must configure GitHub and GitLab through Mintlify, not Composio. Use the [GitHub app](/deploy/github) or [GitLab integration](/deploy/gitlab) to control which repositories the agent can access. + + +## Organization-level vs. personal integrations + +The agent supports two types of integration connections: + +- **Organization-level integrations** are installed once by an admin and shared by everyone in your organization. The agent uses them as a fallback when no personal connection is available. Manage these from the **Settings → Integrations** page in the dashboard. +- **Personal integrations** are installed by individual users from Slack and apply only to that user. The agent uses the connection of whoever sent the message. See [Connect additional integrations from Slack](/agent/slack#connect-additional-integrations-from-slack). + +## Install an integration + +1. Go to **Settings → Integrations** in your [dashboard](https://dashboard.mintlify.com/settings/organization/integrations). +2. Under **Available to your team**, find the service that you want to connect. Use the search field to filter the list, or click **Show more** to load additional toolkits. +3. Click the integration card, then click **Connect** in the dialog. +4. A popup window opens to the provider's authorization page. Sign in to the third-party service and approve the requested permissions. +5. After you authorize, the popup closes automatically and the integration appears under **Enabled Integrations** with a success toast. + +If the popup is blocked by your browser, allow popups for `dashboard.mintlify.com` and try again. If you do not finish the authorization within five minutes, the connection times out and you can retry. + +## Configure or disconnect an integration + +To disconnect an integration: + +1. Go to **Settings → Integrations** in your [dashboard](https://dashboard.mintlify.com/settings/organization/integrations). +2. Under **Enabled Integrations**, click the gear icon on the integration that you want to manage. +3. Click **Disconnect** in the dialog. + +After you disconnect, the agent stops using the service as context. To reconnect later, install the integration again from the **Available to your team** section. + +## Expired or revoked connections + +Mintlify keeps the status of your connected services in sync with Composio. A connection becomes inactive when: + +- The third-party provider expires or revokes the credentials. +- The provider marks the connection as inactive. +- An admin disconnects the integration. + +Inactive integrations stop appearing under **Enabled Integrations**. Reinstall the integration from the **Available to your team** section to restore access. + +## Next steps + + + Let teammates install their own personal integrations from Slack. + + + Use an `AGENTS.md` file to tell the agent how to use the context that it gathers from your integrations. + diff --git a/agent/slack.mdx b/agent/slack.mdx index 5bf7c569b..6f972fca1 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -60,9 +60,9 @@ To add a new integration from Slack: 3. Click the link, sign in to the third-party service, and approve the requested permissions. After you authorize, your browser displays a confirmation page indicating that the connection is complete. 4. Return to Slack. The agent confirms the connection and can immediately use the integration as context for future requests. -Integrations that you connect from Slack apply to individual Slack users, so each teammate sets up their own connections and the agent uses the connections of whoever sent the message. If a Slack user has not connected a service, the agent falls back to the organization-level integrations installed from the [Agent](https://dashboard.mintlify.com/products/agent) page in the dashboard. +Integrations that you connect from Slack apply to individual Slack users, so each teammate sets up their own connections and the agent uses the connections of whoever sent the message. If a Slack user has not connected a service, the agent falls back to the organization-level integrations installed from the [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations) page in the dashboard. -To remove or reauthorize an organization-level integration, use the **Agent settings** section of the [Agent](https://dashboard.mintlify.com/products/agent) page. +To install, remove, or reauthorize an organization-level integration, use the [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations) page. For more, see [Connect integrations](/agent/integrations). For the full list of supported services, see the [Composio toolkits catalog](https://docs.composio.dev/toolkits). diff --git a/docs.json b/docs.json index 2072f693a..d214381a1 100644 --- a/docs.json +++ b/docs.json @@ -103,6 +103,7 @@ "root": "agent/index", "pages": [ "agent/slack", + "agent/integrations", "agent/customize", "agent/effective-prompts", "agent/use-cases" From 65886e7627448c7c3dc5be6efa6931a22ddf4044 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 15 May 2026 03:05:07 +0000 Subject: [PATCH 2/2] docs: translate integrations page to es and fr --- es.json | 1 + es/agent/integrations.mdx | 73 +++++++++++++++++++++++++++++++++++++++ es/agent/slack.mdx | 4 +-- fr.json | 1 + fr/agent/integrations.mdx | 73 +++++++++++++++++++++++++++++++++++++++ fr/agent/slack.mdx | 4 +-- 6 files changed, 152 insertions(+), 4 deletions(-) create mode 100644 es/agent/integrations.mdx create mode 100644 fr/agent/integrations.mdx diff --git a/es.json b/es.json index d25811960..262ff98d8 100644 --- a/es.json +++ b/es.json @@ -83,6 +83,7 @@ "pages": [ "es/agent/index", "es/agent/slack", + "es/agent/integrations", "es/agent/customize", "es/agent/effective-prompts", "es/agent/workflows" diff --git a/es/agent/integrations.mdx b/es/agent/integrations.mdx new file mode 100644 index 000000000..bd2c4691b --- /dev/null +++ b/es/agent/integrations.mdx @@ -0,0 +1,73 @@ +--- +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. + + + 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](/es/deploy/github) o la [integración de GitLab](/es/deploy/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](/es/agent/slack#connect-additional-integrations-from-slack). + +
+ ## Instalar una integración +
+ +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. + +
+ ## Configurar o desconectar una integración +
+ +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**. + +
+ ## 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 +
+ + + Permite que tus compañeros instalen sus propias integraciones personales desde Slack. + + + Usa un archivo `AGENTS.md` para indicarle al agente cómo usar el contexto que obtiene de tus integraciones. + diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 80b6f9803..0ad545dc4 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -54,9 +54,9 @@ Para añadir una nueva integración desde Slack: 3. Haz clic en el enlace, inicia sesión en el servicio de terceros y aprueba los permisos solicitados. 4. Vuelve a Slack. El agente confirma la conexión y puede usar inmediatamente la integración como contexto para futuras solicitudes. -Las integraciones que conectes desde Slack se aplican al ámbito de tu usuario individual de Slack, por lo que cada miembro del equipo configura sus propias conexiones y el agente usa las conexiones de quien haya enviado el mensaje. Si un usuario de Slack no ha conectado un servicio, el agente recurre a las integraciones a nivel de organización instaladas desde la página [Agent](https://dashboard.mintlify.com/products/agent) en el panel. +Las integraciones que conectes desde Slack se aplican al ámbito de tu usuario individual de Slack, por lo que cada miembro del equipo configura sus propias conexiones y el agente usa las conexiones de quien haya enviado el mensaje. Si un usuario de Slack no ha conectado un servicio, el agente recurre a las integraciones a nivel de organización instaladas desde la página [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations) en el panel. -Para eliminar o volver a autorizar una integración a nivel de organización, usa la sección **Agent settings** de la página [Agent](https://dashboard.mintlify.com/products/agent). +Para instalar, eliminar o volver a autorizar una integración a nivel de organización, usa la página [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations). Para más información, consulta [Conectar integraciones](/es/agent/integrations). Para ver la lista completa de servicios admitidos, consulta el [catálogo de toolkits de Composio](https://docs.composio.dev/toolkits). diff --git a/fr.json b/fr.json index 9156ba872..3c8a6ee25 100644 --- a/fr.json +++ b/fr.json @@ -83,6 +83,7 @@ "pages": [ "fr/agent/index", "fr/agent/slack", + "fr/agent/integrations", "fr/agent/customize", "fr/agent/effective-prompts", "fr/agent/workflows" diff --git a/fr/agent/integrations.mdx b/fr/agent/integrations.mdx new file mode 100644 index 000000000..2c47c39a3 --- /dev/null +++ b/fr/agent/integrations.mdx @@ -0,0 +1,73 @@ +--- +title: "Connecter des intégrations" +description: "Connectez des services tiers comme Linear, Notion, Slack et HubSpot pour que l'agent Mintlify les utilise comme contexte lors de la rédaction de la documentation." +keywords: ["intégrations", "Composio", "Linear", "Notion", "HubSpot", "intégrations de l'agent", "outils tiers"] +--- + +Connectez des services tiers à votre organisation Mintlify pour que l'agent puisse lire des tickets, des documents, des enregistrements et d'autres contenus issus de ces services lorsqu'il effectue ses recherches et rédige la documentation. + +Mintlify s'appuie sur [Composio](https://docs.composio.dev/toolkits) pour prendre en charge un large catalogue d'intégrations, y compris des outils de suivi des incidents, des bases de connaissances, des CRM, des outils d'analyse et des outils pour développeurs. + + + L'installation d'intégrations au niveau de l'organisation nécessite le rôle **Administrateur**. La page **Integrations** est masquée dans la barre latérale des paramètres pour les utilisateurs qui n'ont pas l'autorisation de gérer l'agent. + + + + GitHub et GitLab doivent être configurés via Mintlify, et non via Composio. Utilisez l'[application GitHub](/fr/deploy/github) ou l'[intégration GitLab](/fr/deploy/gitlab) pour contrôler les dépôts auxquels l'agent peut accéder. + + +
+ ## Intégrations au niveau de l'organisation et intégrations personnelles +
+ +L'agent prend en charge deux types de connexions d'intégration : + +- Les **intégrations au niveau de l'organisation** sont installées une fois par un administrateur et partagées par tous les membres de votre organisation. L'agent les utilise comme solution de repli lorsqu'aucune connexion personnelle n'est disponible. Gérez-les depuis la page **Settings → Integrations** du tableau de bord. +- Les **intégrations personnelles** sont installées par les utilisateurs individuels depuis Slack et ne s'appliquent qu'à cet utilisateur. L'agent utilise la connexion de la personne qui a envoyé le message. Consultez [Connecter des intégrations supplémentaires depuis Slack](/fr/agent/slack#connect-additional-integrations-from-slack). + +
+ ## Installer une intégration +
+ +1. Accédez à **Settings → Integrations** dans votre [tableau de bord](https://dashboard.mintlify.com/settings/organization/integrations). +2. Sous **Available to your team**, trouvez le service que vous souhaitez connecter. Utilisez le champ de recherche pour filtrer la liste, ou cliquez sur **Show more** pour charger d'autres toolkits. +3. Cliquez sur la carte de l'intégration, puis sur **Connect** dans la boîte de dialogue. +4. Une fenêtre contextuelle s'ouvre sur la page d'autorisation du fournisseur. Connectez-vous au service tiers et approuvez les autorisations demandées. +5. Après l'autorisation, la fenêtre contextuelle se ferme automatiquement et l'intégration apparaît sous **Enabled Integrations** avec un message de confirmation. + +Si la fenêtre contextuelle est bloquée par votre navigateur, autorisez les fenêtres contextuelles pour `dashboard.mintlify.com` et réessayez. Si vous ne terminez pas l'autorisation dans les cinq minutes, la connexion expire et vous pouvez réessayer. + +
+ ## Configurer ou déconnecter une intégration +
+ +Pour déconnecter une intégration : + +1. Accédez à **Settings → Integrations** dans votre [tableau de bord](https://dashboard.mintlify.com/settings/organization/integrations). +2. Sous **Enabled Integrations**, cliquez sur l'icône d'engrenage de l'intégration que vous souhaitez gérer. +3. Cliquez sur **Disconnect** dans la boîte de dialogue. + +Une fois la déconnexion effectuée, l'agent cesse d'utiliser le service comme contexte. Pour reconnecter plus tard, installez à nouveau l'intégration depuis la section **Available to your team**. + +
+ ## Connexions expirées ou révoquées +
+ +Mintlify synchronise l'état de vos services connectés avec Composio. Une connexion devient inactive lorsque : + +- Le fournisseur tiers expire ou révoque les identifiants. +- Le fournisseur marque la connexion comme inactive. +- Un administrateur déconnecte l'intégration. + +Les intégrations inactives disparaissent de la section **Enabled Integrations**. Réinstallez l'intégration depuis la section **Available to your team** pour rétablir l'accès. + +
+ ## Étapes suivantes +
+ + + Permettez à vos coéquipiers d'installer leurs propres intégrations personnelles depuis Slack. + + + Utilisez un fichier `AGENTS.md` pour indiquer à l'agent comment exploiter le contexte qu'il recueille depuis vos intégrations. + diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 7119fbbb4..aa7057244 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -55,9 +55,9 @@ Pour ajouter une nouvelle intégration depuis Slack : 3. Cliquez sur le lien, connectez-vous au service tiers et approuvez les autorisations demandées. 4. Retournez dans Slack. L'agent confirme la connexion et peut immédiatement utiliser l'intégration comme contexte pour les futures demandes. -Les intégrations que vous connectez depuis Slack sont définies au niveau de votre utilisateur Slack individuel : chaque coéquipier configure ses propres connexions et l'agent utilise les connexions de la personne qui a envoyé le message. Si un utilisateur Slack n'a pas connecté un service, l'agent se rabat sur les intégrations au niveau de l'organisation installées depuis la page [Agent](https://dashboard.mintlify.com/products/agent) du tableau de bord. +Les intégrations que vous connectez depuis Slack sont définies au niveau de votre utilisateur Slack individuel : chaque coéquipier configure ses propres connexions et l'agent utilise les connexions de la personne qui a envoyé le message. Si un utilisateur Slack n'a pas connecté un service, l'agent se rabat sur les intégrations au niveau de l'organisation installées depuis la page [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations) du tableau de bord. -Pour supprimer ou réautoriser une intégration au niveau de l'organisation, utilisez la section **Agent settings** de la page [Agent](https://dashboard.mintlify.com/products/agent). +Pour installer, supprimer ou réautoriser une intégration au niveau de l'organisation, utilisez la page [Settings → Integrations](https://dashboard.mintlify.com/settings/organization/integrations). Pour en savoir plus, consultez [Connecter des intégrations](/fr/agent/integrations). Pour la liste complète des services pris en charge, consultez le [catalogue des toolkits Composio](https://docs.composio.dev/toolkits).