Du kannst Plugins von GitHub in deinen Workspace importieren und sie bei Änderungen im Repository auf dem neuesten Stand halten. Ein Marketplace ist eine JSON-Datei, die alle zu importierenden Plugins auflistet.
Bevor du beginnst
Du brauchst Adminrechte für den Workspace. Verwende ein GitHub-Konto mit Lesezugriff auf das Marketplace-Repository und auf alle Repositorys, auf die es verweist. Sowohl öffentliche als auch private GitHub-Repositorys werden unterstützt. Hole vor dem Import alle Zugriffsgenehmigungen ein, die deine GitHub-Organisation verlangt.
Prüfe das Repository vor dem Import. Die folgenden Standardeinstellungen bestimmen, welche Plugins Mitglieder nutzen können:
- Neue Plugins haben den Status Verfügbar. Mitglieder können sie installieren. Erfordert das Plugin eine Authentifizierung, führen die Mitglieder sie bei der Installation durch.
- Beim Import werden alle gültigen Einträge verarbeitet. Neue Marketplaces werden täglich automatisch synchronisiert. Dabei kommen neue Plugins aus dem Repository hinzu.
Diese Anleitung beschreibt, wie du Plugins in einen Workspace importierst. Für lokale Clients erklärt Plugin-Marketplaces und Standardeinstellungen konfigurieren, wie du Einstellungen über die Cloud oder die systemweite config.toml verwaltest. Für einzelne Projekte siehe Ein Plugin für ein Repository aktivieren oder deaktivieren.
Marketplace-Synchronisierung konfigurieren
- Öffne Admin > Plugins und wähle Hinzufügen > Marketplace importieren.
- Gib unter Quelle die URL des Repositorys ein, zum Beispiel
https://github.com/example/team-plugins. Verwende nur die Repository-URL. Gib keine URL für einen Branch oder Ordner ein. - Liegt der Marketplace in einem Unterverzeichnis, gib dieses unter Pfad ein. Verwende zum Beispiel
team-toolsfürteam-tools/.agents/plugins/marketplace.json. Liegt der Marketplace im Stammverzeichnis des Repositorys, lass Pfad leer. Gib den Dateinamen des Manifests nicht ein. - Unter Branch, Tag oder Commit kannst du optional einen Wert eingeben. Lass das Feld leer, um den Standard-Branch des Repositorys zu verwenden. Mit einem Branch kannst du spätere Updates erhalten. Mit einem festen Commit bleibst du bei der ausgewählten Version.
- Wähle Marketplace importieren und genehmige den Zugriff auf GitHub, wenn du dazu aufgefordert wirst. Bei besonders großen Marketplaces kann der erste Import bis zu einer Stunde dauern. Die anschließende tägliche Synchronisierung dauert in der Regel nur wenige Minuten.
- Prüfe die Importergebnisse. Öffne dann jedes importierte Plugin, um seine Installationsrichtlinie und alle benötigten Apps zu konfigurieren.
Unterstützte Formate
Das ausgewählte Verzeichnis muss eine der folgenden Dateien enthalten:
| Datei | Format |
|---|---|
.agents/plugins/marketplace.json |
Ein Codex-Marketplace mit einem plugins-Array. |
.claude-plugin/marketplace.json |
Ein Claude-kompatibler Marketplace mit einem plugins-Array. |
.claude-plugin/plugin.json |
Ein eigenständiges Claude-Plugin, wenn kein Marketplace-Manifest vorhanden ist. |
Marketplace-Einträge können auf native Plugins mit .codex-plugin/plugin.json, Claude-kompatible Plugins, Pakete im Format Agent Plugins 1.0 oder unterstützte Skill-Pakete verweisen.
Verwende in einem Codex-Marketplace lokale Pfade für Plugins, die im selben Repository liegen:
{
"name": "team-plugins",
"interface": {
"displayName": "Team plugins"
},
"plugins": [
{
"name": "team-tools",
"source": {
"source": "local",
"path": "./plugins/team-tools"
}
}
]
}
Der Pfad ist relativ zum ausgewählten Stammverzeichnis des Marketplaces, nicht zu .agents/plugins/.
In einem Claude-kompatiblen Marketplace kannst du den Pfad für jedes lokale Plugin als Zeichenfolge angeben:
{
"name": "team-plugins",
"plugins": [
{
"name": "team-tools",
"source": "./plugins/team-tools"
}
]
}
Einträge in einem Codex-Marketplace unterstützen außerdem source: "url" für Plugins im Stammverzeichnis eines GitHub-Repositorys und source: "git-subdir" für Plugins in einem Unterverzeichnis eines GitHub-Repositorys. Beispiel:
{
"name": "team-tools",
"source": {
"source": "git-subdir",
"url": "https://github.com/example/team-tools.git",
"path": "./plugins/team-tools",
"ref": "main"
}
}
Bei Git-Quellen kannst du eine Referenz über ref oder den vollständigen 40-stelligen Commit-Hash über sha angeben. Das GitHub-Konto, mit dem du den Zugriff genehmigst, braucht Lesezugriff auf jedes referenzierte Repository. Der Import in einen Workspace unterstützt derzeit nur GitHub-Repositorys.
Zugriff im Workspace konfigurieren
Lege die Einstellungen für die Installation und Authentifizierung jedes Plugins in deinem Workspace fest. Beim Import und bei der Synchronisierung werden diese Einstellungen nicht aus dem Repository übernommen. Dazu gehören AVAILABLE, INSTALLED_BY_DEFAULT, NOT_AVAILABLE, ON_INSTALL und ON_USE. Bestehende Workspace-Einstellungen bleiben erhalten, wenn du ein Update synchronisierst oder die Verwaltung eines Plugins auf GitHub umstellst.
Wähle unter Installationsrichtlinie für jede berechtigte Rolle Verfügbar oder Installiert. Aktiviere auch die Apps, die das Plugin benötigt, und prüfe, ob die Mitglieder Zugriff auf den verbundenen Dienst haben. Durch den Import eines Plugins erhalten Mitglieder keinen App-Zugriff. Ihre Konten werden dabei auch nicht verbunden. Hilfe bei der Auswahl der Einstellungen für Zugriff und Aktionen findest du im Abschnitt Plugin-Einstellungen.
Verwaltung eines bestehenden Plugins auf GitHub umstellen
Ergänze den Marketplace-Eintrag des bestehenden Plugins um pluginId:
{
"name": "team-tools",
"pluginId": "plugin_0123456789abcdef0123456789abcdef",
"source": {
"source": "local",
"path": "./plugins/team-tools"
}
}
Öffne das Plugin unter Admin > Plugins und kopiere die ID, die in der URL auf /plugins/ folgt. Füge pluginId im Marketplace-Eintrag auf derselben Ebene wie name und source ein. Das bestehende Plugin muss sich im selben Workspace befinden. Der Wert von name im Eintrag muss mit dem Namen des bestehenden Plugins übereinstimmen.
So kannst du ein Workspace-Plugin künftig über GitHub verwalten, sofern es dort noch nicht verwaltet wird. Die ID, die Freigaben und die Workspace-Einstellungen des Plugins bleiben erhalten. Künftige Updates kommen von GitHub. Du kannst das Plugin daher nicht mehr durch Hochladen eines Archivs ersetzen. Für Plugins, die bereits über eine andere GitHub-Quelle verwaltet werden, kannst du dieses Verfahren nicht verwenden.
Plugins nur für den Desktop
Plugins mit der Kennzeichnung Nur Desktop lassen sich in ChatGPT im Web nicht ausführen. Importierte Plugins können diese Kennzeichnung erhalten, wenn sie MCP-Server deklarieren. Das gilt auch für Server mit einer Remote-HTTPS-URL. Ein Verweis auf .app.json allein hebt die Kennzeichnung nicht auf.
Mit .app.json auf eine bestehende App verweisen
Lege .app.json im Stammverzeichnis des Plugins an. Der Dateiname beginnt mit einem Punkt. app.json ohne Punkt wird nicht unterstützt.
{
"apps": {
"team-tools": {
"id": "asdk_app_example",
"required": true
}
}
}
Ersetze asdk_app_example durch die ID der bestehenden App. Unterstützte App-IDs beginnen mit asdk_app_, connector_ oder templated_apps_. Verwende die App-ID und keine ID der Form plugin_.... Enthält eine Plugin-URL zum Beispiel plugin_asdk_app_example, steht das für die App asdk_app_example.
Der Schlüssel team-tools gibt dem Verweis innerhalb dieser Datei einen Namen. Setze required auf true, wenn das Plugin die App benötigt. Mit weiteren Einträgen kannst du auf andere bestehende Apps verweisen.
Setze bei einem nativen Plugin apps auf ./.app.json. Diese Einstellung gehört in die Datei .codex-plugin/plugin.json. Das vollständige Manifest für dieses Beispiel sieht so aus:
{
"name": "team-tools",
"version": "1.0.0",
"description": "Use the team's approved tools.",
"author": {
"name": "Example team"
},
"apps": "./.app.json",
"interface": {
"displayName": "Team tools",
"shortDescription": "Use approved team tools",
"longDescription": "Connect to the team's existing app.",
"developerName": "Example team",
"category": "Productivity",
"capabilities": ["Read"]
}
}
Behalte diese Verzeichnisstruktur bei:
team-plugins/
├── .agents/plugins/marketplace.json
└── plugins/team-tools/
├── .codex-plugin/plugin.json
└── .app.json
Die Datei verweist auf eine bestehende App. Sie erstellt keine App und gewährt niemandem Zugriff. Gib die App für die Rollen frei, die sie benötigen, und bitte die Mitglieder, die erforderliche Authentifizierung abzuschließen. Die Berechtigungen der App, die zulässigen Aktionen und die Zugriffsregeln des verbundenen Dienstes gelten weiterhin.
Plugins auf dem neuesten Stand halten
Neue Marketplaces prüfen täglich, ob Updates vorliegen. Öffne Admin > Plugins > Marketplaces, wähle den Marketplace aus und klicke auf Jetzt synchronisieren, um ein Update anzufordern, ohne auf die automatische Synchronisierung zu warten.
Die Synchronisierung kann neue Plugins aus dem Marketplace hinzufügen und bestehende aktualisieren. Prüfe Änderungen am Repository vor dem Zusammenführen, da die automatische Synchronisierung auch neue Plugins importiert.
Prüfe nach jeder Synchronisierung den Status und lies den gespeicherten Bericht. Auch bei einer abgeschlossenen Synchronisierung können bei einzelnen Plugins Fehler aufgetreten sein. Ist ein Update ungültig, behält das bestehende Plugin seine letzte funktionierende Version. Behebe das Problem auf GitHub und wähle dann Jetzt synchronisieren, um es erneut zu versuchen.
Wenn du den Eintrag eines Plugins aus dem Marketplace entfernst, bleibt die Kopie im Workspace erhalten und erhält die Kennzeichnung Nicht mehr in der Quelle vorhanden. Wenn du dagegen den Marketplace in ChatGPT löschst, werden auch alle Plugins gelöscht, die aus diesem Marketplace importiert wurden.
GitHub-Verbindung wiederherstellen oder GitHub-Zugriff ändern
Für die Synchronisierung verwendet der Marketplace die GitHub-Verbindung der Person, die ihn mit Adminrechten importiert hat.
Prüfe vor dem erneuten Verbinden, ob das GitHub-Konto dieser Person noch Lesezugriff auf das Marketplace-Repository und alle darin referenzierten Repositorys hat. Anschließend sollte die Person das GitHub-Plugin in ChatGPT öffnen und ihr Konto erneut verbinden.
Wenn eine andere Person die Verwaltung übernimmt, importiert sie den Marketplace mit ihren Workspace-Adminrechten erneut über Admin > Plugins > Hinzufügen > Marketplace importieren. Dabei muss sie für Quelle, Pfad und Branch, Tag oder Commit dieselben Werte wie beim ursprünglichen Import verwenden. Künftige Synchronisierungen laufen über ihre GitHub-Verbindung.
Behalte den Marketplace bei, wenn du die Verbindung wiederherstellst oder die Verwaltung übergibst. Wenn du ihn löschst, werden auch die daraus importierten Plugins gelöscht.