Überblick

Personen mit Workspace-Adminrechten können einen Plugin-Marktplatz von GitHub in ihr Workspace-Verzeichnis importieren. Ein Marktplatz ist ein JSON-Katalog, der die zu importierenden Plugins auflistet. Nach dem Import werden die Plugins täglich synchronisiert, um Änderungen aus dem Repository zu übernehmen.


Die Marktplatz-Synchronisierung importiert Plugin-Inhalte. Sie verbindet keine Konten von Workspace-Mitgliedern und gewährt keinen Zugriff auf die in einem Plugin enthaltenen Apps.


Eine Einführung in Plugins und die darin enthaltenen Apps findest du im Artikel Plugins in ChatGPT und Codex.

Bevor du beginnst

• Verwende ein GitHub-Konto mit Lesezugriff auf das Marktplatz-Repository und jedes weitere Repository, auf das es verweist. Öffentliche und private Repositorys auf github.com werden unterstützt.

• Hole alle erforderlichen Genehmigungen der GitHub-Organisation ein, damit das für den Import verwendete Konto auf diese Repositorys zugreifen kann.

• Prüfe den Inhalt des Repositorys. Beim Import werden alle gültigen Plugins ohne einzelne Genehmigungsschritte verarbeitet. Künftige Synchronisierungen können neue Plugins hinzufügen.

Neue Plugins erhalten zunächst die Installationseinstellung Verfügbar und erfordern die Authentifizierung bei der Installation. Bei neuen Marktplätzen ist die automatische tägliche Synchronisierung aktiviert. Prüfe nach dem Import für jedes Plugin die Workspace-Einstellungen und die erforderlichen Apps.

Einen Marktplatz importieren

1. Rufe die Admin-Konsole auf, wähle den gewünschten ChatGPT-Workspace aus und öffne Plugins. Wähle dann Hinzufügen und anschließend Marktplatz importieren aus.

2. Gib unter Quelle die Repository-URL ein, zum Beispiel https://github.com/example/team-plugins. Verwende nur die Repository-URL, keine URL zu einem Branch oder Ordner.

3. Wenn sich der Marktplatz in einem Unterverzeichnis befindet, gib dieses unter Pfad ein. Gib beispielsweise team-tools für team-tools/.agents/plugins/marketplace.json ein. Lass Pfad leer, wenn du das Stammverzeichnis des Repositorys verwenden möchtest. Gib nicht den Dateinamen des Manifests ein.

4. Optional kannst du unter Branch, Tag oder Commit einen Wert eingeben. Lass das Feld leer, um den Standardbranch des Repositorys zu verwenden. Verwende einen Branch, um künftige Commits zu erhalten. Bei einem festgelegten Commit bleibt der Stand unverändert.

5. Wähle Marktplatz importieren aus und autorisiere den GitHub-Zugriff, wenn du dazu aufgefordert wirst.

6. Prüfe die Importergebnisse. Öffne dann jedes importierte Plugin, um seine Installationsrichtlinie und gegebenenfalls erforderliche Apps zu konfigurieren.

Der erste Import kann bei sehr großen Marktplätzen bis zu 1 Stunde dauern. Die anschließenden täglichen Synchronisierungen dauern in der Regel nur wenige Minuten.

Wenn ein Plugin nicht importiert werden kann, wird der Fehler im Bericht erläutert. Andere gültige Plugins können trotzdem importiert werden.

Unterstützte Formate

Das ausgewählte Verzeichnis muss ein unterstütztes Manifest enthalten:

• .agents/plugins/marketplace.json für einen Codex-Marktplatz.

• .claude-plugin/marketplace.json für einen Claude-kompatiblen Marktplatz.

• .claude-plugin/plugin.json für ein eigenständiges Claude-Plugin, wenn kein Marktplatz-Manifest vorhanden ist.

Marktplatzeinträge können auf Plugin-Ordner im selben Repository oder auf unterstützte GitHub-Repository-Quellen verweisen. Andere Git-Hostingdienste und Paketregistrierungsquellen wie npm werden beim Workspace-Import nicht unterstützt.

Informationen zu unterstützten Formaten, JSON-Beispielen und Quellenfeldern findest du im Artikel Plugin-Verwaltung.

Workspace-Zugriff konfigurieren

GitHub liefert die Plugin-Inhalte. Die Workspace-Einstellungen steuern hingegen Installation und Authentifizierung. Import und Synchronisierung übernehmen keine Richtlinienwerte aus dem Repository, etwa AVAILABLE oder ON_USE. Konfiguriere diese Einstellungen für jedes Plugin in deinem Workspace.


Wähle unter Installationsrichtlinie für jede berechtigte Rolle Verfügbar oder Installiert aus. Erforderliche Apps müssen ebenfalls aktiviert sein. Mitglieder müssen Zugriff auf den verbundenen Dienst haben und alle erforderlichen Authentifizierungsschritte abschließen.


Wenn du ein Plugin-Update synchronisierst oder ein vorhandenes Plugin auf die Verwaltung über GitHub umstellst, bleiben seine Workspace-Richtlinien erhalten. Der Import eines Plugins gewährt keinen App-Zugriff und verbindet keine Konten von Mitgliedern.


Informationen zur Workspace-Navigation, zum App-Zugriff und zu den Workspace-Steuerungsmöglichkeiten findest du im Artikel Admin-Steuerungsmöglichkeiten, Sicherheit und Compliance für Plugins und Apps.

Plugins aktuell halten

Bei neuen Marktplätzen wird täglich nach Updates gesucht. So forderst du ein Update an, ohne auf die automatische Synchronisierung zu warten:

1. Rufe die Admin-Konsole auf, wähle den gewünschten ChatGPT-Workspace aus und öffne Plugins.

2. Öffne Marktplätze und wähle den Marktplatz aus.

3. Wähle Jetzt synchronisieren aus.

Die Synchronisierung kann neue Marktplatzeinträge hinzufügen und vorhandene Plugins aktualisieren. Prüfe Änderungen am Repository vor dem Zusammenführen, da die automatische Synchronisierung neue Plugins ohne einen weiteren Importschritt importieren kann.

Synchronisierungsergebnisse prüfen

Prüfe nach einer Synchronisierung ihren Status und den gespeicherten Bericht. Abgeschlossen: N Fehler bedeutet, dass die Synchronisierung beendet wurde, einige Plugins aber nicht verarbeitet werden konnten.


Wenn ein Update für ein vorhandenes Plugin ungültig ist, bleibt dessen letzte funktionsfähige Version erhalten. Andere gültige Updates können trotzdem abgeschlossen werden. Behebe das gemeldete Problem in GitHub und wähle dann Jetzt synchronisieren aus, um es erneut zu versuchen.


Wenn deine Admin-Ansicht für ein einzeln importiertes Plugin die Option Aktualisieren anzeigt, nutze sie, um dieses Plugin zu aktualisieren. Plugin-Liste aktualisieren lädt nur die angezeigte Liste neu. Es findet keine Synchronisierung mit GitHub statt.

Entfernen und Löschen verstehen

Wenn du einen Eintrag aus dem Repository entfernst, wird seine importierte Kopie im Workspace nicht gelöscht. Das Plugin wird als Nicht mehr in der Quelle vorhanden gekennzeichnet.


Wenn du den Marktplatz in ChatGPT löschst, werden alle daraus importierten Plugins gelöscht. Lösche keinen Marktplatz, um GitHub erneut zu verbinden oder die Zuständigkeit zu übertragen.

GitHub-Zugriff wiederherstellen oder ändern

Die Marktplatz-Synchronisierung nutzt die GitHub-Verbindung der Person mit Adminrechten, die den Marktplatz importiert hat. Dieses Konto benötigt weiterhin Zugriff auf das Marktplatz-Repository und alle referenzierten Repositorys.

Das ursprüngliche Konto erneut verbinden

1. Vergewissere dich, dass das für den Import verwendete GitHub-Konto weiterhin Zugriff auf alle erforderlichen Repositorys hat.

2. Bitte die Person mit Adminrechten, die den Marktplatz ursprünglich importiert hat, das GitHub-Plugin in ChatGPT zu öffnen und ihr Konto erneut zu verbinden.

An eine neue Person mit Adminrechten übertragen

Die neue Person mit Workspace-Adminrechten kann denselben Marktplatz über ihre eigene GitHub-Verbindung importieren:

1. Rufe die Admin-Konsole auf, wähle den gewünschten ChatGPT-Workspace aus und öffne Plugins. Wähle dann Hinzufügen > Marktplatz importieren aus.

2. Gib für Quelle, Pfad und Branch, Tag oder Commit dieselben Werte ein, die für den vorhandenen Marktplatz verwendet wurden.

3. Wähle Marktplatz importieren aus und autorisiere den GitHub-Zugriff, wenn du dazu aufgefordert wirst.

Künftige Synchronisierungen nutzen die GitHub-Verbindung der neuen Person mit Adminrechten. Das Konto der neuen Person mit Adminrechten benötigt Lesezugriff auf das Marktplatz-Repository und jedes Repository, auf das es verweist.

Ein vorhandenes Plugin auf die Verwaltung über GitHub umstellen

Du kannst über einen Marktplatz ein vorhandenes Workspace-Plugin verwalten, das als Archiv hochgeladen wurde oder noch nicht über eine GitHub-Quelle verwaltet wird. Das vorhandene Plugin muss sich im selben Workspace befinden und denselben Plugin-Namen haben. Ein Plugin, das über eine andere GitHub-Quelle verwaltet wird, kann auf diese Weise nicht übernommen werden.


So gibst du das vorhandene Plugin in deinem Marktplatz an:

1. Rufe die Admin-Konsole auf, wähle den gewünschten ChatGPT-Workspace aus und öffne Plugins. Öffne das Plugin.

2. Kopiere die Plugin-ID, die in seiner URL nach /admin/plugins/ steht.

3. Füge diese ID als pluginId neben name und source im passenden Eintrag des plugins-Arrays des Marktplatzes hinzu. Füge sie nicht zur Datei plugin.json des Plugins hinzu.

Das Plugin behält seine ID, Freigabeeinstellungen und Workspace-Richtlinien. GitHub wird zur Quelle für künftige Updates. Das Plugin kann daher später nicht mehr durch hochgeladene Archive ersetzt werden.


Ein Migrationsbeispiel und die Anforderungen findest du im Artikel Plugin-Verwaltung.

Auf eine vorhandene App verweisen

Ein Plugin kann in der Datei .app.json im Stammverzeichnis des Plugins auf eine vorhandene App verweisen. Behalte den führenden Punkt im Dateinamen bei und verwende die ID der App statt einer Plugin-ID. Setze bei einem nativen Plugin das Feld apps in .codex-plugin/plugin.json auf ./.app.json.


Der Verweis erstellt keine App und gewährt keine zusätzlichen Berechtigungen. Die bestehenden Einstellungen der App für Workspace-Zugriff, Authentifizierung und Aktionssteuerung sowie die Berechtigungen für verbundene Dienste gelten weiterhin.


Informationen zum JSON-Format findest du im Artikel Plugin-Verwaltung.

Die Kennzeichnung „Nur Desktop“ verstehen

Ein mit Nur Desktop gekennzeichnetes Plugin kann nicht in ChatGPT im Web ausgeführt werden. Importierte Plugins können diese Kennzeichnung erhalten, wenn sie MCP-Server deklarieren, etwa in mcp.json oder .mcp.json. Das gilt auch, wenn ein Server eine externe HTTPS-URL verwendet.


Ein Verweis in .app.json allein entfernt die Kennzeichnung Nur Desktop nicht. Jede referenzierte App muss weiterhin für die Rolle des Mitglieds verfügbar sein. Ihre üblichen Zugriffs- und Authentifizierungsanforderungen gelten ebenfalls.