Gérer votre équipe depuis votre agent

Team permet à un propriétaire ou à un administrateur de consulter l'organisation et de proposer des modifications depuis un agent de programmation tel que Claude Code ou Codex : lister les membres, consulter le journal d'audit, révoquer un ordinateur portable perdu ou renforcer la politique. L'agent n'applique jamais une modification de sa propre initiative. Chaque écriture devient une modification en attente que une personne approuve en dehors de la conversation.

zn-gate est un garde-fou local, et non un MDM. Les jetons d'administration d'organisation donnent à un agent un moyen restreint et révocable de vous aider à administrer l'organisation ; ils ne donnent pas à l'organisation le contrôle de la machine de quiconque.

Créer un jeton d'administration d'organisation

1. Dans le tableau de bord, ouvrez Équipe → Jetons.
2. Donnez un nom au jeton (par exemple laptop-claude), choisissez ses portées et une expiration de 7, 30 ou 90 jours.
3. Copiez le jeton. Il n'est affiché qu'une seule fois. zn ne stocke qu'un hachage de celui-ci, il ne peut donc pas être réaffiché ; si vous le perdez, révoquez-le et créez-en un nouveau.

Les jetons commencent par znorg_, afin que les analyseurs de secrets et le Scrubber de zn-gate puissent les reconnaître. La partie située après znorg_ jusqu'au prochain _ est le préfixe public affiché dans le tableau de bord et dans le journal d'activité.

Limites :

• Jusqu'à 10 jetons actifs par organisation et 5 par personne.
• Un jeton ne fonctionne que tant que son créateur est toujours propriétaire ou administrateur. S'il quitte l'organisation ou devient simple membre, le jeton cesse immédiatement de fonctionner et apparaît comme Inactif.
• La révocation d'un jeton prend effet à la requête suivante et annule ses modifications en attente. Les propriétaires et administrateurs peuvent révoquer n'importe quel jeton de l'organisation.

Portées

Les nouveaux jetons démarrent avec les portées de lecture cochées. Ajoutez des portées d'écriture uniquement si vous voulez que l'agent propose des modifications.

Un jeton hérite des limites de son créateur : le jeton d'un administrateur ne peut pas retirer un autre administrateur ni modifier des rôles, car les administrateurs ne le peuvent pas non plus. Les auditeurs peuvent créer des jetons limités à audit:read et audit:export.

Aucun jeton, quelles que soient ses portées, ne peut :

• toucher à la facturation, aux sièges ou à l'abonnement ;
• créer, lister ou révoquer des jetons, ni modifier les paramètres de l'organisation ;
• créer des jetons de connexion ou accepter des invitations ;
• approuver ou rejeter une modification en attente, y compris la sienne.

Connecter votre agent

Exécutez ces commandes dans votre propre terminal, et non via l'agent.

# 1. Copy the token, then store it in the system keychain (read from the clipboard)
npx -y zn-gate team admin login --from-clipboard

# 2a. Claude Code
claude mcp add zn-gate -- npx -y zn-gate mcp

Pour Codex, ajoutez le serveur dans ~/.codex/config.toml :

[mcp_servers.zn-gate]
command = "npx"
args = ["-y", "zn-gate", "mcp"]

zn-gate team admin login vérifie le jeton auprès de l'API et le conserve dans le Trousseau macOS, le Gestionnaire d'identifiants Windows ou libsecret, hors de la configuration de l'agent. zn-gate team admin status indique quelle organisation et quel jeton sont configurés (jamais le secret), et zn-gate team admin logout le supprime de la machine. Révoquez aussi le jeton dans le tableau de bord si la machine est perdue.

Les outils team_* n'apparaissent dans l'agent que lorsqu'un jeton est configuré, et uniquement ceux autorisés par ses portées. ZN_LOCAL_ONLY=true les désactive.

CI et machines sans trousseau

Définissez ZN_ORG_TOKEN comme secret de CI ou dans votre shell. Ne le placez pas dans la configuration MCP de l'agent (.mcp.json, ~/.codex/config.toml) : l'agent peut lire ces fichiers.

export ZN_ORG_TOKEN=<paste the token here>

Ce que l'agent peut faire

Outils de lecture : team_whoami, team_org_get, team_members_list, team_installs_list, team_policy_get, team_audit_query, team_audit_summary, team_activity_list, team_changes_list et team_change_status. team_audit_export écrit l'export dans ~/zn-exports/ et ne renvoie que son chemin, le nombre de lignes et le SHA-256, jamais le contenu.

Les outils d'écriture proposent une modification et renvoient son statut : team_member_invite, team_invitation_revoke, team_member_remove, team_member_set_role, team_install_revoke, team_policy_propose et team_change_cancel. Le jeton n'apparaît jamais dans les résultats d'outils, les erreurs ou les journaux ; seul son préfixe y figure.

Fonctionnement des approbations

Chaque écriture est stockée sur le serveur comme une modification en attente, avec un résumé et un condensé de 8 caractères, tous deux calculés par le serveur à partir des paramètres. Le serveur détermine aussi la classe de la modification ; ce que l'agent envoie est ignoré.

Les modifications qui durcissent l'accès ou qui peuvent être annulées (retirer un membre, révoquer une invitation ou une installation, rétrograder un administrateur, inviter un membre, ajouter une règle de refus, retirer des hôtes autorisés) sont confirmées par une personne, dans cet ordre :

1. un formulaire de confirmation affiché par l'agent, si le client prend en charge les formulaires d'élicitation MCP ;
2. sinon, une boîte de dialogue native du système, où Non est la valeur par défaut et où l'absence de réponse pendant 2 minutes compte comme un non ;
3. sinon, un lien vers Équipe → Approbations dans le tableau de bord.

La confirmation dans l'agent doit intervenir dans les 10 minutes. Le lien du tableau de bord reste valide 72 heures.

Les modifications qui ouvrent l'accès ou accordent des privilèges (ajouter des hôtes ou commandes autorisés, retirer ou réordonner des règles, inviter un administrateur ou promouvoir quelqu'un au rang d'administrateur) ne sont approuvées que dans le tableau de bord, dans les 72 heures. L'approbation exige une connexion datant des 10 dernières minutes ; si votre session est plus ancienne, le tableau de bord vous demande de vous reconnecter. L'attribution du rôle d'administrateur ne peut être approuvée que par le propriétaire. Lorsque l'organisation utilise Toujours approuver dans le tableau de bord, la même connexion récente est requise pour chaque modification proposée par un agent.

La page d'approbation affiche le résumé du serveur, le condensé, le jeton et le client qui l'ont demandée, et, pour les modifications de politique, les règles avant et après. Une note rédigée par l'agent est affichée en dernier et marquée comme non vérifiée. N'approuvez que les modifications que vous avez demandées, et vérifiez que le condensé correspond à celui affiché par votre agent.

Le serveur vérifie à nouveau tout lors de l'application de la modification : le rôle du créateur, les portées, le paramètre de l'organisation et la version de la politique. Si la politique a changé entre-temps, la modification échoue et l'agent doit la proposer à nouveau.

Paramètre de l'organisation : modifications par les agents

Dans Équipe → Paramètres, le propriétaire choisit comment les modifications des agents sont approuvées :

Journal d'activité

Équipe → Activité liste chaque requête effectuée avec un jeton d'organisation, lectures incluses, ainsi que chaque modification faite dans le tableau de bord. Chaque entrée indique qui a agi, si l'action vient du tableau de bord ou via agent, le préfixe et l'identifiant du jeton, le client (par exemple claude-code 2.1.240), l'action et son résultat, y compris les requêtes refusées. Les adresses IP ne sont pas stockées. Ouvrez-le depuis la ligne d'un jeton pour ne voir que celui-ci.

Serveur MCP distant (bientôt disponible)

Un serveur MCP hébergé à l'adresse https://mcp.usezn.com/mcp, avec une connexion via votre compte zn, est prévu pour une version ultérieure. Il proposera les mêmes outils, et chaque écriture sera approuvée dans le tableau de bord.

Limites

• Une personne qui vole un jeton peut, jusqu'à son expiration ou sa révocation, au plus effectuer des modifications de la première catégorie : elles renforcent l'accès ou peuvent être annulées depuis le tableau de bord, et apparaissent dans le journal d'activité. Elle ne peut pas ouvrir la politique, attribuer le rôle d'administrateur, toucher à la facturation ni créer des jetons. Choisissez Toujours approuver dans le tableau de bord si vous voulez que chaque modification passe par une session connectée.
• Une confirmation dans l'agent ou dans une boîte de dialogue système protège contre une injection de prompt qui tenterait d'approuver seule. Elle ne protège pas contre un logiciel présent sur la machine capable de contrôler l'interface utilisateur.
• L'approbation n'est utile que si la personne lit ce qu'elle approuve. Le résumé et le condensé proviennent du serveur, jamais de l'agent.