mintlify · mintlify · May 15, 2026 · May 15, 2026
diff --git a/agent/integrations.mdx 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.
+
+<Note>
+  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.
+</Note>
+
+<Note>
+  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.
+</Note>
+
+## 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
+
+<Card title="Add the agent to Slack" horizontal icon="slack" href="/agent/slack">
+  Let teammates install their own personal integrations from Slack.
+</Card>
+<Card title="Customize agent behavior" horizontal icon="wrench" href="/agent/customize">
+  Use an `AGENTS.md` file to tell the agent how to use the context that it gathers from your integrations.
+</Card>
diff --git a/agent/slack.mdx b/agent/slack.mdx
@@ -44,7 +44,7 @@

 ## Connect additional integrations from Slack

 After you connect your Slack workspace, you can ask the agent in Slack to set up any third-party integration that it should use as context. The agent uses [Composio](https://docs.composio.dev/toolkits) to support a broad catalog of third-party services, including issue trackers, knowledge bases, CRMs, and developer tools.

 <Note>
  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.
@@ -60,15 +60,15 @@
 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).
 
 ### Expired or revoked connections

 Mintlify keeps the status of your connected services in sync with Composio. A connection is disconnected when:

 - The third-party provider expires or revokes the credentials.
 - The provider marks the connection as inactive.
@@ -83,7 +83,7 @@
 - Send direct messages to the agent to use it privately.
 - Mention `@mintlify` in a channel to use it publicly and collaboratively.
 - Attach files and images directly to your messages for the agent to process and include in your docs.
 - Continue conversations in threads to iterate on changes or ask follow-up questions. The agent reuses files and images shared earlier in the thread as context for follow-up requests, so you don't have to reupload them.
 - Share pull request links with the agent to update related documentation.

 ## Ask questions about your docs
@@ -95,7 +95,7 @@

 Example questions:
 - "Which pages mention the API rate limit?"
 - "How do I set up authentication?"
 - "How is our navigation structured?"

 ## Update documentation
@@ -104,7 +104,7 @@

 - **New request**: Send a direct message to the agent or mention `@mintlify` in a channel with instructions on what to update.
 - **Existing thread**: Reply in the thread and mention `@mintlify` with instructions on what to update.
 - **With attachments**: Upload images, diagrams, code files, or other documents with your message. The agent automatically processes and includes them in your documentation. In a thread, the agent has access to images and files shared in earlier messages, so you can reference them in follow-up requests without reuploading.

 The agent reads the context of the request or thread and creates a pull request in your connected repository with the updates.


diff --git 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"

diff --git 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
@@ -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.
+
+<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>
diff --git 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
@@ -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
@@ -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.
+
+<Note>
+  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.
+</Note>
+
+<Note>
+  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.
+</Note>
+
+<div id="organization-level-vs-personal-integrations">
+  ## Intégrations au niveau de l'organisation et intégrations personnelles
+</div>
+
+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).
+
+<div id="install-an-integration">
+  ## Installer une intégration
+</div>
+
+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.
+
+<div id="configure-or-disconnect-an-integration">
+  ## Configurer ou déconnecter une intégration
+</div>
+
+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**.
+
+<div id="expired-or-revoked-connections">
+  ## Connexions expirées ou révoquées
+</div>
+
+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.
+
+<div id="next-steps">
+  ## Étapes suivantes
+</div>
+
+<Card title="Ajouter l'agent à Slack" horizontal icon="slack" href="/fr/agent/slack">
+  Permettez à vos coéquipiers d'installer leurs propres intégrations personnelles depuis Slack.
+</Card>
+<Card title="Personnaliser le comportement de l'agent" horizontal icon="wrench" href="/fr/agent/customize">
+  Utilisez un fichier `AGENTS.md` pour indiquer à l'agent comment exploiter le contexte qu'il recueille depuis vos intégrations.
+</Card>
diff --git 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).