Utiliser OpenLatch depuis votre agent

Laissez votre agent travailler avec OpenLatch pour vous : lire vos agents et leur graphe d’exécution, vos Autonomy Zones et vos politiques d’intention, vos anomalies et vos Asks, et rédiger une politique avec vous. Votre agent se connecte en votre nom et agit avec votre rôle, et chaque modification qu’il fait est enregistrée dans la piste d’audit à votre nom. Installez le plugin OpenLatch, qui apporte le serveur MCP et les skills OpenLatch, ou connectez le serveur MCP seul.

Ce que la marketplace installe

La marketplace OpenLatch est le dépôt GitHub public OpenLatch/openlatch-plugins. Elle sert un seul plugin à tous les clients, et ce plugin contient tout ce dont votre agent a besoin : la connexion au serveur MCP à https://app.openlatch.ai/mcp, et quatre skills qui apprennent à votre agent les étapes que suit votre équipe avec les outils OpenLatch. Le plugin et ses skills partagent une même version, et votre client récupère chaque nouvelle version depuis la marketplace.

Skill	Ce qu’il enseigne
openlatch	Les concepts de base, quel outil utiliser et quand, et les vérifications de connexion et de version
openlatch-triage	La lecture des anomalies et des Asks, et la réponse à y donner
openlatch-agents	Le travail sur le registre des agents : propriété, sessions, rattachement à une zone et arborescence de l’organisation
openlatch-autonomy-zones	La rédaction, la modification et la restauration d’une politique d’intention avec vous, du brief à la politique ratifiée

Chaque outil que le plugin donne à votre agent, avec ce qu’il peut lire ou modifier et ses paramètres, figure dans la référence des outils MCP.

Plugin ou serveur MCP seul

Choisissez la voie qui convient à votre client et à vos contraintes.

	Plugin	Serveur MCP seul
Apporte	Les outils MCP (référence des outils MCP) et les quatre skills (openlatch, openlatch-triage, openlatch-agents, openlatch-autonomy-zones) qui apprennent à votre agent le vocabulaire d’OpenLatch et les étapes que suit votre équipe, avec une vérification de la connexion et de la version	Les outils MCP, sans package de plugin à mettre à jour : les outils vivent sur le serveur, donc un agent connecté voit la liste d’outils actuelle du serveur. Dans ChatGPT, actualisez le plugin pour récupérer les nouveaux outils
Coûte	Un client qui prend en charge les plugins et une marketplace que vous pouvez ajouter ; de nouvelles versions du plugin à prendre depuis la marketplace	Aucun skill OpenLatch : votre agent travaille à partir des seules descriptions des outils. Les skills, si vous les voulez, s’ajoutent et se mettent à jour à part (Ajouter les skills seuls)
Convient à	La plupart des lecteurs	Un client qui ne prend pas en charge les plugins, un poste où les marketplaces sont bloquées, une équipe qui écrit ses propres skills

Les deux voies connectent votre agent par OAuth en votre nom : il agit avec votre rôle, et chaque modification qu’il fait est enregistrée dans la piste d’audit à votre nom. Le plugin embarque déjà le serveur MCP : connectez une seule voie, pas les deux. Les deux voies n’atteignent que app.openlatch.ai, et ChatGPT et claude.ai l’appellent depuis le cloud de l’éditeur, pas depuis votre poste ; lisez le guide des serveurs MCP personnalisés d’OpenAI et la page des connecteurs personnalisés de Claude.

La page de consentement

Quand votre agent appelle OpenLatch pour la première fois, votre navigateur ouvre la page de consentement sur /oauth/consent. Elle affiche Connect suivi du nom du client, avec un badge dessous : Verified client, ou Unverified client quand le client s’est enregistré lui-même. Choisissez l’organisation, puis lisez la ligne Acts with your role ({role}). Returns to {host}. Choisissez Connect pour laisser l’agent agir, ou Cancel pour refuser.

Installer depuis la marketplace

Choisissez votre client. Chaque onglet suit les mêmes cinq étapes : ajouter la marketplace, installer le plugin, se connecter, vérifier, puis le mettre à jour ou le retirer.

Claude Code

1. Ajoutez la marketplace et installez-en le plugin :

   /plugin marketplace add OpenLatch/openlatch-plugins
   /plugin install openlatch@openlatch

   Claude Code vous demande d’examiner le plugin et de choisir une portée avant l’installation. Lisez Découvrir et installer des plugins.

2. Connectez-vous. La première fois que votre agent appelle OpenLatch, votre navigateur s’ouvre. Connectez-vous, choisissez l’organisation dans laquelle l’agent travaille, puis Connect.

3. Vérifiez. Demandez à votre agent de vérifier sa connexion à OpenLatch. Le skill openlatch appelle whoami et compare sa version à la version publiée.

4. Mettez à jour. Mettez à jour la marketplace pour récupérer une nouvelle version du plugin :

   /plugin marketplace update openlatch

   La mise à jour automatique de la marketplace est désactivée tant que vous ne l’activez pas : exécutez /plugin, ouvrez l’onglet Marketplaces, sélectionnez la marketplace puis Enable auto-update.

5. Retirez. Désinstallez le plugin :

   /plugin uninstall openlatch@openlatch

Codex

1. Ajoutez la marketplace depuis votre terminal :

   codex plugin marketplace add OpenLatch/openlatch-plugins

   Dans l’application Codex, un administrateur de l’espace de travail importe plutôt la marketplace ; lisez Déployer auprès d’une équipe.

2. Installez le plugin. Dans Codex CLI, ouvrez le navigateur de plugins :

   /plugins

   Ouvrez l’onglet OpenLatch, sélectionnez le plugin et installez-le, puis démarrez une nouvelle session. Dans l’application Codex, ouvrez l’onglet Plugins, ouvrez le plugin, sélectionnez le bouton plus, connectez le serveur MCP si on vous le demande, puis démarrez une nouvelle conversation. Lisez Plugins dans ChatGPT et Codex.

3. Connectez-vous. Quand le plugin vous demande de vous connecter, ou la première fois que votre agent appelle OpenLatch, connectez-vous dans votre navigateur puis choisissez Connect.

4. Vérifiez. Demandez à votre agent de vérifier sa connexion à OpenLatch. Le skill openlatch appelle whoami et compare sa version à la version publiée.

5. Mettez à jour ou retirez. Dans Codex CLI, actualisez la marketplace, puis réinstallez le plugin depuis le navigateur de plugins :

   codex plugin marketplace upgrade openlatch

   Pour retirer le plugin, ouvrez-le dans le même navigateur de plugins et désinstallez-le. Retirer le plugin ne déconnecte pas le serveur MCP : déconnectez-le aussi là où vous l’avez connecté. Dans un espace de travail, votre administrateur synchronise la marketplace pour publier une nouvelle version ; lisez Déployer auprès d’une équipe.

ChatGPT

Le plugin OpenLatch déclare un serveur MCP : il est donc marqué Desktop only. Il s’installe et fonctionne dans l’application de bureau ChatGPT, pas sur le web. Lisez Gestion des plugins.

1. Demandez à un administrateur de l’espace de travail d’importer la marketplace. Votre administrateur suit Déployer auprès d’une équipe.

2. Dans l’application de bureau ChatGPT, ouvrez l’onglet Plugins, trouvez le plugin sous l’onglet de votre espace de travail et ouvrez-le. Sélectionnez le bouton plus, connectez le serveur MCP si on vous le demande, puis démarrez une nouvelle conversation. Lisez Plugins dans ChatGPT et Codex.

3. Connectez-vous. Quand ChatGPT vous demande de connecter le serveur MCP, connectez-vous dans votre navigateur puis choisissez Connect.

4. Vérifiez. Demandez à votre agent de vérifier sa connexion à OpenLatch. Le skill openlatch appelle whoami et compare sa version à la version publiée.

5. Mettez à jour ou retirez. Votre administrateur synchronise la marketplace pour publier une nouvelle version. Pour retirer le plugin, ouvrez-le depuis l’onglet Plugins et sélectionnez Uninstall plugin. La connexion MCP reste en place tant que vous ne la déconnectez pas dans ChatGPT, et un plugin installé pour vous par votre espace de travail peut ne pas proposer cette action.

claude.ai

1. Dans claude.ai ou l’application de bureau, ouvrez Customize › Plugins, sélectionnez Add › Add marketplace et saisissez OpenLatch/openlatch-plugins. Lisez Utiliser des plugins dans Claude.

2. Installez le plugin. Dans l’onglet Plugins, ouvrez Discover, sélectionnez le plugin OpenLatch puis Add.

3. Connectez-vous. La première fois que votre agent appelle OpenLatch, connectez-vous dans votre navigateur puis choisissez Connect.

4. Vérifiez. Demandez à votre agent de vérifier sa connexion à OpenLatch. Le skill openlatch appelle whoami et compare sa version à la version publiée.

5. Mettez à jour ou retirez. Sélectionnez Check for updates sur la marketplace pour récupérer une nouvelle version. Pour retirer le plugin, retirez sa marketplace : trouvez-la sur la page Plugins, ouvrez son menu et sélectionnez Remove.

Demandez ensuite à votre agent : « Liste mes agents et dis-moi lesquels n’ont pas de zone. »

Un brouillon n’est pas une politique

Toute politique que votre agent rédige pour vous reste un brouillon tant que vous n’approuvez pas son appel de ratification, qui vous montre les phrases exactes. Rédiger une politique par l’intermédiaire de votre agent détaille la démarche.

Déployer auprès d’une équipe

Dans un espace de travail ChatGPT ou Codex, un administrateur importe la marketplace une fois, puis chaque membre peut installer le plugin. Lisez Gestion des plugins pour toutes les étapes.

1. Ouvrez Admin › Plugins et sélectionnez Add › Import marketplace.
2. Dans Source, saisissez https://github.com/OpenLatch/openlatch-plugins, l’URL du dépôt uniquement. Laissez Path et la branche vides, puis autorisez l’accès à GitHub quand on vous le demande.
3. Ouvrez le plugin et définissez sa politique d’installation pour chaque rôle : Available propose le plugin à l’installation, et Installed le place dans le client des membres.
4. Après une version d’OpenLatch, ouvrez Admin › Plugins › Marketplaces, sélectionnez la marketplace puis Sync now. Sinon, elle se synchronise chaque jour.

Importer la marketplace ne connecte le compte OpenLatch de personne : chaque membre se connecte lui-même.

Dans une organisation Claude Team ou Enterprise, un propriétaire distribue les plugins par des marketplaces de plugins ou la bibliothèque de l’organisation ; lisez Utiliser des plugins dans Claude.

Ajouter le serveur MCP seul

Pour connecter votre agent sans le plugin, ajoutez le serveur MCP à https://app.openlatch.ai/mcp à votre client sous le nom openlatch. Choisissez votre client. Chaque onglet suit les mêmes étapes : ajouter le serveur, se connecter, vérifier, puis le retirer.

Claude Code

1. Ajoutez le serveur pour tous les projets de votre machine :

   claude mcp add --transport http --scope user openlatch https://app.openlatch.ai/mcp

   Sans —scope user, le serveur ne sert que le projet courant. Lisez Connecter Claude Code à des outils par MCP.

2. Connectez-vous. Dans Claude Code, lancez /mcp, choisissez openlatch et suivez les étapes dans votre navigateur : connectez-vous, choisissez l’organisation dans laquelle l’agent travaille, puis choisissez Connect.

3. Vérifiez. Demandez à votre agent d’appeler whoami : il répond avec votre utilisateur et votre organisation.

4. Retirez. Retirez le serveur :

   claude mcp remove openlatch

Codex

1. Ajoutez le serveur :

   codex mcp add openlatch --url https://app.openlatch.ai/mcp

   L’application de bureau ChatGPT, Codex CLI et l’extension IDE partagent cette configuration. Lisez Model Context Protocol.

2. Connectez-vous. Lancez la connexion, puis suivez les étapes dans votre navigateur : connectez-vous, choisissez l’organisation dans laquelle l’agent travaille, puis choisissez Connect.

   codex mcp login openlatch

3. Vérifiez. Listez vos serveurs pour voir le serveur, puis demandez à votre agent d’appeler whoami : il répond avec votre utilisateur et votre organisation.

   codex mcp list

4. Retirez. Supprimez la définition du serveur. Lisez Commandes Codex.

   codex mcp remove openlatch

ChatGPT

Les autorisations et restrictions de sécurité de l’espace de travail s’appliquent à qui peut ajouter un serveur MCP personnalisé : lisez le guide des serveurs MCP personnalisés d’OpenAI. Contrairement au plugin, qui ne s’installe que dans l’application de bureau, un serveur MCP personnalisé s’ajoute sur le web.

1. Ajoutez le serveur. Dans ChatGPT sur le web, allez dans Plugins, sélectionnez le bouton plus, puis Add custom MCP server. Saisissez un nom et l’URL du serveur, https://app.openlatch.ai/mcp, choisissez l’authentification OAuth, acceptez l’avertissement de risque, créez le plugin, puis installez-le. Lisez le guide des serveurs MCP personnalisés d’OpenAI.

2. Connectez-vous. Quand ChatGPT lance la connexion OAuth, connectez-vous dans votre navigateur, choisissez l’organisation dans laquelle l’agent travaille, puis choisissez Connect.

3. Vérifiez. Dans la zone de saisie, tapez @ et sélectionnez le plugin que vous avez installé, puis demandez à votre agent d’appeler whoami : il répond avec votre utilisateur et votre organisation.

claude.ai

Le forfait Free accepte un seul connecteur personnalisé. Lisez Bien démarrer avec les connecteurs personnalisés en MCP distant pour chaque étape ci-dessous.

1. Ajoutez le connecteur. Ouvrez Customize › Connectors, sélectionnez + Add, puis Add custom connector. Saisissez un nom et l’URL du serveur, https://app.openlatch.ai/mcp, puis sélectionnez Continue. Sous OAuth client, choisissez Use Claude’s published identity (Recommended), puis sélectionnez Add.

   Sur les forfaits Team et Enterprise, un Owner l’ajoute sous Organization settings › Connectors, et chaque membre le trouve sous Customize › Connectors et sélectionne Connect. L’ajouter ne donne à personne l’accès à OpenLatch : chaque membre se connecte en son propre nom, avec son propre rôle.

2. Connectez-vous. Sélectionnez Connect, puis connectez-vous dans votre navigateur, choisissez l’organisation dans laquelle l’agent travaille et choisissez Connect.

3. Vérifiez. Dans une conversation, sélectionnez +, puis Connectors, et activez le connecteur. Demandez à votre agent d’appeler whoami : il répond avec votre utilisateur et votre organisation.

4. Retirez. Ouvrez Customize › Connectors et sélectionnez Remove à côté du connecteur. Un Owner retire un connecteur d’organisation sous Organization settings › Connectors.

Un connecteur que vous ajoutez dans claude.ai est aussi disponible dans Claude Code quand vous vous connectez à Claude Code avec votre compte claude.ai. Lisez Utiliser des serveurs MCP depuis claude.ai.

Retirer le serveur d’un client ne révoque pas l’accès d’OpenLatch : révoquez l’agent sous Connected agents dans votre profil OpenLatch.

Ajouter les skills seuls

Si vous avez connecté le serveur MCP seul, vous pouvez ajouter les quatre skills OpenLatch à part, ou travailler sans eux. Installez-les depuis le dépôt :

npx skills@1.7.4 add OpenLatch/openlatch-plugins

Dans claude.ai, importez l’archive de chaque skill, <skill>.zip, depuis la dernière version publiée du dépôt, sous Customize › Skills. N’y importez pas openlatch-plugin.zip : cette archive embarque aussi la connexion MCP. Une installation manuelle ne se met pas à jour seule : le skill openlatch vous signale quand une nouvelle version est publiée.

Dépannage

Vous constatez	Faites ceci
Le plugin est installé mais aucun outil OpenLatch ne répond	Démarrez une nouvelle session ou conversation. Si les outils manquent toujours, le serveur MCP n’est pas connecté : demandez à votre agent de vérifier sa connexion à OpenLatch
Le plugin n’apparaît pas dans ChatGPT sur le web	Il est Desktop only. Ouvrez l’application de bureau ChatGPT
L’agent propose une mise à jour	Mettez à jour avec la voie de votre client, ci-dessus
Vous avez ajouté le serveur mais aucun outil OpenLatch ne répond	Connectez-vous : dans Claude Code lancez /mcp, dans Codex lancez codex mcp login openlatch, dans claude.ai sélectionnez Connect. Puis démarrez une nouvelle session ou conversation. Dans claude.ai, activez le connecteur sous + › Connectors ; dans ChatGPT, tapez @ et sélectionnez le plugin
La page de consentement affiche « Unverified client »	Le client s’est enregistré lui-même plutôt que par une identité publiée : ne vous connectez que si vous avez lancé la connexion depuis un client de confiance. Dans claude.ai, retirez le connecteur et ajoutez-le de nouveau avec Use Claude’s published identity (Recommended)
Les outils OpenLatch apparaissent en double	Deux voies sont connectées. Si vous avez installé le plugin, retirez le serveur ajouté à la main. Dans Claude Code, un connecteur claude.ai peut aussi apparaître : lancez /mcp et désactivez-le pour le projet courant

Travailler avec OpenLatch n’est pas être couvert par OpenLatch

Connecter votre agent lui permet de travailler avec OpenLatch ; cela ne place pas cet agent sous le contrôle d’OpenLatch. La couverture vient du client, et le niveau de contrôle de chaque agent est indiqué plan par plan dans Niveaux de contrôle.

Étapes suivantes

• Exemples propose des questions à poser à votre agent, avec les outils qu’il appelle.
• Rédiger une politique par l’intermédiaire de votre agent mène votre agent du brief à une politique ratifiée.
• La référence des outils MCP liste chaque outil que votre agent peut appeler, regroupé par objet OpenLatch.