Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Änderungsprotokoll zur Plugin-Oberfläche

Aktuelle Änderungen an den Kompatibilitäts-APIs für Plugin-Oberflächen und an den ChatGPT-Erweiterungen.

August 2026

  • Stabile OAuth-Callbacks und CIMD-Client-IDs

    Fehlerbehebungen und Verbesserungen

    • ChatGPT-Apps können https://chatgpt.com/connector_platform_oauth_redirect als stabile OAuth-Callback-URL verwenden. Voraussetzung ist, dass die geschützte Ressource und die OAuth-Metadaten auf denselben Autorisierungsserver verweisen und dieser die Identifizierung des Ausstellers nach RFC 9207 unterstützt.

    • Apps, die Client ID Metadata Documents (CIMD) verwenden, können außerdem https://chatgpt.com/oauth/client.json als stabile Client-ID nutzen. Server ohne Unterstützung für die Identifizierung des Ausstellers verarbeiten Callbacks wie bisher. Mehr erfahren.

July 2026

  • Bisherige Metadaten zur Sichtbarkeit von Tools sind veraltet

    Fehlerbehebungen und Verbesserungen

    • _meta["openai/visibility"] ist jetzt als veraltet gekennzeichnet. Der Wert private verbirgt ein Tool vor dem Modell, lässt aber offen, ob es für die App sichtbar ist. Dadurch kann unklar bleiben, für wen das Tool bestimmt ist. Lege mit _meta.ui.visibility fest, ob ein Tool für das Modell, die App oder beide verfügbar ist.

June 2026

  • App-Berechtigungen in ChatGPT verwalten

    Fehlerbehebungen und Verbesserungen

    • In ChatGPT kannst du jetzt festlegen, ob verbundene Apps immer, vor jeder Änderung oder nur vor wichtigen Änderungen um Erlaubnis fragen. Mit einem persönlichen Konto kannst du das für alle Apps gemeinsam und für einzelne Apps einstellen. In ChatGPT Business und Enterprise legen Admins die Standardeinstellungen für den gesamten Workspace und für einzelne Apps fest.

May 2026

  • CSS-Variablen des Hosts für MCP Apps

    Fehlerbehebungen und Verbesserungen

    • Bei der Initialisierung stellt ChatGPT nun über hostContext.styles.variables standardisierte CSS-Variablen des Hosts für MCP Apps bereit. Wenn sich das Farbschema des Hosts ändert, aktualisiert ChatGPT die Variablen über ui/notifications/host-context-changed. So können Apps das helle oder dunkle Erscheinungsbild von ChatGPT übernehmen, ohne hostspezifische Farbwerte im Code festzulegen.

  • Änderungen am Lebenszyklus von Tools in MCP Apps

    Fehlerbehebungen und Verbesserungen

    • Wenn ChatGPT ein Widget startet, behält window.openai.toolResponseMetadata jetzt die kanonische Struktur des MCP-Tool-Ergebnisses einschließlich des verborgenen Felds _meta bei.

    • Bei Tools, die deine Genehmigung erfordern, übermittelt ChatGPT die Tool-Eingaben jetzt erst nach deiner Genehmigung über die Lebenszyklusbenachrichtigung ui/notifications/tool-input von MCP Apps an das Widget. Zuvor lud ChatGPT die Eingaben beim Start in die globalen Variablen des Widgets.

  • Anweisungen von MCP-Servern

    Fehlerbehebungen und Verbesserungen

    • ChatGPT liest jetzt die Anweisungen, die ein MCP-Server bei der Initialisierung zurückgibt. Zusammen mit den Tool-Metadaten nutzt ChatGPT sie, um zu verstehen, wie mehrere Tools in einem Ablauf zusammenwirken, welche Einschränkungen gelten und welche Hinweise für den gesamten Server relevant sind.

  • Beispiele für Ausgabeschemas

    Fehlerbehebungen und Verbesserungen

    • Die Dokumentation zur Plugin-Oberfläche und zum MCP-Server zeigt jetzt outputSchema in den Tool-Beispielen. Sie empfiehlt, für Tools, die strukturierte Inhalte zurückgeben, ein Ausgabeschema zu deklarieren.

March 2026

  • Hinweise zur Verteilung von Plugins

    Fehlerbehebungen und Verbesserungen

    • Freigegebene Integrationen für das Apps SDK ließen sich als Codex-Plugins verteilen. Zum Start waren Plugins nur in Codex verfügbar.

  • Hilfsfunktionen für die Dateibibliothek in window.openai

    Fehlerbehebungen und Verbesserungen

    • Mit window.openai.selectFiles() können Widgets vorhandene Dateien aus der persönlichen ChatGPT-Dateibibliothek auswählen, sofern die Bibliothek verfügbar ist.

    • Mit window.openai.uploadFile(file, { library: true }) können Widgets hochgeladene Dateien in der persönlichen ChatGPT-Dateibibliothek speichern, sofern die Bibliothek verfügbar ist.

  • Dateien in anderen Formaten als Bildformaten hochladen

    Fehlerbehebungen und Verbesserungen

    • window.openai.uploadFile unterstützt jetzt neben Bilddateien auch andere Dateitypen.

February 2026

  • Kompatibilität mit MCP Apps

  • Neuerungen in der Plugin-Oberfläche für Weiterleitungen, Widget-Beschreibungen und das Scrollen bei Folgenachrichten

    Fehlerbehebungen und Verbesserungen

    • window.openai.openExternal({ href, redirectUrl }) unterstützt redirectUrl: false. Damit verhinderst du, dass der Host ?redirectUrl=... an externe Links anhängt.

    • Verwende die dafür vorgesehene Methode window.openai.setOpenInAppUrl({ href }), um das Ziel von „In öffnen“ im Vollbildmodus zu ändern. Ohne diesen Aufruf öffnet ChatGPT weiterhin den aktuellen iframe-Pfad des Widgets.

    • Wenn openai/widgetDescription angegeben ist, hat der Wert beim Erstellen der Ressource Vorrang vor resource.description.

    • window.openai.sendFollowUpMessage unterstützt den Parameter scrollToBottom. Der Standardwert ist true. Mit false deaktivierst du das automatische Scrollen ans Ende.

January 2026

  • Hinweise zur Kompatibilität mit Unternehmenswissen

  • Sitzungsmetadaten für Tool-Aufrufe und Vorlagenwechsel mit requestModal

    Fehlerbehebungen und Verbesserungen

    • Tool-Aufrufe enthalten jetzt unter _meta["openai/session"] eine anonymisierte Gesprächs-ID. Damit kannst du Anfragen innerhalb einer ChatGPT-Sitzung miteinander in Beziehung setzen.

    • Mit window.openai.requestModal({ template }) kannst du jetzt eine andere registrierte UI-Vorlage öffnen, indem du die Vorlagen-URI aus registerResource übergibst.

November 2025