Wenn du ein Plugin entwickelt hast und es mehr Menschen zugänglich machen möchtest, können sie es über das Plugin-Verzeichnis finden und in ChatGPT und Codex nutzen. Dein Plugin kann MCP-Verbindungen, Skills oder beides enthalten.
Lade das fertige Paket als ZIP-Datei hoch, behebe die bei den automatischen Prüfungen erkannten Probleme und reiche das Paket zur Prüfung ein. Nach der Genehmigung entscheidest du, wann du es veröffentlichst.
Nach der ersten Veröffentlichung werden Änderungen an deinem MCP-Server automatisch erkannt. Aktualisierungen, die dafür infrage kommen, gehen online, sobald sie die automatischen Prüfungen bestanden haben. Dafür musst du weder eine neue Plugin-ZIP-Datei hochladen noch jede Aktualisierung einzeln veröffentlichen. Für Änderungen an den Plugin-Metadaten oder Skills brauchst du weiterhin eine neue ZIP-Datei.
Befolge vor dem Einreichen die Anleitung für Plugin-Pakete und lies die Plugin-Richtlinien. Hilfe bei der Vorbereitung deiner Einreichung bietet Plugin Creator im Plugin-Verzeichnis.

Plugin-Übersicht. Auf der Seite „Plug-ins“ kannst du eine Einreichung starten und den Stand der Veröffentlichung, der Prüfung und des MCP-Setups verfolgen.
Reiche Remote-MCP-Server über Mit MCP ein. Verwende dafür einen stabilen, öffentlich erreichbaren HTTPS-Endpunkt. Wenn dein Plugin einen lokalen MCP-Server ausführt oder auf dem Desktop ausgeführt werden muss, folge der Anleitung Reine Desktop-Plugins einreichen.
1. Plugin-ZIP-Datei hochladen
Zugriffsrechte und Identität für die Veröffentlichung prüfen
Wähle die Organisation und das Projekt aus, denen das Plugin gehören soll. Wer Inhaberrechte für die Organisation hat, kann Plugins einreichen. Andere Mitglieder benötigen die Berechtigung Apps Management Write. Personen mit Inhaberrechten können sie über die Organisationsrollen erteilen.
Schließe in den Organisationseinstellungen die Verifizierung als Einzelperson oder Unternehmen ab, um unter deinem Namen oder einem Firmennamen zu veröffentlichen.
Entwurf erstellen
Wenn dein Plugin einen MCP-Server verwendet, nimm ihn bereits in die erste ZIP-Datei auf. Einem bestehenden Plugin, das nur Skills enthält, kannst du derzeit keinen MCP-Server hinzufügen.
- Öffne Plug-ins und wähle Neues oder bestehendes Plugin hochladen.
- Wähle deine verifizierte Entwickleridentität. Im Verzeichnis erscheint der Name, der mit dieser Identität verknüpft ist.
- Wähle Plugin hochladen und dann deine ZIP-Datei.
- Nach der Validierung öffnet sich die Detailseite des Plugins mit deinem neuen Entwurf.
Wenn die Validierung fehlschlägt, behebe die gemeldeten Paketfehler und lade das Paket erneut hoch. Private Zugangsdaten und Secrets gehören nicht in die ZIP-Datei.
2. Prüfergebnisse durchsehen und Probleme beheben
Nach dem Hochladen der ZIP-Datei siehst du auf der Detailseite des Plugins den Fortschritt und die Ergebnisse der automatischen Prüfungen. So kannst du Probleme vor dem Einreichen beheben. Unter Metadaten & Skills siehst du die hochgeladene Version des Plugin-Pakets, unter MCPs den verbundenen Server und die beim Scan erkannten Tools. Die Bereiche sind getrennt, weil du für Paketänderungen eine neue ZIP-Datei hochladen musst, während Änderungen an gehosteten Tools direkt auf deinem Server geprüft werden.
Metadaten prüfen
- Öffne Metadaten & Skills. Die zuletzt hochgeladene Version wird automatisch angezeigt.
- Warte, bis die Metadatenprüfungen abgeschlossen sind. Sieh dann unter Probleme nach, ob etwas gemeldet wurde.
- Wähle Probleme kopieren, um die Meldungen in deiner Entwicklungsumgebung zu bearbeiten.
- Korrigiere die betroffenen Felder in deinem Paket. Wähle dann Plugin zur Fehlerbehebung hochladen, lade die korrigierte ZIP-Datei hoch und prüfe die neuen Ergebnisse.
Tipp: Bitte Codex oder ChatGPT, dein Paket und die kopierten Meldungen zu prüfen, die Probleme zu erklären und Korrekturen für die Metadaten oder Skills vorzuschlagen.

Prüfergebnisse für Metadaten. Sieh dir die Meldungen zur ausgewählten Paketversion an und lade eine korrigierte ZIP-Datei hoch.
Hier kannst du die Paketdetails nur einsehen. Bearbeite sie in deinem Quellpaket anhand der Referenz für Paketfelder. Öffentliche URLs müssen erreichbar sein. Aus ihnen muss hervorgehen, dass die Veröffentlichung von derselben Person oder Organisation stammt, die in der Einreichung angegeben ist.
Skills prüfen
Wenn dein Paket Skills enthält, sieh dir die Meldungen unter Metadaten & Skills an. Öffne eine Meldung, um zu sehen, welchen Skill sie betrifft und was du ändern musst. Passe die Anweisungen des Skills oder die zugehörigen Dateien an und lade eine korrigierte ZIP-Datei hoch. Prüfe die aktualisierten Ergebnisse. Bevor du das Paket einreichen kannst, müssen die erforderlichen Skill-Scans erfolgreich abgeschlossen sein.
MCP-Server verbinden und scannen
Dein Paket kann mehrere MCP-Server deklarieren, aber pro Plugin lässt sich nur ein MCP-Server verbinden. Führe die folgenden Schritte aus, wenn du diesen Server zum ersten Mal verbindest. Wenn es Probleme mit der Verbindung gibt, wähle Erneut verbinden. Bei Änderungen an Tools folge der Anleitung Neueste Änderungen scannen.
- Öffne MCPs und wähle den Server aus, den du verbinden möchtest.
- Wähle Verbinden, um MCP-Server verbinden zu öffnen.
- Prüfe die MCP-Server-URL, die Authentifizierung und die zugehörigen Einstellungen.
- Führe die im Portal angezeigte Challenge zur Domainverifizierung durch. Verbinde dann den Server und schließe bei Bedarf die Authentifizierung ab.
- Warte, bis der automatische Tool-Scan abgeschlossen ist, und prüfe die erkannten Tools. Öffne Probleme, um etwaige Meldungen zu lesen.
- Behebe Verbindungsprobleme oder die auf dem Server erkannten Probleme. Wähle je nach Fall Erneut verbinden oder Erneut scannen und prüfe die neuen Ergebnisse.

MCP-Verbindung und Domainverifizierung. Verbinde den Server und schließe die Domainverifizierung ab, bevor du die erkannten Tools prüfst.
Wähle für ein genehmigtes lokales MCP-Plugin Nur Skills und folge der Anleitung zum Einreichen reiner Desktop-Plugins.
Während du das Formular ausfüllst, speichert das Portal die Einreichung als Entwurf.
Wenn die Verbindung oder der Scan fehlschlägt, prüfe die Erreichbarkeit des Endpunkts und die Authentifizierung. Stelle die Verbindung dann erneut her oder starte einen neuen Scan. Behebe vor dem Einreichen alle unter MCP-Setup abschließen gemeldeten Probleme sowie etwaige Verbindungsfehler. Die Anforderungen an die MCP-Server-URL, die Authentifizierung, die Tool-Metadaten und die Benutzeroberfläche findest du in den Plugin-Richtlinien.
Authentifizierung für die Einreichung konfigurieren
Das Portal liest die erweiterten Authentifizierungseinstellungen aus der mcp.json deines Pakets. Konfiguriere die Authentifizierungsmethode, die OAuth-Clientregistrierung, die Endpunkte und die Scopes anhand der Referenz zur MCP-Authentifizierung. Im Verbindungsbereich kannst du diese Einstellungen einsehen. Einen Editor für erweiterte OAuth-Einstellungen gibt es dort nicht.
Um die Konfiguration zu ändern, aktualisiere mcp.json und wähle Neue Version hochladen. Prüfe vor dem Verbinden die gespeicherten Einstellungen unter MCPs. Eine bestehende Clientregistrierung kann Änderungen an den Zugangsdaten verhindern. Prüfe daher anhand der gespeicherten Verbindung, ob der Upload einen bestehenden Client tatsächlich ersetzt hat.
Wähle für OAuth eine Registrierungsmethode, die dein Anbieter unterstützt.
| Registrierungsmethode | Erforderliche Angaben |
|---|---|
Registrierter Client (provided) |
Deklariere die Client-ID und die Authentifizierungsmethode für den Token-Endpunkt in mcp.json. Gib das Client-Secret bei Bedarf im Portal ein. |
Dynamische Clientregistrierung (dcr) |
Stelle einen Registrierungsendpunkt per Discovery bereit oder gib ihn mit registrationUrl explizit an. Nimm keine Client-Zugangsdaten in das Paket auf. |
Client Identifier Metadata Document (cimd) |
Lege die Präferenz für CIMD fest. Die Laufzeitumgebung kann gemäß ihrer Registrierungsrichtlinie auf DCR zurückgreifen. |
Gehe bei einem registrierten Client wie folgt vor.
- Registriere die Callback-URL, die beim Verbindungsaufbau verwendet wird, bei deinem OAuth-Anbieter.
- Öffne MCPs, wähle deinen Server und dann Verbinden.
- Gib das OAuth-Client-Secret ein, wenn dein Client ein Secret benötigt. Das Feld erscheint bei einem bereitgestellten OAuth-Client, sofern
tokenEndpointAuthMethodnicht auf"none"gesetzt ist. - Schließe bei Bedarf die Domainverifizierung ab, wähle Verbinden und autorisiere das Konto, über das die Verbindung zum Server hergestellt und der Server gescannt wird.
- Warte, bis der Scan abgeschlossen ist, und behebe alle gemeldeten Verbindungs- oder Tool-Probleme.
Trage das Client-Secret nicht in mcp.json ein. Das Manifest lässt clientSecret nicht zu. Mit dem Client-Secret authentifiziert sich deine OAuth-Anwendung. Es ist weder das Kontopasswort noch ein Zugriffstoken und dient auch nicht zur Anmeldung des Prüfteams.
Wenn OAuth-Discovery die erforderlichen Endpunkte nicht liefert, gib authorizationUrl und tokenUrl explizit in mcp.json an. Stelle sicher, dass die Client-ID, die Authentifizierungsmethode für den Token-Endpunkt, die Scopes und die Callback-URL mit der Konfiguration des Anbieters übereinstimmen.
Einschränkungen bei der Authentifizierung
Das Verbindungsformular im Portal unterstützt den Zugriff ohne Authentifizierung, den Zugriff mit OAuth und Kombinationen aus beiden. Das Manifest-Schema akzeptiert zwar die Authentifizierung per API-Schlüssel, doch im Portal gibt es dafür weder einen Verbindungsablauf noch ein Eingabefeld für Bearer-Token. Diese Einschränkung gilt auch für API-Schlüssel, die mit Basic-Authentifizierung oder einem benutzerdefinierten Header deklariert sind. Das Hochladen einer API-Schlüssel-Deklaration allein reicht nicht aus, um das MCP-Setup abzuschließen. Wende dich an OpenAI, wenn deine Einreichung diese Authentifizierungsmethode erfordert.
Hinterlege kein Token in den headers des Servers, um diese Einschränkung zu umgehen. Bei der Einreichung für das öffentliche Verzeichnis sind nicht leere Server-Header unzulässig. Konfiguriere einen geschützten Server nicht mit type: "none".
Das Schema akzeptiert private_key_jwt für einen bereitgestellten OAuth-Client. Dieser Wert allein konfiguriert jedoch keine Signaturschlüssel. Diese Anleitung für das Portal beschreibt das Setup der Signaturschlüssel nicht. Kläre das erforderliche Setup mit OpenAI, bevor du diese Methode für die Einreichung verwendest.
Details zur Domainverifizierung
Stelle für die Domainverifizierung das Challenge-Token unverändert als Klartext unter der im Portal angezeigten URL bereit.
https://<challenge-base-host>/.well-known/openai-apps-challenge
Gib ausschließlich das exakte Token zurück, weder JSON noch eine Liste von Tokens. Die Basis der Challenge muss ein HTTPS-Origin auf dem MCP-Hostnamen oder einer zulässigen übergeordneten Domain sein. Pfade werden ignoriert. Wenn ein anderes Plugin dieselbe Challenge-URL verwendet, nutze einen zulässigen übergeordneten Origin oder einen separaten Hostnamen, damit das Token des anderen Plugins erhalten bleibt. Wende dich an den Support, wenn beides nicht möglich ist.
3. Zur Prüfung einreichen
Sobald du die Ergebnisse der automatischen Prüfungen durchgesehen hast, ergänze die Angaben, die das Prüfteam zum Testen deines Plugins benötigt, und reiche den ausgewählten Entwurf ein. Schließe zuvor das erforderliche Setup ab und behebe Validierungsfehler. Andere Meldungen aus den automatischen Prüfungen kannst du dem Prüfteam zur Beurteilung vorlegen.
Angaben für die Prüfung vervollständigen
Für Plugins mit MCP-Verbindungen braucht das Prüfteam Angaben, mit denen es die Integration testen kann. Positive und negative Testfälle, die URL einer Videodemo und Versionshinweise kannst du in plugin.json aufnehmen. Sie werden dann mit der ZIP-Datei importiert. Sieh dir die Feldreferenz für Prüfung und Veröffentlichung und die vollständigen Metadatenbeispiele an. Plugin Creator im Plugin-Verzeichnis kann dir beim Zusammenstellen dieser Angaben helfen. Zugangsdaten für das Prüfteam gibst du separat unter Prüfdetails ein. Bereite die folgenden Unterlagen vor.
- Zugangsdaten für das Prüfteam, falls eine Anmeldung erforderlich ist. Stelle ein eigenes Testkonto, die Anmelde-URL, Angaben zum Workspace oder Mandanten und eine Anmeldeanleitung bereit. Verwende Beispieldaten und kein Konto einer echten Person. Das Konto braucht die für deine Testfälle erforderlichen Berechtigungen und Daten. Es sollte sofort nutzbar sein, ohne MFA-Freigabe, E-Mail- oder SMS-Codes, Magic Links oder Zugriff auf ein privates Netzwerk.
- Fünf positive Testfälle. Beschreibe das Szenario, den Nutzer-Prompt, die erwarteten Tools und das erwartete Ergebnis. Führe vor dem Einreichen jeden Testfall mit dem Testkonto aus.
- Drei negative Testfälle. Gib einen Prompt oder ein Szenario an, bei dem das Plugin nicht tätig werden soll. Erkläre, warum es die Anfrage nicht ausführen soll und welche Ablehnung, Rückfrage oder sichere Alternative du erwartest.
- Eine Videodemo. Zeige die Testfälle und die Funktionen des Plugins. Stelle eine erreichbare URL zur Aufzeichnung bereit.
- Versionshinweise. Fasse zusammen, welche Paketversion du einreichst und was sich geändert hat.
Öffne unter Metadaten & Skills den Bereich Prüfinformationen → Prüfdetails, um die importierten Unterlagen zu prüfen und die Zugangsdaten für das Prüfteam einzugeben. Fülle die bearbeitbaren Felder aus und wähle Details speichern. Bei Feldern, die laut Kennzeichnung über die Plugin-ZIP-Datei verwaltet werden, ergänzt oder änderst du die Angaben im Paket und lädst es erneut hoch. Auch die Verfügbarkeit nach Land und die Übersetzungen kannst du in den Paketmetadaten angeben. Prüfe gegebenenfalls die importierten Einstellungen. Welche Felder unterstützt werden und wie der Import funktioniert, erfährst du unter Angaben für Einreichung und Prüfung automatisch bereitstellen.

Prüfdetails. Prüfe die aus deiner ZIP-Datei importierten Testfälle und Unterlagen. Gib die privaten Zugangsdaten für das Prüfteam separat ein.
Die Zugangsdaten bleiben außerhalb des öffentlichen Pakets. Halte das Testkonto und die Beispieldaten für spätere Prüfungen verfügbar. Wenn sich die Zugangsdaten oder die Anmeldeschritte ändern, reiche einen aktualisierten Entwurf mit den neuen Angaben ein.
Entwurf einreichen
Wähle den Entwurf und dann Zur Prüfung einreichen. Gib die erforderlichen Bestätigungen zu den Richtlinien ab. Nach dem Einreichen kannst du den Fortschritt auf der Seite „Plug-ins“ unter Prüfstatus verfolgen. Rückmeldungen des Prüfteams erhältst du per E-Mail.

Zur Prüfung einreichen. Gib die erforderlichen Bestätigungen ab und reiche den ausgewählten Entwurf zur Prüfung ein.
Pro Plugin kann nur eine Prüfung gleichzeitig laufen. Wenn du ein Paket während der Prüfung ersetzen möchtest, warte vor dem Hochladen die Entscheidung ab oder brich die Prüfung ab. Wurde das Paket abgelehnt, berücksichtige die Rückmeldung und reiche eine korrigierte ZIP-Datei ein.
Wenn das Prüfteam deine Einreichung ablehnt, findest du den Grund in der E-Mail zur Ablehnung. Um Einspruch einzulegen, antworte auf diese E-Mail und erkläre, warum das Team die Entscheidung noch einmal prüfen sollte.
4. Genehmigtes Plugin veröffentlichen
Sobald dein Plugin genehmigt ist, entscheidest du, wann es verfügbar sein soll. Öffne die genehmigte Paketversion und wähle Plugin veröffentlichen. Wenn du eine Aktualisierung veröffentlichst, ersetzt sie die vorherige Paketversion.
Veröffentlichtes Plugin aktualisieren
Um Metadaten, Assets oder mitgelieferte Skills zu aktualisieren, lade eine neue ZIP-Datei für das bestehende Plugin hoch. Dadurch entsteht eine neue Paketversion, die separat geprüft wird und für die das Prüfteam eine eigene Entscheidung trifft. Änderungen an gehosteten Tools werden separat über MCP-Scans geprüft. Dafür musst du kein Paket hochladen.
Wenn du dein Plugin über das frühere Einreichungsformular eingereicht hast, lade zunächst das bestehende Plugin als ZIP-Datei herunter. Öffne das Plugin, wähle die veröffentlichte Paketversion und dann Release-ZIP herunterladen im Menü …. Wenn du das Paket bereits lokal pflegst, kannst du diese Quelldateien verwenden.
- Aktualisiere den Paketinhalt und die Versionsnummer. Erstelle dann eine vollständige ZIP-Datei mit allen Komponenten, die du beibehalten möchtest.
- Öffne das bestehende Plugin und wähle Plugin hochladen, um Änderungen vorzunehmen.
- Vergewissere dich unter Metadaten & Skills, dass die richtige Paketversion ausgewählt ist. Prüfe die neuen automatischen Meldungen und behebe alle Probleme, die einer Einreichung entgegenstehen.
- Schließe die für dein Paket erforderlichen Prüfschritte ab und veröffentliche die genehmigte Paketversion.
Verwende dasselbe Plugin, wenn du Skills hinzufügst oder entfernst. Wenn du die URL eines bestehenden MCP-Servers ändern möchtest, wende dich an den Support. Der aktuelle Aktualisierungsablauf unterstützt keine URL-Änderungen.
MCP-Server aktualisieren
Nach der ersten Veröffentlichung scannt OpenAI deinen gehosteten MCP-Server täglich. Aktualisierungen, die dafür infrage kommen, werden verfügbar, sobald sie die automatischen Prüfungen bestanden haben. Dafür brauchst du weder eine neue Paketversion noch einen separaten Veröffentlichungsschritt. Du kannst auch direkt nach dem Bereitstellen von Serveränderungen einen Scan anfordern.
Neueste Änderungen scannen
- Stelle die Änderungen auf deinem MCP-Server bereit.
- Öffne das bestehende Plugin, wähle MCPs und dann den verbundenen Server.
- Wähle unter Probleme die Option Erneut scannen.
- Warte, bis der Scan abgeschlossen ist, und prüfe die Ergebnisse und die Verfügbarkeit der Tools.

Übersicht der MCP-Scans. Starte nach Serveränderungen einen neuen Scan. Prüfe dann die Ergebnisse und die Verfügbarkeit der einzelnen Tools.
Ein erneuter Scan ist möglicherweise nicht verfügbar, wenn bereits ein Scan läuft, ein Einspruch bearbeitet wird oder das Plugin die Voraussetzungen für einen Scan nicht erfüllt.
Tool-Probleme finden und beheben
- Öffne Probleme und wähle ein betroffenes Tool aus.
- Lies die Angaben unter Erkannte Probleme. Unter Zurückgehaltene Aktualisierung siehst du, welche Metadaten geprüft wurden. Aktive Definition zeigt die derzeit verwendeten Metadaten.
- Wähle Probleme kopieren, um die Meldungen in deiner Entwicklungsumgebung zu bearbeiten.
- Korrigiere die Tool-Metadaten oder die Implementierung auf deinem Server und stelle die Änderungen bereit.
- Kehre zu Probleme zurück, wähle Erneut scannen und prüfe die aktualisierten Ergebnisse.
Tipp: Bitte Codex oder ChatGPT, deinen MCP-Server und die kopierte Fehlermeldung zu prüfen, das Problem zu erklären und eine Lösung vorzuschlagen.
Änderungen an Tools werden unabhängig voneinander bewertet. Eine beanstandete Änderung blockiert nicht zwangsläufig andere Tool-Aktualisierungen, die die Voraussetzungen erfüllen. Neue Tools sind erst nach der Genehmigung verfügbar. Wird eine Aktualisierung zurückgehalten, verwenden bestehende Tools weiterhin die zuvor genehmigten Metadaten. Das Entfernen eines Tools wird nach einem Scan wirksam.
Halte deinen MCP-Server mit den aktuell genehmigten Tool-Schemas kompatibel, bis die aktualisierten Metadaten aktiv sind.
Einspruch gegen ein automatisches Prüfergebnis einlegen
Wenn du eine Meldung zu einem Tool für fehlerhaft hältst, wähle Einspruch einlegen und erkläre, warum das Prüfteam die Ergebnisse erneut beurteilen sollte. Das Team prüft die bei diesem Scan zurückgehaltenen Tool-Änderungen gemeinsam. Ist die Meldung berechtigt, geht es meist schneller, das Problem auf dem Server zu beheben und einen neuen Scan zu starten.

Einspruch bei MCP-Prüfungen. Erkläre, warum das Prüfteam das automatische Prüfergebnis erneut beurteilen sollte.
Während eines Einspruchs sind automatische MCP-Aktualisierungen ausgesetzt. Wenn du Änderungen vornehmen möchtest, wähle Einspruch zurückziehen, aktualisiere den Server und starte einen neuen Scan. Ein Einspruch bezieht sich auf zurückgehaltene Tool-Änderungen. Paketänderungen, Authentifizierung und gemeinsame Serveranweisungen sind davon ausgenommen.
Hilfe bei Problemen findest du unter Fehler bei der Einreichung. Gib deine Plugin-ID an, wenn du den Support kontaktierst.
Angaben für Einreichung und Prüfung automatisch bereitstellen
Du kannst Angaben zum Verzeichniseintrag, zur Prüfung und zur Veröffentlichung im Plugin-Manifest hinterlegen. Beim Hochladen der ZIP-Datei werden sie dann automatisch übernommen. Die folgende Referenz beschreibt die unterstützten Felder und wie ihre Werte beim Upload übernommen werden. Für jedes Paketformat gibt es ein Beispiel.
Plugin-ZIP-Pakete mit App-Verweisen (apps / .app.json) oder Lifecycle-Hooks lassen sich derzeit nicht einreichen. Deklariere MCP-Server-URLs in deiner MCP-Konfiguration und schließe das Setup im Dashboard ab.
Entferne Lifecycle-Hooks, bevor du dein Plugin für das öffentliche Verzeichnis einreichst. Wenn dein Plugin auf Lifecycle-Hooks angewiesen ist, stelle es so bereit, dass es sich manuell in der Desktop-Version von Codex installieren lässt.
Vollständige Metadatenbeispiele
Die Beispiele beschreiben dasselbe fiktive Notiz-Plugin in beiden Formaten. Kopiere das Manifest für dein Format. Ersetze anschließend die Angaben zur Person oder Organisation, die das Plugin veröffentlicht, die URLs, Tool-Namen, Testfälle, Übersetzungen und die Länderauswahl durch deine tatsächlichen Werte. Die Beispieltestfälle wurden nicht mit einem echten Dienst ausgeführt.
Nimm die im Manifest referenzierten Dateien in dein Paket auf.
skills/get-started/SKILL.mdmit gültigen Angaben in den Feldern name und description im YAML-Header.- Die vier Symboldateien unter
assets/. - Genau einen Remote-MCP-Server namens notes. Konfiguriere ihn für Agent Plugins in
mcp.jsonoder für Codex in.mcp.json. Verwende die jeweils passende Konfiguration unten.
Verwende für deine Demo und die Anhänge zur Prüfung eigene, erreichbare URLs. Die Links auf example.com veranschaulichen das erwartete Format und führen nicht zu verwendbaren Prüfunterlagen. Wenn dein Plugin nur Skills enthält, lass review und die MCP-Konfiguration weg. Lass im Codex-Manifest auch mcpServers weg.
Verwende für das Beispiel im Format Agent Plugins diese zugehörige mcp.json.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://example.com/mcp"
}
}
}
Speichere für das Codex-Beispiel die folgende Konfiguration als .mcp.json im Stammverzeichnis des Plugins. Dieses Format enthält kein Schema für Agent Plugins.
{
"mcpServers": {
"notes": {
"url": "https://example.com/mcp"
}
}
}
Format für Agent Plugins
Speichere dieses vollständige Manifest als plugin.json im Stammverzeichnis des Plugins.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "acme-notes",
"version": "1.0.0",
"description": "Search and summarize notes from your Acme workspace.",
"author": {
"name": "Acme",
"email": "support@example.com",
"url": "https://example.com"
},
"homepage": "https://example.com/notes",
"repository": "https://github.com/example/acme-notes",
"license": "MIT",
"keywords": ["notes", "search", "productivity"],
"extensions": {
"com.openai": {
"interface": {
"displayName": "Acme Notes",
"shortDescription": "Find and summarize your notes",
"longDescription": "Search notes in your Acme workspace, open matching notes, and summarize decisions with links to the source. Acme Notes only accesses notes available to your connected account.",
"developerName": "Acme",
"category": "Productivity",
"capabilities": ["Search notes", "Read notes"],
"websiteURL": "https://example.com/notes",
"supportURL": "https://example.com/support",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": [
"Find my notes about the launch.",
"Summarize the decisions in my launch notes.",
"Open the project kickoff notes."
],
"brandColor": "#2357C6",
"brandColorDark": "#8CB4FF",
"composerIcon": "./assets/icon.png",
"composerIconDark": "./assets/icon-dark.png",
"logo": "./assets/logo.png",
"logoDark": "./assets/logo-dark.png"
},
"onboardingSkill": "./skills/get-started/SKILL.md",
"review": {
"test_cases": {
"positive": [
{
"description": "Find notes by topic",
"prompt": "Find my notes about the launch.",
"tools_triggered": "search_notes",
"expected_behavior": "Return accessible notes about the launch with source links.",
"file_attachment_urls": [
"https://example.com/review/launch-brief.pdf"
],
"expected_output_url": "https://example.com/review/launch-results"
},
{
"description": "Open a matching note",
"prompt": "Open the project kickoff notes.",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "Find the kickoff note and return its content with a source link."
},
{
"description": "Summarize decisions",
"prompt": "Summarize decisions in my launch notes.",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "Summarize decisions from accessible notes and cite the sources."
},
{
"description": "Find action items",
"prompt": "What action items are in my kickoff notes?",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "List the action items recorded in the notes without inventing owners or deadlines."
},
{
"description": "Handle no matches",
"prompt": "Find my notes about Project Northstar.",
"tools_triggered": "search_notes",
"expected_behavior": "Report that no matching notes were found in the test workspace."
}
],
"negative": [
{
"description": "Unsupported payment",
"prompt": "Transfer $100 to another account."
},
{
"description": "Unsupported deletion",
"prompt": "Delete all my notes."
},
{
"description": "Access outside the connected account",
"prompt": "Show notes from a workspace I cannot access."
}
]
},
"demo_recording_url": "https://example.com/review/acme-notes-demo",
"commerce": false,
"commerce_description": "This plugin does not sell products or process payments."
},
"publication": {
"countries": ["US", "GB"],
"release_notes": "Initial release with note search, reading, and summaries.",
"translations": {
"fr-FR": {
"subtitle": "Retrouvez et résumez vos notes",
"description": "Recherchez des notes dans votre espace Acme, ouvrez les résultats et résumez les décisions avec des liens vers les sources. Acme Notes accède uniquement aux notes disponibles pour votre compte connecté."
},
"ja-JP": {
"subtitle": "ノートを検索して要約",
"description": "Acmeワークスペース内のノートを検索し、該当するノートを開き、参照元へのリンク付きで決定事項を要約します。Acme Notesは、接続されたアカウントで閲覧できるノートにのみアクセスします。"
}
}
}
}
}
}
Codex-Format
Speichere dieses vollständige Manifest als .codex-plugin/plugin.json. Die Felder für die Darstellung stehen hier im Objekt interface auf der obersten Ebene. Die Angaben zu den ersten Schritten, zur Prüfung und zur Veröffentlichung bleiben unter extensions.com.openai.
{
"name": "acme-notes",
"version": "1.0.0",
"description": "Search and summarize notes from your Acme workspace.",
"author": {
"name": "Acme",
"email": "support@example.com",
"url": "https://example.com"
},
"homepage": "https://example.com/notes",
"repository": "https://github.com/example/acme-notes",
"license": "MIT",
"keywords": ["notes", "search", "productivity"],
"skills": "./skills/",
"mcpServers": "./.mcp.json",
"interface": {
"displayName": "Acme Notes",
"shortDescription": "Find and summarize your notes",
"longDescription": "Search notes in your Acme workspace, open matching notes, and summarize decisions with links to the source. Acme Notes only accesses notes available to your connected account.",
"developerName": "Acme",
"category": "Productivity",
"capabilities": ["Search notes", "Read notes"],
"websiteURL": "https://example.com/notes",
"supportURL": "https://example.com/support",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": [
"Find my notes about the launch.",
"Summarize the decisions in my launch notes.",
"Open the project kickoff notes."
],
"brandColor": "#2357C6",
"brandColorDark": "#8CB4FF",
"composerIcon": "./assets/icon.png",
"composerIconDark": "./assets/icon-dark.png",
"logo": "./assets/logo.png",
"logoDark": "./assets/logo-dark.png"
},
"extensions": {
"com.openai": {
"onboardingSkill": "./skills/get-started/SKILL.md",
"review": {
"test_cases": {
"positive": [
{
"description": "Find notes by topic",
"prompt": "Find my notes about the launch.",
"tools_triggered": "search_notes",
"expected_behavior": "Return accessible notes about the launch with source links.",
"file_attachment_urls": [
"https://example.com/review/launch-brief.pdf"
],
"expected_output_url": "https://example.com/review/launch-results"
},
{
"description": "Open a matching note",
"prompt": "Open the project kickoff notes.",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "Find the kickoff note and return its content with a source link."
},
{
"description": "Summarize decisions",
"prompt": "Summarize decisions in my launch notes.",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "Summarize decisions from accessible notes and cite the sources."
},
{
"description": "Find action items",
"prompt": "What action items are in my kickoff notes?",
"tools_triggered": "search_notes, read_note",
"expected_behavior": "List the action items recorded in the notes without inventing owners or deadlines."
},
{
"description": "Handle no matches",
"prompt": "Find my notes about Project Northstar.",
"tools_triggered": "search_notes",
"expected_behavior": "Report that no matching notes were found in the test workspace."
}
],
"negative": [
{
"description": "Unsupported payment",
"prompt": "Transfer $100 to another account."
},
{
"description": "Unsupported deletion",
"prompt": "Delete all my notes."
},
{
"description": "Access outside the connected account",
"prompt": "Show notes from a workspace I cannot access."
}
]
},
"demo_recording_url": "https://example.com/review/acme-notes-demo",
"commerce": false,
"commerce_description": "This plugin does not sell products or process payments."
},
"publication": {
"countries": ["US", "GB"],
"release_notes": "Initial release with note search, reading, and summaries.",
"translations": {
"fr-FR": {
"subtitle": "Retrouvez et résumez vos notes",
"description": "Recherchez des notes dans votre espace Acme, ouvrez les résultats et résumez les décisions avec des liens vers les sources. Acme Notes accède uniquement aux notes disponibles pour votre compte connecté."
},
"ja-JP": {
"subtitle": "ノートを検索して要約",
"description": "Acmeワークスペース内のノートを検索し、該当するノートを開き、参照元へのリンク付きで決定事項を要約します。Acme Notesは、接続されたアカウントで閲覧できるノートにのみアクセスします。"
}
}
}
}
}
}
Wähle die Struktur, die zu deinem Paket passt.
| Metadaten | Agent Plugins: plugin.json im Stammverzeichnis | Codex: .codex-plugin/plugin.json |
|---|---|---|
| Paketidentität und Angaben zur veröffentlichenden Person oder Organisation | Felder auf der obersten Ebene | Felder auf der obersten Ebene |
| Text des Verzeichniseintrags, Links, Prompts und Bilder | extensions.com.openai.interface |
interface |
| Skill für die ersten Schritte | extensions.com.openai.onboardingSkill | extensions.com.openai.onboardingSkill |
| Angaben zur Prüfung und Veröffentlichung | extensions.com.openai.review und extensions.com.openai.publication | extensions.com.openai.review und extensions.com.openai.publication |
Bei Paketen im Format Agent Plugins trägst du OpenAI-spezifische Einstellungen in plugin.json unter extensions.com.openai ein. Wenn dieses Objekt vorhanden ist, ignoriert OpenAI die Einstellungen in .codex-plugin/plugin.json. Die beiden Dateien werden nicht zusammengeführt. Fehlt das Objekt, liest OpenAI diese Einstellungen aus .codex-plugin/plugin.json. Die Paketidentität stammt weiterhin aus der plugin.json im Stammverzeichnis, die Skills aus skills/ und die MCP-Server aus mcp.json.
Verwende die vollständigen Metadatenbeispiele als Ausgangspunkt. Wenn das Entwickler-Dashboard eine fehlende URL zur Datenschutzrichtlinie, eine fehlende Support-URL oder ein fehlendes App-Symbol meldet, findest du das zugehörige Manifestfeld in der Feldreferenz.
Manifestfelder
Die Spalte „Anforderung“ unterscheidet zwischen Anforderungen des Paketformats und Anforderungen für die Einreichung. Angaben zur Prüfung sind in der ZIP-Datei optional. Vor dem Einreichen müssen alle erforderlichen Unterlagen vorliegen.
Paketidentität und Komponenten
Diese Felder beschreiben das Paket selbst. Lege sie in beiden Manifestformaten auf der obersten Ebene ab, sofern die Tabelle kein OpenAI-Erweiterungsfeld angibt.
| Feld | Anforderung | Wert und Verwendung |
|---|---|---|
$schema |
Für Agent Plugins erforderlich, für Codex weglassen | Für das portable Format ist https://agent-plugins.org/schemas/1.0.0/plugin.schema.json erforderlich. Lass das Feld in einem eigenständigen Codex-Kompatibilitätsmanifest weg. |
name |
Erforderlich | Stabile Kennung mit höchstens 64 Zeichen. Verwende für Pakete, die du einreichen möchtest, Kleinbuchstaben, Ziffern und einzelne Bindestriche. Halte die Kennung vom Anzeigenamen getrennt. |
version |
Für Codex erforderlich, im portablen Schema optional | Versionsnummer, etwa 1.0.0. Im portablen Schema ist sie optional. Gib für Einreichungen und Aktualisierungen ausdrücklich eine semantische Versionsnummer an. Im Codex-Format ist sie erforderlich. |
description |
Für Codex erforderlich, für Agent Plugins optional | Kurzbeschreibung des Pakets mit höchstens 4000 Zeichen. Im portablen Schema ist sie optional, im Codex-Format erforderlich. |
author |
Für Codex erforderlich, für Agent Plugins optional | Objekt mit Angaben zur veröffentlichenden Person oder Organisation. Es enthält den Namen. Eine E-Mail-Adresse und eine url mit HTTPS sind optional. Im portablen Schema kannst du das Objekt weglassen. Das Codex-Format erfordert author.name. Der Name darf höchstens 120 Zeichen lang sein, die E-Mail-Adresse 320 und die URL 2048. |
homepage |
Optional | Optionale HTTPS-Startseite des Projekts mit höchstens 2048 Zeichen. Lege interface.websiteURL für den Verzeichniseintrag separat fest. |
repository |
Optional | Optionale URL des Quellcode-Repositorys. |
license |
Optional | Optionale Lizenzkennung, etwa MIT. |
keywords |
Optional | Optionales Array mit Suchbegriffen, über die sich das Plugin finden lässt. |
extensions |
Optional | Nach Namensraum gruppierte Einstellungen. Lege OpenAI-spezifische Einstellungen unter com.openai ab. |
skills |
Für Codex-Pakete mit Skills | Gib nur bei Codex einen relativen Pfad zu einem Verzeichnis mit Skills oder ein Array solcher Pfade an, etwa "./skills/". Portable Pakete erkennen skills/ automatisch. |
mcpServers |
Für Codex-Pakete mit MCP-Servern | Gib nur bei Codex "./.mcp.json" für die mitgelieferte MCP-Serverkonfiguration an. Portable Pakete erkennen mcp.json im Stammverzeichnis automatisch. |
Lege die folgenden zusätzlichen Einstellungen bei portablen Paketen unter extensions.com.openai ab. In einem Codex-Kompatibilitätsmanifest gehören sie auf die oberste Ebene.
| Feld | Anforderung | Wert und Verwendung |
|---|---|---|
interface |
Für Codex erforderlich, für Agent Plugins optional | Objekt für die Darstellung, beschrieben unter Metadaten für den Verzeichniseintrag. Das Codex-Format erfordert dieses Objekt. Bei portablen Paketen lassen sich grundlegende Texte aus den Metadaten der obersten Ebene ableiten. |
id |
Optional | Optionale Kennung für verwaltete Plugin-Kataloge. Behalte einen bereits zugewiesenen Wert bei. Bei ZIP-Uploads wird die Plugin-Identität aus dem Dashboard verwendet. |
Bei portablen Paketen werden Skills immer in skills/ und MCP-Server in mcp.json ermittelt. Eine Deklaration von skills oder mcpServers in der eingebetteten Erweiterung oder der ergänzenden Kompatibilitätskonfiguration kann diese Komponenten weder ersetzen noch deaktivieren oder ergänzen. Solche Deklarationen gelten nur für Pakete ohne erkanntes portables Manifest im Stammverzeichnis.
Metadaten für den Verzeichniseintrag
Lege die folgenden Felder bei Agent Plugins unter extensions.com.openai.interface und beim Codex-Format unter interface ab. Die hier genannten Grenzwerte gelten für die Einreichung ins öffentliche Verzeichnis. Beim Hochladen eines Pakets sind längere Entwurfstexte möglich. Ein erfolgreicher Upload bedeutet daher noch nicht, dass der Verzeichniseintrag zur Einreichung bereit ist.
| Feld | Anforderung | Typ | Wert und Grenzwert für die Einreichung |
|---|---|---|---|
displayName |
Erforderlich | Zeichenfolge | Öffentlich angezeigter Name. Erforderlich, höchstens 30 Zeichen. |
shortDescription |
Erforderlich | Zeichenfolge | Untertitel, der zusammen mit dem Namen angezeigt wird. Erforderlich, höchstens 30 Zeichen. |
longDescription |
Erforderlich | Zeichenfolge | Beschreibung der Aufgaben, Zielgruppe und Einschränkungen. Erforderlich, höchstens 4000 Zeichen. |
developerName |
Erforderlich | Zeichenfolge | Name der veröffentlichenden Person oder Organisation. Erforderlich, höchstens 80 Zeichen. Der im Verzeichnis angezeigte Name wird automatisch aus der ausgewählten verifizierten Entwickleridentität übernommen. |
category |
Erforderlich | Zeichenfolge | Erforderlicher Kategoriename aus dem Dashboard, etwa Productivity oder Developer Tools. |
capabilities |
Für Codex erforderlich, für Agent Plugins optional | Array von Zeichenfolgen | Bis zu 20 Funktionsbezeichnungen mit jeweils höchstens 120 Zeichen. Im Codex-Format erforderlich. Verwende [], wenn es keine gibt. |
websiteURL |
Für die MCP-Prüfung erforderlich | Zeichenfolge | HTTPS-URL der Produktwebsite, höchstens 1024 Zeichen. |
supportURL |
Für die MCP-Prüfung erforderlich | Zeichenfolge | HTTPS-URL der Supportseite, höchstens 1024 Zeichen. |
privacyPolicyURL |
Für die MCP-Prüfung erforderlich | Zeichenfolge | HTTPS-URL der Datenschutzrichtlinie, höchstens 1024 Zeichen. |
termsOfServiceURL |
Für die MCP-Prüfung erforderlich | Zeichenfolge | HTTPS-URL der Nutzungsbedingungen, höchstens 1024 Zeichen. |
defaultPrompt |
Optional | Zeichenfolge oder Array von Zeichenfolgen | Bis zu drei Prompts für den Einstieg mit jeweils höchstens 128 Zeichen. Verwende unterschiedliche Prompts ohne @Erwähnungen von Apps. Gib mehrere Prompts als Array an. |
brandColor |
Optional | Zeichenfolge | Farbe für das helle Design im Format #RRGGBB mit einem Kontrastverhältnis von mindestens 2:1 zu Weiß. |
brandColorDark |
Optional | Zeichenfolge | Farbe für das dunkle Design im Format #RRGGBB mit einem Kontrastverhältnis von mindestens 2:1 zu #212121. Wenn du nur brandColor angibst, wird daraus eine Farbe für das dunkle Design abgeleitet. |
composerIcon |
Für Codex erforderlich | Zeichenfolge | Relativer Pfad zum Symbol im Editor. |
composerIconDark |
Optional | Zeichenfolge | Optionaler relativer Pfad zur Variante des Symbols für das dunkle Design. |
logo |
Für Codex erforderlich. Für die Einreichung ist ein Hauptsymbol erforderlich. | Zeichenfolge | Relativer Pfad zum Hauptsymbol des Verzeichniseintrags. |
logoDark |
Optional | Zeichenfolge | Optionaler relativer Pfad zur Variante des Hauptsymbols für das dunkle Design. |
Für eine verknüpfte MCP-App, die vor der Veröffentlichung geprüft werden muss, sind alle vier URLs des Verzeichniseintrags erforderlich: websiteURL, supportURL, privacyPolicyURL und termsOfServiceURL. Verwende HTTPS-URLs ohne eingebettete Zugangsdaten. Bei der Metadatenvalidierung für Plugins, die nur Skills enthalten, sind nicht alle vier URLs erforderlich. Die Paketfelder homepage und author.url füllen diese Felder des Verzeichniseintrags nicht automatisch aus.
Symbole
Nimm logo und composerIcon in Pakete auf, die du zur Weitergabe vorbereitest. Die Codex-Paketvalidierung erfordert beide Felder. Ein portables Paket kannst du ohne sie hochladen, doch vor der Einreichung verlangt das Dashboard ein Hauptsymbol für die App. Varianten für das dunkle Design sind optional. Um die Warnung „App-Symbol erforderlich“ zu beheben, füge logo und die zugehörige Bilddatei hinzu oder hinterlege das Symbol im Dashboard.
Verwende Pfade relativ zum Stammverzeichnis des Plugins, die mit ./ beginnen. Nimm jede referenzierte Datei in das Paket auf. Unterstützt werden PNG, JPEG, WebP und SVG mit jeweils höchstens 5 MiB. Symbole und Logos müssen quadratisch und mindestens 48 × 48 Pixel groß sein. Rasterbilder dürfen in der Breite und Höhe jeweils höchstens 4096 Pixel messen. Gib bei SVG-Symbolen numerische Maße für ein Quadrat oder eine quadratische viewBox von mindestens 48 × 48 an.
Erste Schritte, Prüfung und Veröffentlichung konfigurieren
Lege diese Objekte in beiden Formaten direkt unter extensions.com.openai ab. Im portablen Format stehen sie damit auf derselben Ebene wie interface. Verschachtle sie nicht innerhalb von interface.
Mit dem optionalen onboardingSkill kannst du einen Ablauf für das Setup bereitstellen, der sich nach der Installation ausführen lässt. Unter Skill für die ersten Schritte hinzufügen findest du ein Manifestbeispiel, die Pfadregeln und eine Erklärung dazu, wie das Setup eine neue oder bestehende Unterhaltung nutzt.
| Feld | Anforderung | Typ | Wert und Verwendung |
|---|---|---|---|
onboardingSkill |
Optional | Zeichenfolge | Relativer Pfad zur SKILL.md eines mitgelieferten Skills, etwa ./skills/get-started/SKILL.md. Der referenzierte Skill muss im Paket enthalten sein. |
review.test_cases.positive |
In der ZIP-Datei optional. Für die erste MCP-Prüfung sind fünf Fälle erforderlich. | Array von Objekten | Positive Testfälle für ein Plugin mit genau einem MCP-Server. Verwende die unten aufgeführten Felder für Testfälle. |
review.test_cases.negative |
In der ZIP-Datei optional. Für die erste MCP-Prüfung sind drei Fälle erforderlich. | Array von Objekten | Negative Testfälle für diesen Server. |
review.demo_recording_url |
In der ZIP-Datei optional, für die MCP-Prüfung erforderlich | Zeichenfolge | URL einer Videodemo, auf die das Prüfteam zugreifen kann. |
review.commerce |
Optional | Boolescher Wert | Gibt an, ob die App Handelsfunktionen unterstützt. Mit dieser Angabe stimmst du keinen rechtlichen Bedingungen zu. |
review.commerce_description |
Optional | Zeichenfolge | Erläuterung der Handelsfunktionen der App. |
publication.countries |
Optional | Array von Zeichenfolgen | Liste der Länder, in denen das Plugin verfügbar sein soll. Verwende anerkannte Ländercodes in Großbuchstaben, etwa US und GB. Lass das Feld weg, um die bestehende Länderauswahl beizubehalten. Mit [] hebst du Länderbeschränkungen auf. Die Einstellung gilt ab der Veröffentlichung, auch bei Plugins, die nur Skills enthalten. |
publication.release_notes |
Optional | Zeichenfolge | Hinweise zu den Änderungen in dieser Version. |
publication.translations |
Optional | Objekt oder null | Optionale Zuordnung von Gebietsschemakennungen zu übersetzten Texten für den Verzeichniseintrag. Siehe Text des Verzeichniseintrags übersetzen. |
publication.translations.<locale>.subtitle |
Optional | Zeichenfolge oder null | Optionaler übersetzter Untertitel mit bis zu 30 Zeichen. |
publication.translations.<locale>.description |
Optional | Zeichenfolge oder null | Optionale übersetzte Beschreibung mit bis zu 4000 Zeichen. |
Jedes Objekt in review.test_cases.positive oder review.test_cases.negative beschreibt einen Testfall.
| Feld | Anforderung | Typ | Wert und Verwendung |
|---|---|---|---|
description |
Erforderlich | Zeichenfolge | Erforderliche Beschreibung des zu prüfenden Verhaltens. Beschreibungen positiver Testfälle dürfen höchstens 4000 Zeichen umfassen. |
prompt |
Erforderlich | Zeichenfolge | Erforderlicher Nutzer-Prompt, den das Prüfteam ausprobieren kann. |
tools_triggered |
Für positive Testfälle erforderlich | Zeichenfolge | Namen der erwarteten Tools. Bei der Einreichung für positive Testfälle erforderlich. |
expected_behavior |
Für positive Testfälle erforderlich | Zeichenfolge | Erwartetes, beobachtbares Ergebnis. Bei der Einreichung für positive Testfälle erforderlich. |
file_attachment_urls |
Optional | Array von Zeichenfolgen | Optionale Links zu Dateien, die im Testfall verwendet werden. |
expected_output_url |
Optional | Zeichenfolge | Optionaler Link zu einem Beispiel für das erwartete Ergebnis, etwa zu einem Referenzdokument, mit dem das Prüfteam die tatsächliche Ausgabe vergleichen kann. |
Für die erste Prüfung einer MCP-App sind genau fünf positive und drei negative Testfälle erforderlich. Beim Hochladen sind unvollständige Listen zulässig. Vervollständige sie vor dem Einreichen. Bei mehreren MCP-Servern deklarierst du die Testfälle in der MCP-Konfiguration für jeden Server separat. Das Feld review.test_cases auf Plugin-Ebene setzt genau einen Server voraus und lässt sich nicht mit Testfalldeklarationen auf Serverebene kombinieren. Plugins, die nur Skills enthalten, benötigen weder Testfälle für die MCP-App-Prüfung noch eine Demoaufzeichnung.
Importierte Testfälle kannst du im Dashboard nur einsehen. Um sie zu ändern, bearbeite das Paket und lade es erneut hoch. Wenn du test_cases weglässt oder auf null setzt, bleiben die bestehenden Testfälle erhalten. Mit test_cases: {} leerst du beide Listen. Wenn du die Testfälle bei einem späteren Upload weglässt, werden sie dadurch im Dashboard nicht wieder bearbeitbar.
Bei den skalaren Prüffeldern und release_notes bleiben gespeicherte Werte erhalten, wenn du das Feld weglässt oder auf null setzt. Eine leere Zeichenfolge löscht den Text. Beim Einreichen werden explizit im Paket gesetzte Werte erneut übernommen. Wenn du einen im Dashboard bearbeiteten Wert verwenden möchtest, entferne die entsprechende skalare Deklaration aus dem Paket. Gemeinsame Prüffelder gelten für die MCP-App-Entwürfe des jeweiligen Plugins. Bei einem Plugin, das nur Skills enthält, bleiben die Versionshinweise im Paket und lösen keine App-Prüfung aus.
Lege commerce und commerce_description unter review ab, nicht unter publication. Nimm keine Zugangsdaten oder Anweisungen für das Prüfteam in das Paket auf. In den ZIP-Metadaten sind test_credentials und reviewer_instructions unzulässig. Gib die Zugangsinformationen für das Prüfteam über das sichere Formular im Dashboard ein.
Text des Verzeichniseintrags übersetzen
Füge in beiden Formaten unter extensions.com.openai.publication ein translations-Objekt hinzu, um übersetzte Untertitel und Beschreibungen bereitzustellen. Verwende als Schlüssel nicht leere Gebietsschemakennungen wie fr-FR oder ja-JP. Das Objekt für jedes Gebietsschema kann subtitle, description oder beide Felder enthalten. Du kannst jedes der beiden Felder weglassen oder auf null setzen. Auch translations kannst du weglassen oder auf null setzen.
Behalte in den Basisfeldern des Verzeichniseintrags den englischen Text bei. Eine Übersetzung für en-US ist nicht erforderlich und wird beim Import nicht erzeugt.
Übersetzte Untertitel müssen aus einer einzigen Zeile mit höchstens 30 Zeichen bestehen. Übersetzte Beschreibungen dürfen Zeilenumbrüche mit \n enthalten und bis zu 4000 Zeichen umfassen. Angegebene Texte dürfen nicht ausschließlich aus Leerraum bestehen und müssen unterstützte Textzeichen verwenden. Tabulatoren und andere nicht unterstützte Steuerzeichen werden abgewiesen. Für die Längenbegrenzung zählt der exakte Text einschließlich führender und nachgestellter Leerzeichen.
Die Übersetzungen werden beim Import validiert und bleiben auch nach Änderungen an den Metadaten im hochgeladenen Paket erhalten. Der Import ändert derzeit weder den Text im Plugin-Verzeichnis noch den Text, den die API für Verzeichniseinträge zurückgibt.