Présentation

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


La synchronisation de la place de marché importe le contenu des plugins ; 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 plugin.


Pour une présentation des plugins et des applications qu’ils incluent, consultez : Plugins 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’elle 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 plugins valides sans étape d’approbation distincte pour chacun, et les futures synchronisations peuvent ajouter de nouveaux plugins.

Les nouveaux plugins ont initialement une politique d’installation Disponible et une authentification lors de l’installation. La synchronisation quotidienne automatique est activée pour les nouvelles places de marché. Après l’importation, vérifiez les paramètres d’espace de travail et les applications requises de chaque plugin.

Importer une place de marché

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

2. Dans Source, saisissez 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, saisissez ce répertoire dans Chemin. Par exemple, saisissez team-tools pour team-tools/.agents/plugins/marketplace.json. Laissez Chemin vide pour utiliser la racine du dépôt. Ne saisissez pas le nom du fichier manifeste.

4. Vous pouvez renseigner le champ Branche, tag 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. Consultez les Résultats de l’importation, puis ouvrez chaque plugin importé pour configurer sa politique d’installation et les applications requises.

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

Si un plugin ne peut pas être importé, le rapport explique l’erreur. Les autres plugins valides peuvent tout de 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 plugin Claude autonome en l’absence de manifeste de place de marché.

Les entrées de la place de marché peuvent référencer des dossiers de plugins dans le même dépôt ou des sources de dépôts GitHub prises en charge. Les autres hébergeurs Git et les sources de registres de paquets, telles que 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 plugins.

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

GitHub fournit le contenu des plugins, 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 de politique du dépôt, telles que AVAILABLE ou ON_USE. Configurez ces paramètres pour chaque plugin dans votre espace de travail.


Utilisez Politique d’installation pour choisir Disponible ou Installé pour chaque rôle éligible. Les applications requises doivent également ê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 plugin ou le passage d’un plugin existant à une gestion via GitHub préserve ses politiques d’espace de travail. L’importation d’un plugin 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é des plugins et des applications.

Maintenir les plugins à 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 souhaité et ouvrez Plugins.

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 plugins existants. Examinez les modifications du dépôt avant de les fusionner, car la synchronisation automatique peut importer de nouveaux plugins sans autre étape d’importation.

Consulter les résultats de synchronisation

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


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


Si votre interface d’administration affiche Actualiser pour un plugin importé individuellement, utilisez cette option pour actualiser ce plugin. Actualiser la liste des plugins recharge uniquement la liste affichée ; cette option ne lance pas de synchronisation depuis GitHub.

Comprendre le retrait et la suppression

Retirer une entrée du dépôt ne supprime pas sa copie importée dans l’espace de travail. Le plugin est marqué comme Absent de la source.


Supprimer la place de marché dans ChatGPT supprime tous les plugins qui en ont été importés. Ne supprimez pas une place de marché pour rétablir la connexion à GitHub ou changer de propriétaire.

Rétablir ou modifier l’accès à GitHub

La synchronisation d’une 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. Vérifiez 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 plugin 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 souhaité et ouvrez Plugins. Sélectionnez ensuite Ajouter > Importer une place de marché.

2. Saisissez les mêmes valeurs Source, Chemin et Branche, tag 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 futures synchronisations utiliseront 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’elle référence.

Passer un plugin existant à une gestion via GitHub

Vous pouvez utiliser une place de marché pour gérer un plugin existant de l’espace de travail qui a été importé sous forme d’archive ou qui n’est pas encore géré par une source GitHub. Le plugin existant doit se trouver dans le même espace de travail et porter le même nom de plugin. Un plugin géré par une autre source GitHub ne peut pas être repris de cette manière.


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

1. Accédez à la console d’administration, sélectionnez l’espace de travail ChatGPT souhaité et ouvrez Plugins. Ouvrez le plugin.

2. Copiez l’ID du plugin situé après /admin/plugins/ dans son URL.

3. Ajoutez cet ID en tant que 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 plugin.

Le plugin conserve son ID, ses paramètres de partage et ses politiques d’espace de travail. GitHub devient la source des futures mises à jour ; les importations d’archives ultérieures ne peuvent donc plus le remplacer.


Pour un exemple de migration et les conditions requises, consultez : Gestion des plugins.

Référencer une application existante

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


Cette référence ne crée pas d’application et n’accorde pas d’autorisations supplémentaires. Les règles existantes de l’application concernant l’accès à l’espace de travail, l’authentification, le contrôle des actions et les autorisations du service connecté continuent de s’appliquer.


Pour le format JSON, consultez : Gestion des plugins.

Comprendre le libellé Application de bureau uniquement

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


L’ajout d’une référence .app.json ne supprime pas à lui seul le libellé 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.