Wenn du bereits ein Plugin oder einen Konnektor für Claude Code veröffentlichst, richtet sich die Art der Einreichung danach, ob deine Integration Skills, einen MCP-Server oder beides enthält.
| Was du hast | So reichst du es ein |
|---|---|
| Skills ohne MCP-Server | Lade ein Plugin nur mit Skills hoch. |
| Einen öffentlichen HTTPS-Endpunkt für MCP | Erstelle eine Einreichung für einen Remote-MCP-Server. Füge vorhandene Skills demselben Entwurf hinzu. |
| Einen lokalen MCP-Server | In der Anleitung Plugins nur für den Desktop einreichen findest du die Voraussetzungen und die Schritte zur Einreichung. |
Bei Claude gibt es getrennte Einreichungsverfahren für Plugins für Claude Code und für MCP-Konnektoren. Bei OpenAI reichst du ein einziges Plugin-Paket ein, das Skills, MCP-Server oder beides enthalten kann. Einträge und Genehmigungen aus dem Claude Marketplace werden nicht übernommen.
Wenn dein Plugin Skills enthält, prüfe ihre Anweisungen vor der Einreichung anhand der Hinweise zur Befolgung von Anweisungen. Das gilt für beide Einreichungswege.
Ein Plugin nur mit Skills einreichen
Wähle diesen Weg, wenn dein Plugin keinen MCP-Server benötigt.
Prüfen, was OpenAI unterstützt
| Was dein Claude-Plugin enthält | Was du tun musst |
|---|---|
skills |
Behalte für jeden Skill die zugehörige SKILL.md zusammen mit den Skripten, Referenzen und Ressourcen bei. Wenn du ein Claude-Archiv direkt hochlädst, muss es mindestens einen Skill unter skills/<skill-name>/SKILL.md enthalten. |
| Im Manifest deklarierte benutzerdefinierte Skill-Verzeichnisse | Behalte die Verzeichnisse und die zugehörigen Manifestdeklarationen im Archiv bei. |
| Skills, die sich ausdrücklich auf Claude beziehen | Ersetze Claude-spezifische Bezüge in den Skill-Anweisungen durch anbieterneutrale Formulierungen wie „das Modell“. Behalte einen Produktnamen nur bei, wenn die Anweisung tatsächlich für dieses Produkt gilt. |
commands, commands/, agents oder agents/ |
Überführe wiederverwendbare Abläufe in Skills. Wandle jeden Markdown-Befehl in einen Skill um, übernimm wiederverwendbare Abläufe aus Agenten in Skills und integriere hilfreiche Rollenanweisungen in den jeweiligen Skill. |
hooks oder hooks/hooks.json |
Entferne Lifecycle-Hooks, bevor du das Plugin für das öffentliche Verzeichnis einreichst. Ist das Plugin auf Lifecycle-Hooks angewiesen, stelle es so bereit, dass es sich in der Desktop-Version von Codex manuell installieren lässt. Weitere Informationen findest du im Abschnitt zu Lifecycle-Hooks. |
userConfig oder ${user_config.*} |
OpenAI zeigt bei der Installation keine Eingabeaufforderungen von Claude an und ersetzt user_config-Variablen nicht durch ihre Werte. Folge der Anleitung Claudes userConfig ersetzen. Wenn das Plugin Zugangsdaten oder dauerhaft gespeicherte Benutzereinstellungen benötigt, verwende einen MCP-Server. |
| Skills, die Live-Artefakte von Claude erstellen oder aktualisieren | OpenAI unterstützt derzeit keine Live-Artefakte von Claude. Entferne Anweisungen, die voraussetzen, dass ein Artefakt erstellt, erneut geöffnet, neu geladen oder aktualisiert wird. Gib den Inhalt als reguläre Antwort im Chat aus. Stelle beispielsweise Tabellen aus Artefakten als normale Tabellen dar. Artefaktspezifisches HTML, dauerhafte Speicherung, das Verhalten beim Neuladen und Interaktionen bleiben nicht erhalten. |
bin/, settings, settings.json, CLAUDE.md oder .claude/settings*.json |
Behalte benötigte Hilfsprogramme und Anweisungen im Plugin. Rufe mitgelieferte ausführbare Dateien über Pfade relativ zum Paketverzeichnis auf und entferne Einstellungen, die nur für Claude gelten. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels oder dependencies |
Überführe die wesentlichen Funktionen in Skills und entferne anschließend die Claude-Deklaration. Wende dich an deine Ansprechperson bei OpenAI, wenn der zentrale Workflow eingehende Kanalnachrichten voraussetzt. |
.claude-plugin/plugin.json |
Behalte das Manifest bei, wenn du das Claude-Archiv direkt hochlädst. Das Portal wandelt es in .codex-plugin/plugin.json um. |
.claude-plugin/marketplace.json, .mcp.json, mcpServers, .app.json oder apps |
Verlasse dich nicht auf diese Dateien oder Deklarationen. Beim Hochladen eines Plugins nur mit Skills wird die MCP-Serverkonfiguration ausgeschlossen. Eine bestehende MCP-Serverintegration kannst du nicht per Verweis einreichen. |
Das Archiv vorbereiten und hochladen
- Prüfe, ob das Stammverzeichnis des Archivs oder sein einziges Verzeichnis auf oberster Ebene die Datei
.claude-plugin/plugin.jsonmit einer nicht leerendescriptionund mindestens einen gültigen Skill unterskills/<skill-name>/SKILL.mdenthält. - Öffne das Portal für Plugin-Einreichungen, wähle Create plugin und dann Skills only aus und lade das Archiv hoch.
- Prüfe die generierte Datei
.codex-plugin/plugin.json. Bei der Konvertierung ergänzt das Portal fehlende Standardwerte für die Benutzeroberfläche und vereinheitlicht die Textfelder. - Teste die importierten Skills in einer sauberen Umgebung. Prüfe, ob jeder Skill die Dateien und ausführbaren Programme findet, auf die er verweist, und ohne nicht deklarierte lokale Pakete, Dateien oder Zugangsdaten auskommt.
- Fülle die Felder für den Verzeichniseintrag und die Prüfung aus, behebe alle beim Scan gemeldeten Probleme und reiche den Entwurf ein.
Erfüllt das Archiv die Voraussetzungen für den direkten Upload nicht, erstelle das OpenAI-Manifest und die Paketstruktur anhand der Anleitung Dein Plugin paketieren. Die Anforderungen an Skills findest du in der Anleitung Skills entwickeln.
Ein Plugin mit einem Remote-MCP-Server einreichen
Wähle diesen Weg, wenn der Server eine stabile, öffentliche HTTPS-URL hat, die OpenAI erreichen kann. Im Claude-Plugin kann der Server lokal gelaufen sein. Für die Einreichung zählt, dass du ihn als Remote-Dienst bereitgestellt hast.
Prüfen, was OpenAI unterstützt
| Was deine Claude-Integration enthält | Was du tun musst |
|---|---|
| Einen Remote-MCP-Server | Verwende die bestehende Serverimplementierung weiter. Reiche einen stabilen, öffentlichen HTTPS-Endpunkt ein, der Streamable HTTP verwendet. |
Einen lokalen MCP-Server oder eine Erweiterung für Claude Desktop (.mcpb) |
Stelle den MCP-Server unter einer öffentlichen HTTPS-URL bereit oder folge der Anleitung Plugins nur für den Desktop einreichen, um ein lokales MCP-Plugin einzureichen. Das Portal akzeptiert keine .mcpb-Dateien. |
| Skills oder im Manifest deklarierte benutzerdefinierte Skill-Verzeichnisse | Füge die Skills derselben Einreichung mit der Option With MCP hinzu. Behalte jede SKILL.md zusammen mit den zugehörigen Skripten, Referenzen und Ressourcen bei. |
| Skills, die sich ausdrücklich auf Claude beziehen | Ersetze Claude-spezifische Bezüge in den Skill-Anweisungen durch anbieterneutrale Formulierungen wie „das Modell“. Behalte einen Produktnamen nur bei, wenn die Anweisung tatsächlich für dieses Produkt gilt. |
commands, commands/, agents oder agents/ |
Überführe wiederverwendbare Abläufe in Skills. Wandle jeden Markdown-Befehl in einen Skill um, übernimm wiederverwendbare Abläufe aus Agenten in Skills und integriere hilfreiche Rollenanweisungen in den jeweiligen Skill. |
hooks oder hooks/hooks.json |
Entferne Lifecycle-Hooks, bevor du das Plugin für das öffentliche Verzeichnis einreichst. Ist das Plugin auf Lifecycle-Hooks angewiesen, stelle es so bereit, dass es sich in der Desktop-Version von Codex manuell installieren lässt. Weitere Informationen findest du im Abschnitt zu Lifecycle-Hooks. |
userConfig oder ${user_config.*} |
OpenAI zeigt bei der Installation keine Eingabeaufforderungen von Claude an und ersetzt user_config-Variablen nicht durch ihre Werte. Folge der Anleitung Claudes userConfig ersetzen. Nutze je nach Wert eine explizite Eingabe, OAuth, gehosteten Speicher oder eine lokale Codex-Konfiguration. |
| Skills, die Live-Artefakte von Claude erstellen oder aktualisieren | OpenAI unterstützt derzeit keine Live-Artefakte von Claude. Entferne Anweisungen, die voraussetzen, dass ein Artefakt erstellt, erneut geöffnet, neu geladen oder aktualisiert wird. Gib den Inhalt als reguläre Antwort im Chat aus. Stelle beispielsweise Tabellen aus Artefakten als normale Tabellen dar. Artefaktspezifisches HTML, dauerhafte Speicherung, das Verhalten beim Neuladen und Interaktionen bleiben nicht erhalten. |
.app.json, apps oder eine bestehende MCP-Serverintegration |
Reiche den Endpunkt des MCP-Servers direkt ein. Eine bestehende MCP-Serverintegration kannst du nicht per Verweis einreichen. |
outputStyles, lspServers, experimental.themes, experimental.monitors, channels oder dependencies |
Überführe die wesentlichen Funktionen in Skills oder MCP-Tools und entferne anschließend die Claude-Deklaration. Wende dich an deine Ansprechperson bei OpenAI, wenn der zentrale Workflow eingehende Kanalnachrichten voraussetzt. |
Den MCP-Server vorbereiten und einreichen
- Stelle den MCP-Server an seinem HTTPS-Endpunkt für den Produktivbetrieb bereit und verwende Streamable HTTP. Nutze OAuth 2.1, wenn der Server auf private Nutzerdaten zugreift oder im Auftrag einer Person Aktionen ausführt. Beachte die in der Anleitung Nutzende authentifizieren beschriebenen Produktanforderungen und die dort angegebene MCP-Spezifikation für die Autorisierung.
- Ergänze präzise Tool-Schemas und Sicherheitsannotationen. Teste für jedes Tool, ob der Verbindungsaufbau und die Authentifizierung funktionieren, das Ergebnis die erwartete Struktur hat und das Tool bei schreibenden oder destruktiven Aktionen die vorgesehene Bestätigung verlangt.
- Wandle vorhandene Befehle oder Agenten in Skills um und stelle sicher, dass die Skills ohne nicht deklarierte lokale Pakete, Dateien oder Zugangsdaten auskommen.
- Öffne das Portal für Plugin-Einreichungen, wähle Create plugin und dann With MCP aus und reiche den Endpunkt für den Produktivbetrieb ein. Füge gegebenenfalls die konvertierten Skills demselben Entwurf hinzu.
- Verifiziere die Serverdomain und konfiguriere die Authentifizierung, wenn der Server eine Anmeldung erfordert. Fülle die Felder für den Verzeichniseintrag und die Prüfung aus, behebe alle beim Scan gemeldeten Probleme und reiche den Entwurf ein.
Plane vor der Einreichung zwei Schritte ein:
- Domainverifizierung: Du musst das vom Portal vorgegebene Token unverändert unter
/.well-known/openai-apps-challengeauf dem MCP-Host oder einem zulässigen übergeordneten Host ausliefern können. Schließe die Verifizierung ab, sobald das Portal dich dazu auffordert. Details findest du in der Anleitung MCP-Einreichung konfigurieren. - OAuth und Domainbeschränkungen für den Workspace: Wenn das Plugin OAuth verwendet, stelle einen UserInfo-Endpunkt bereit, der für die angemeldete Person den Claim
emailundemail_verified: truezurückgibt. Weise die Scopesopenidundemailals unterstützt aus und aktiviere sie. Weitere Informationen findest du in der Anleitung Domainbeschränkungen für den Workspace unterstützen.
Lies vor der Einreichung die Prüfanforderungen für Remote-MCP-Server.
Claudes userConfig ersetzen
OpenAI-Plugins zeigen bei der Installation keine Eingabeaufforderungen aus Claudes userConfig an und lösen Verweise der Form ${user_config.*} nicht auf. Entferne diese Verweise. Wähle für jeden Wert einen Ersatz, der dazu passt, wie das Plugin den Wert verwendet.
| Wofür der Wert verwendet wird | So ersetzt du ihn bei OpenAI |
|---|---|
| Eine Auswahl, die sich von Aufgabe zu Aufgabe ändern kann | Füge dem Skill oder MCP-Tool einen expliziten Eingabeparameter hinzu. Frage den Wert nur ab, wenn der Workflow ihn benötigt. |
| Zugangsdaten für einen Remote-Dienst | Nutze OAuth 2.1 über den Remote-MCP-Server. Hinterlege keine Geheimnisse im Skill-Archiv, im Manifest, in den Anweisungen oder in den Standardwerten. |
| Eine Einstellung, die dauerhaft gespeichert werden soll | Speichere sie im gehosteten Dienst und ordne sie der authentifizierten Person zu. Ermögliche dieser Person, die Einstellung über einen dafür vorgesehenen Workflow oder eine Tool-Eingabe zu ändern. |
| Eine Einstellung für ein lokal in Codex ausgeführtes Skript oder einen Hook | Verwende eine dokumentierte Umgebungsvariable oder Konfigurationsdatei. Prüfe vor der Verwendung, ob sie vorhanden ist. Fehlt sie, gib eine Fehlermeldung aus, die erklärt, wie sich das Problem beheben lässt. Der zentrale ChatGPT-Workflow muss ohne diese lokale Einstellung funktionieren. |
| Ein fester Wert, der für alle gleich ist | Hinterlege einen nicht vertraulichen Standardwert in den Skill-Anweisungen oder in der Konfiguration des gehosteten Dienstes. |
Wenn ein Plugin nur mit Skills Zugangsdaten benötigt oder eine Einstellung über mehrere Unterhaltungen hinweg speichern muss, füge einen MCP-Server hinzu. Verwende für den Remote-Server OAuth und gehosteten Speicher. Betrifft der Wert nur die aktuelle Aufgabe, belasse es bei einem Plugin nur mit Skills und frage den Wert als explizite Skill-Eingabe ab.
Die Voraussetzungen für die Einreichung erfüllen
Für beide Einreichungswege benötigst du vor der Einreichung Schreibzugriff auf Apps Management in der OpenAI-Organisation, der das Plugin gehören wird. Außerdem musst du deine Identität als Einzelperson oder Unternehmen verifizieren lassen. Jedes Plugin muss das Prüfverfahren von OpenAI durchlaufen.
Wende dich vor der Einreichung an deine Ansprechperson bei OpenAI, wenn das Plugin für seine zentrale Funktion lokal ausgeführt werden muss, beliebigen Zugriff auf Dateien auf dem Rechner der jeweiligen Person oder Zugriff auf Hardware oder Anwendungen benötigt, offline funktionieren muss oder auf eingehende Kanalnachrichten angewiesen ist. In diesen Fällen kann eine produktspezifische Prüfung erforderlich sein.
Den vollständigen Ablauf im Portal findest du in der Anleitung Plugins einreichen. Wenn das Portal bei der Paketvalidierung einen Fehlercode meldet, schlage ihn in der Fehlerreferenz für Einreichungen nach.