Vue d’ensemble

Les administrateurs d’espace de travail peuvent importer une place de marché de plugiciels depuis GitHub dans le répertoire de leur espace de travail. Une place de marché est un catalogue JSON qui répertorie les plugiciels à importer. Après l’importation, la synchronisation quotidienne tient les plugiciels à jour en intégrant les modifications du dépôt.


La synchronisation de la place de marché importe le contenu des plugiciels; elle ne connecte pas les comptes des membres de l’espace de travail et n’accorde pas l’accès aux applications incluses dans un plugiciel.


Pour une introduction aux plugiciels et aux applications qu’ils incluent, consultez : Plugiciels dans ChatGPT et Codex.

Avant de commencer

• Utilisez un compte GitHub disposant d’un accès en lecture au dépôt de la place de marché et à tous les autres dépôts qu’il référence. Les dépôts publics et privés sur github.com sont pris en charge.

• Obtenez toute approbation de l’organisation GitHub requise pour que le compte utilisé pour l’importation puisse accéder à ces dépôts.

• Examinez le contenu du dépôt. L’importation traite tous les plugiciels valides sans étape d’approbation distincte pour chacun, et les synchronisations futures peuvent ajouter de nouveaux plugiciels.

Les nouveaux plugiciels ont initialement la politique d’installation Disponible et nécessitent une authentification à l’installation. La synchronisation quotidienne automatique est activée pour les nouvelles places de marché. Après l’importation, examinez les paramètres d’espace de travail et les applications requises de chaque plugiciel.

Importer une place de marché

1. Accédez à la console d’administration, sélectionnez l’espace de travail ChatGPT visé, puis ouvrez Plugiciels. Sélectionnez ensuite Ajouter, puis choisissez Importer une place de marché.

2. Dans Source, entrez l’URL du dépôt, par exemple https://github.com/example/team-plugins. Utilisez uniquement l’URL du dépôt, sans URL de branche ni de dossier.

3. Si la place de marché se trouve dans un sous-répertoire, entrez ce répertoire dans Chemin. Par exemple, entrez team-tools pour team-tools/.agents/plugins/marketplace.json. Laissez Chemin vide pour utiliser la racine du dépôt. N’entrez pas le nom du fichier manifeste.

4. Vous pouvez aussi remplir le champ Branche, étiquette ou commit. Laissez-le vide pour utiliser la branche par défaut du dépôt. Utilisez une branche pour recevoir les futurs commits. Un commit fixe reste à cette révision.

5. Sélectionnez Importer une place de marché et autorisez l’accès à GitHub lorsque vous y êtes invité.

6. Examinez les Résultats de l’importation, puis ouvrez chaque plugiciel importé pour configurer sa politique d’installation et les applications requises.

L’importation initiale peut prendre jusqu’à 1 heure pour les très grandes places de marché. Les synchronisations quotidiennes suivantes prennent généralement quelques minutes.

Si un plugiciel ne peut pas être importé, le rapport explique l’erreur. Les autres plugiciels valides peuvent quand même être importés.

Formats pris en charge

Le répertoire sélectionné doit contenir un manifeste pris en charge :

• .agents/plugins/marketplace.json pour une place de marché Codex.

• .claude-plugin/marketplace.json pour une place de marché compatible avec Claude.

• .claude-plugin/plugin.json pour un plugiciel Claude autonome lorsqu’aucun manifeste de place de marché n’est présent.

Les entrées de la place de marché peuvent référencer des dossiers de plugiciels dans le même dépôt ou des sources de dépôt GitHub prises en charge. Les autres hébergeurs Git et les sources de registres de paquets, comme npm, ne sont pas pris en charge par l’importation dans l’espace de travail.

Pour les formats pris en charge, les exemples JSON et les champs de source, consultez : Gestion des plugiciels.

Configurer l’accès dans l’espace de travail

GitHub fournit le contenu du plugiciel, tandis que les paramètres de l’espace de travail contrôlent l’installation et l’authentification. L’importation et la synchronisation n’appliquent pas les valeurs des politiques du dépôt, comme AVAILABLE ou ON_USE. Configurez ces paramètres pour chaque plugiciel dans votre espace de travail.


Utilisez Politique d’installation pour choisir Disponible ou Installé pour chaque rôle admissible. Les applications requises doivent aussi être activées, et les membres doivent avoir accès au service connecté et effectuer toute authentification requise.


La synchronisation d’une mise à jour de plugiciel ou le passage d’un plugiciel existant à la gestion par GitHub conserve ses politiques d’espace de travail. L’importation d’un plugiciel n’accorde pas l’accès aux applications et ne connecte pas les comptes des membres.


Pour la navigation dans l’espace de travail, l’accès aux applications et les contrôles de l’espace de travail, consultez : Contrôles d’administration, sécurité et conformité pour les plugiciels et les applications.

Tenir les plugiciels à jour

Les nouvelles places de marché vérifient chaque jour si des mises à jour sont disponibles. Pour demander une mise à jour sans attendre la synchronisation automatique :

1. Accédez à la console d’administration, sélectionnez l’espace de travail ChatGPT visé, puis ouvrez Plugiciels.

2. Ouvrez Places de marché et sélectionnez la place de marché.

3. Sélectionnez Synchroniser maintenant.

La synchronisation peut ajouter de nouvelles entrées de la place de marché et mettre à jour les plugiciels existants. Examinez les modifications du dépôt avant de les fusionner, car la synchronisation automatique peut importer de nouveaux plugiciels sans autre étape d’importation.

Examiner les résultats de la synchronisation

Après une synchronisation, examinez son état et le rapport enregistré. Terminée — N erreurs signifie que la synchronisation est terminée, mais que certains plugiciels n’ont pas pu être traités.


Si une mise à jour d’un plugiciel existant est invalide, sa dernière version fonctionnelle est conservée. Les autres mises à jour valides peuvent quand même se terminer. Corrigez le problème signalé dans GitHub, puis sélectionnez Synchroniser maintenant pour réessayer.


Si votre interface d’administration affiche Actualiser pour un plugiciel importé individuellement, utilisez cette option pour actualiser ce plugiciel. Actualiser la liste des plugiciels recharge uniquement la liste affichée; cette option ne synchronise pas les données depuis GitHub.

Comprendre le retrait et la suppression

Le retrait d’une entrée du dépôt ne supprime pas sa copie importée dans l’espace de travail. Le plugiciel porte la mention N’est plus dans la source.


La suppression de la place de marché dans ChatGPT supprime tous les plugiciels importés depuis celle-ci. Ne supprimez pas une place de marché pour reconnecter GitHub ou changer de propriétaire.

Reconnecter ou modifier l’accès à GitHub

La synchronisation de la place de marché utilise la connexion GitHub de l’administrateur qui l’a importée. Ce compte doit conserver l’accès au dépôt de la place de marché et à tous les dépôts référencés.

Reconnecter le compte d’origine

1. Confirmez que le compte GitHub utilisé pour l’importation a toujours accès à tous les dépôts requis.

2. Demandez à l’administrateur qui a initialement importé la place de marché d’ouvrir le plugiciel GitHub dans ChatGPT et de reconnecter son compte.

Transférer à un nouvel administrateur

Le nouvel administrateur de l’espace de travail peut importer la même place de marché en utilisant sa propre connexion GitHub :

1. Accédez à la console d’administration, sélectionnez l’espace de travail ChatGPT visé, puis ouvrez Plugiciels. Sélectionnez ensuite Ajouter > Importer une place de marché.

2. Entrez les mêmes valeurs de Source, de Chemin et de Branche, étiquette ou commit que celles utilisées pour la place de marché existante.

3. Sélectionnez Importer une place de marché et autorisez l’accès à GitHub lorsque vous y êtes invité.

Les synchronisations futures utilisent la connexion GitHub du nouvel administrateur. Le compte du nouvel administrateur doit disposer d’un accès en lecture au dépôt de la place de marché et à tous les dépôts qu’il référence.

Passer un plugiciel existant à la gestion par GitHub

Vous pouvez utiliser une place de marché pour gérer un plugiciel existant de l’espace de travail qui a été téléversé sous forme d’archive ou qui n’est pas encore géré par une source GitHub. Le plugiciel existant doit se trouver dans le même espace de travail et porter le même nom de plugiciel. Un plugiciel géré par une autre source GitHub ne peut pas être pris en charge de cette façon.


Pour identifier le plugiciel existant dans votre place de marché :

1. Accédez à la console d’administration, sélectionnez l’espace de travail ChatGPT visé, puis ouvrez Plugiciels. Ouvrez le plugiciel.

2. Copiez l’identifiant du plugiciel qui suit /admin/plugins/ dans son URL.

3. Ajoutez cet identifiant comme valeur de pluginId à côté de name et de source dans l’entrée correspondante du tableau plugins de la place de marché. Ne l’ajoutez pas au fichier plugin.json du plugiciel.

Le plugiciel conserve son identifiant, ses paramètres de partage et ses politiques d’espace de travail. GitHub devient la source des futures mises à jour; les téléversements d’archives ultérieurs ne peuvent donc pas le remplacer.


Pour un exemple de migration et les exigences, consultez : Gestion des plugiciels.

Référencer une application existante

Un plugiciel peut référencer une application existante dans .app.json à la racine du plugiciel. Incluez le point initial dans le nom du fichier et utilisez l’identifiant de l’application plutôt que celui d’un plugiciel. Pour un plugiciel natif, définissez le champ apps de .codex-plugin/plugin.json sur ./.app.json.


La référence ne crée pas d’application et n’accorde pas d’autorisations supplémentaires. Les paramètres existants d’accès à l’espace de travail, d’authentification, de contrôle des actions et d’autorisations des services connectés de l’application continuent de s’appliquer.


Pour le format JSON, consultez : Gestion des plugiciels.

Comprendre la mention Application de bureau uniquement

Un plugiciel portant la mention Application de bureau uniquement ne peut pas s’exécuter dans ChatGPT sur le Web. Les plugiciels importés peuvent recevoir cette mention lorsqu’ils déclarent des serveurs MCP, par exemple dans mcp.json ou .mcp.json, même si un serveur utilise une URL HTTPS distante.


L’ajout d’une référence .app.json ne suffit pas à supprimer la mention Application de bureau uniquement. Toute application référencée doit toujours être disponible pour le rôle du membre, et ses exigences habituelles d’accès et d’authentification s’appliquent.