docs: document agent integration visibility and access levels

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.
@@ -66,9 +66,30 @@
 
 For the full list of supported services, see the [Composio toolkits catalog](https://docs.composio.dev/toolkits).
 
+### Control who can use an organization-level integration
+
+Each organization-level integration has a **visibility** setting that controls which teammates the agent can use it on behalf of, and an **access level** setting that controls what the agent can do with it. Configure both on the [Agent](https://dashboard.mintlify.com/products/agent) page in the dashboard.
+
+New organization-level integrations default to **hidden** visibility and **read** access. The agent does not use a new integration until you make it available.
+
+**Visibility levels**
+
+- **Public**: Any teammate in your organization can have the agent use this integration. Use public for read-only utilities that are safe for the whole team, such as a shared knowledge base or status page.
+- **Private**: Only teammates on the allowlist can have the agent use this integration. Use private when the integration is tied to a specific account or contains restricted data. You must add at least one user to the allowlist when you select private.
+- **Hidden**: The agent never uses this integration, regardless of who sends the request. Use hidden to pause an integration without disconnecting it, or while you finish configuring it.
+
+**Access levels**
+
+- **Read**: The agent can call read-only actions, such as fetching tickets, listing messages, or searching records. The agent cannot create, update, or delete data through the integration.
+- **Write**: The agent can call any action exposed by the integration, including actions that create, update, or send data. When you choose write, the agent still asks you to approve each write action in Slack before it runs.
+
+For example, set Linear to **read** if you want the agent to reference ticket context in documentation but never file new issues, and set Gmail to **public** + **write** so any teammate can ask the agent to draft and send email from a shared inbox.
+
+Personal integrations that teammates connect from Slack are always private to the user who created them and are not affected by these settings.
+
 ### 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 +104,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 +116,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 +125,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.
 

es/agent/slack.mdx

@@ -60,6 +60,29 @@ Para eliminar o volver a autorizar una integración a nivel de organización, us
 
 Para ver la lista completa de servicios admitidos, consulta el [catálogo de toolkits de Composio](https://docs.composio.dev/toolkits).
 
+<div id="control-who-can-use-an-organization-level-integration">
+  ### Controla quién puede usar una integración a nivel de organización
+</div>
+
+Cada integración a nivel de organización tiene un ajuste de **visibilidad** que controla en nombre de qué compañeros de equipo puede usarla el agente, y un ajuste de **nivel de acceso** que controla qué puede hacer el agente con ella. Configura ambos en la página [Agent](https://dashboard.mintlify.com/products/agent) del panel.
+
+Las nuevas integraciones a nivel de organización se establecen por defecto en visibilidad **hidden** y acceso **read**. El agente no usa una integración nueva hasta que la habilites.
+
+**Niveles de visibilidad**
+
+- **Public**: cualquier compañero de tu organización puede pedir al agente que use esta integración. Usa public para utilidades de solo lectura seguras para todo el equipo, como una base de conocimiento compartida o una página de estado.
+- **Private**: solo los compañeros de la lista de permitidos pueden pedir al agente que use esta integración. Usa private cuando la integración esté ligada a una cuenta específica o contenga datos restringidos. Debes añadir al menos un usuario a la lista de permitidos cuando selecciones private.
+- **Hidden**: el agente nunca usa esta integración, independientemente de quién envíe la solicitud. Usa hidden para pausar una integración sin desconectarla, o mientras terminas de configurarla.
+
+**Niveles de acceso**
+
+- **Read**: el agente puede invocar acciones de solo lectura, como obtener tickets, listar mensajes o buscar registros. El agente no puede crear, actualizar ni eliminar datos a través de la integración.
+- **Write**: el agente puede invocar cualquier acción expuesta por la integración, incluidas las que crean, actualizan o envían datos. Cuando elijas write, el agente seguirá pidiéndote que apruebes cada acción de escritura en Slack antes de ejecutarla.
+
+Por ejemplo, configura Linear en **read** si quieres que el agente consulte el contexto de los tickets en la documentación pero nunca cree incidencias nuevas, y configura Gmail en **public** + **write** para que cualquier compañero pueda pedirle al agente que redacte y envíe correos desde un buzón compartido.
+
+Las integraciones personales que los compañeros conectan desde Slack son siempre privadas para el usuario que las creó y no se ven afectadas por estos ajustes.
+
 <div id="use-the-agent-in-slack">
   ## Usar el agente en Slack
 </div>

fr/agent/slack.mdx

@@ -61,6 +61,29 @@ Pour supprimer ou réautoriser une intégration au niveau de l'organisation, uti
 
 Pour la liste complète des services pris en charge, consultez le [catalogue des toolkits Composio](https://docs.composio.dev/toolkits).
 
+<div id="control-who-can-use-an-organization-level-integration">
+  ### Contrôlez qui peut utiliser une intégration au niveau de l'organisation
+</div>
+
+Chaque intégration au niveau de l'organisation dispose d'un paramètre de **visibilité** qui contrôle pour le compte de quels coéquipiers l'agent peut l'utiliser, et d'un paramètre de **niveau d'accès** qui contrôle ce que l'agent peut en faire. Configurez les deux sur la page [Agent](https://dashboard.mintlify.com/products/agent) du tableau de bord.
+
+Les nouvelles intégrations au niveau de l'organisation sont définies par défaut sur la visibilité **hidden** et l'accès **read**. L'agent n'utilise pas une nouvelle intégration tant que vous ne l'avez pas rendue disponible.
+
+**Niveaux de visibilité**
+
+- **Public** : n'importe quel coéquipier de votre organisation peut demander à l'agent d'utiliser cette intégration. Utilisez public pour les utilitaires en lecture seule qui sont sûrs pour toute l'équipe, comme une base de connaissances partagée ou une page de statut.
+- **Private** : seuls les coéquipiers figurant sur la liste d'autorisation peuvent demander à l'agent d'utiliser cette intégration. Utilisez private lorsque l'intégration est liée à un compte spécifique ou contient des données restreintes. Vous devez ajouter au moins un utilisateur à la liste d'autorisation lorsque vous sélectionnez private.
+- **Hidden** : l'agent n'utilise jamais cette intégration, quelle que soit la personne qui envoie la requête. Utilisez hidden pour mettre en pause une intégration sans la déconnecter, ou pendant que vous terminez sa configuration.
+
+**Niveaux d'accès**
+
+- **Read** : l'agent peut appeler des actions en lecture seule, comme récupérer des tickets, lister des messages ou rechercher des enregistrements. L'agent ne peut pas créer, mettre à jour ni supprimer de données via l'intégration.
+- **Write** : l'agent peut appeler toute action exposée par l'intégration, y compris celles qui créent, mettent à jour ou envoient des données. Lorsque vous choisissez write, l'agent vous demande quand même d'approuver chaque action d'écriture dans Slack avant de l'exécuter.
+
+Par exemple, réglez Linear sur **read** si vous voulez que l'agent référence le contexte des tickets dans la documentation mais ne crée jamais de nouveaux tickets, et réglez Gmail sur **public** + **write** pour que n'importe quel coéquipier puisse demander à l'agent de rédiger et d'envoyer des e-mails depuis une boîte de réception partagée.
+
+Les intégrations personnelles que les coéquipiers connectent depuis Slack sont toujours privées pour l'utilisateur qui les a créées et ne sont pas affectées par ces paramètres.
+
 <div id="use-the-agent-in-slack">
   ## Utiliser l'agent dans Slack
 </div>