Overzicht

Werkruimtebeheerders kunnen een marktplaats voor plug-ins vanuit GitHub importeren in de catalogus van hun werkruimte. Een marktplaats is een JSON-catalogus met de plug-ins die moeten worden geïmporteerd. Na het importeren worden de plug-ins dagelijks gesynchroniseerd met wijzigingen in de repository.


Bij het synchroniseren van een marktplaats wordt de inhoud van plug-ins geïmporteerd. Er worden geen accounts van werkruimteleden gekoppeld en er wordt geen toegang verleend tot de apps in een plug-in.


Zie voor een inleiding tot plug-ins en de bijbehorende apps: Plug-ins in ChatGPT en Codex.

Voordat je begint

• Gebruik een GitHub-account met leestoegang tot de repository van de marktplaats en alle andere repositories waarnaar deze verwijst. Openbare en privérepositories op github.com worden ondersteund.

• Zorg voor alle goedkeuringen van de GitHub-organisatie die nodig zijn om het account waarmee je importeert toegang te geven tot die repositories.

• Controleer de inhoud van de repository. Bij het importeren worden alle geldige plug-ins verwerkt zonder afzonderlijke goedkeuring per plug-in. Bij latere synchronisaties kunnen nieuwe plug-ins worden toegevoegd.

Nieuwe plug-ins krijgen standaard het installatiebeleid Beschikbaar, met authenticatie bij installatie. Voor nieuwe marktplaatsen is automatische dagelijkse synchronisatie ingeschakeld. Controleer na het importeren de werkruimte-instellingen en vereiste apps van elke plug-in.

Een marktplaats importeren

1. Ga naar de beheerconsole, selecteer de gewenste ChatGPT-werkruimte en open Plug-ins. Selecteer vervolgens Toevoegen en kies Marktplaats importeren.

2. Voer bij Bron de URL van de repository in, zoals https://github.com/example/team-plugins. Gebruik alleen de URL van de repository, niet de URL van een branch of map.

3. Als de marktplaats in een submap staat, voer je die map in bij Pad. Voer bijvoorbeeld team-tools in voor team-tools/.agents/plugins/marketplace.json. Laat Pad leeg om de hoofdmap van de repository te gebruiken. Voer de bestandsnaam van het manifest niet in.

4. Voer desgewenst een waarde in bij Branch, tag of commit. Laat dit veld leeg om de standaardbranch van de repository te gebruiken. Gebruik een branch om toekomstige commits te ontvangen. Als je een specifieke commit kiest, blijft die revisie in gebruik.

5. Selecteer Marktplaats importeren en verleen toegang tot GitHub wanneer daarom wordt gevraagd.

6. Bekijk de Importresultaten en open vervolgens elke geïmporteerde plug-in om het installatiebeleid en eventuele vereiste apps te configureren.

Bij zeer grote marktplaatsen kan de eerste import tot 1 uur duren. De daaropvolgende dagelijkse synchronisaties duren meestal een paar minuten.

Als een plug-in niet kan worden geïmporteerd, wordt de fout in het rapport toegelicht. Andere geldige plug-ins kunnen wel worden geïmporteerd.

Ondersteunde indelingen

De geselecteerde map moet een ondersteund manifest bevatten:

• .agents/plugins/marketplace.json voor een Codex-marktplaats.

• .claude-plugin/marketplace.json voor een marktplaats die compatibel is met Claude.

• .claude-plugin/plugin.json voor een zelfstandige Claude-plug-in als er geen marktplaatsmanifest aanwezig is.

Marktplaatsitems kunnen verwijzen naar plug-inmappen in dezelfde repository of naar ondersteunde GitHub-repositories als bron. Andere Git-hosts en pakketregisters zoals npm worden niet ondersteund als bron bij het importeren in een werkruimte.

Zie voor ondersteunde indelingen, JSON-voorbeelden en bronvelden: Plug-ins beheren.

Werkruimtetoegang configureren

GitHub levert de inhoud van de plug-ins; de werkruimte-instellingen bepalen de installatie en authenticatie. Bij het importeren en synchroniseren worden beleidswaarden uit de repository, zoals AVAILABLE of ON_USE, niet toegepast. Configureer deze instellingen voor elke plug-in in je werkruimte.


Kies onder Installatiebeleid voor elke rol die hiervoor in aanmerking komt de optie Beschikbaar of Geïnstalleerd. Vereiste apps moeten ook zijn ingeschakeld. Leden moeten toegang hebben tot de gekoppelde dienst en eventuele vereiste authenticatie voltooien.


Het werkruimtebeleid van een plug-in blijft behouden wanneer je een update synchroniseert of het beheer van een bestaande plug-in naar GitHub verplaatst. Bij het importeren van een plug-in wordt geen toegang tot apps verleend en worden geen accounts van leden gekoppeld.


Zie voor navigatie in de werkruimte, toegang tot apps en beheeropties voor de werkruimte: Beheeropties, beveiliging en compliance voor plug-ins en apps.

Plug-ins up-to-date houden

Nieuwe marktplaatsen controleren dagelijks op updates. Zo vraag je een update aan zonder te wachten op automatische synchronisatie:

1. Ga naar de beheerconsole, selecteer de gewenste ChatGPT-werkruimte en open Plug-ins.

2. Open Marktplaatsen en selecteer de marktplaats.

3. Selecteer Nu synchroniseren.

Bij het synchroniseren kunnen nieuwe marktplaatsitems worden toegevoegd en bestaande plug-ins worden bijgewerkt. Controleer wijzigingen in de repository voordat je ze samenvoegt, want automatische synchronisatie kan nieuwe plug-ins importeren zonder een extra importstap.

Synchronisatieresultaten bekijken

Bekijk na een synchronisatie de status en het opgeslagen rapport. Voltooid — N fouten betekent dat de synchronisatie is afgerond, maar dat sommige plug-ins niet konden worden verwerkt.


Als een update voor een bestaande plug-in ongeldig is, blijft de laatste werkende versie behouden. Andere geldige updates kunnen wel worden voltooid. Los het gemelde probleem op in GitHub en selecteer vervolgens Nu synchroniseren om het opnieuw te proberen.


Als je in de beheerweergave de optie Vernieuwen ziet bij een afzonderlijk geïmporteerde plug-in, gebruik die dan om de plug-in te vernieuwen. Plug-inlijst vernieuwen laadt alleen de weergegeven lijst opnieuw; er wordt niet gesynchroniseerd met GitHub.

Wat gebeurt er bij verwijderen?

Als je een item uit de repository verwijdert, blijft de geïmporteerde kopie in de werkruimte behouden. De plug-in krijgt het label Niet meer in bron.


Als je de marktplaats in ChatGPT verwijdert, worden alle daaruit geïmporteerde plug-ins verwijderd. Verwijder een marktplaats niet om GitHub opnieuw te koppelen of het eigenaarschap te wijzigen.

GitHub opnieuw koppelen of de toegang wijzigen

Voor de synchronisatie van de marktplaats wordt de GitHub-koppeling gebruikt van de beheerder die de marktplaats heeft geïmporteerd. Dat account moet toegang blijven houden tot de repository van de marktplaats en alle repositories waarnaar deze verwijst.

Het oorspronkelijke account opnieuw koppelen

1. Controleer of het GitHub-account dat voor de import is gebruikt nog steeds toegang heeft tot alle vereiste repositories.

2. Vraag de beheerder die de marktplaats oorspronkelijk heeft geïmporteerd om de GitHub-plug-in in ChatGPT te openen en het eigen account opnieuw te koppelen.

Overdragen aan een nieuwe beheerder

De nieuwe werkruimtebeheerder kan dezelfde marktplaats importeren met een eigen GitHub-koppeling:

1. Ga naar de beheerconsole, selecteer de gewenste ChatGPT-werkruimte en open Plug-ins. Selecteer vervolgens Toevoegen > Marktplaats importeren.

2. Voer bij Bron, Pad en Branch, tag of commit dezelfde waarden in als voor de bestaande marktplaats.

3. Selecteer Marktplaats importeren en verleen toegang tot GitHub wanneer daarom wordt gevraagd.

Bij toekomstige synchronisaties wordt de GitHub-koppeling van de nieuwe beheerder gebruikt. Het account van de nieuwe beheerder moet leestoegang hebben tot de repository van de marktplaats en alle repositories waarnaar deze verwijst.

Een bestaande plug-in voortaan via GitHub beheren

Je kunt een marktplaats gebruiken om een bestaande werkruimteplug-in te beheren die als archiefbestand is geüpload of nog niet via een GitHub-bron wordt beheerd. De bestaande plug-in moet zich in dezelfde werkruimte bevinden en dezelfde plug-innaam hebben. Een plug-in die via een andere GitHub-bron wordt beheerd, kan niet op deze manier worden overgenomen.


Zo geef je aan welke bestaande plug-in je in je marktplaats wilt opnemen:

1. Ga naar de beheerconsole, selecteer de gewenste ChatGPT-werkruimte en open Plug-ins. Open de plug-in.

2. Kopieer de plug-in-ID die na /admin/plugins/ in de URL staat.

3. Voeg die ID als pluginId toe naast name en source in het bijbehorende item van de plugins-array van de marktplaats. Voeg de ID niet toe aan het bestand plugin.json van de plug-in.

De plug-in behoudt zijn ID, deelinstellingen en werkruimtebeleid. GitHub wordt de bron voor toekomstige updates. Je kunt de plug-in daarna dus niet meer vervangen door een archiefbestand te uploaden.


Zie voor een migratievoorbeeld en de vereisten: Plug-ins beheren.

Verwijzen naar een bestaande app

Een plug-in kan naar een bestaande app verwijzen in .app.json in de hoofdmap van de plug-in. Neem de punt aan het begin van de bestandsnaam op en gebruik de app-ID in plaats van een plug-in-ID. Stel voor een native plug-in het veld apps in .codex-plugin/plugin.json in op ./.app.json.


De verwijzing maakt geen app aan en verleent geen extra machtigingen. De bestaande instellingen van de app voor werkruimtetoegang, authenticatie en acties, en de machtigingen voor de gekoppelde dienst blijven van toepassing.


Zie voor de JSON-indeling: Plug-ins beheren.

Wat betekent het label Alleen desktop?

Een plug-in met het label Alleen desktop kan niet worden uitgevoerd in ChatGPT op het web. Geïmporteerde plug-ins kunnen dit label krijgen als ze MCP-servers declareren, bijvoorbeeld in mcp.json of .mcp.json, ook als een server een externe HTTPS-URL gebruikt.


Alleen een verwijzing in .app.json toevoegen is niet voldoende om het label Alleen desktop te verwijderen. Elke app waarnaar wordt verwezen moet nog steeds beschikbaar zijn voor de rol van het lid. De normale toegangs- en authenticatievereisten van de app blijven van toepassing.