For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme
概要 ChatGPT と Codex のユーザー向けドキュメント ユースケース

プラグイン UI の変更履歴

プラグイン UI の互換性 API と ChatGPT の拡張機能に関する最新情報です。

August 2026

  • 固定の OAuth コールバック URL と CIMD クライアント ID

    修正と改善

    • ChatGPT アプリでは、次の 2 つの条件を満たすと、固定の OAuth コールバック URL https://chatgpt.com/connector_platform_oauth_redirect を使用できます。保護対象リソースのメタデータと OAuth メタデータが同じ認可サーバーを示し、そのサーバーが RFC 9207 に基づく発行者の識別に対応している必要があります。

    • クライアント ID メタデータドキュメント(CIMD)を使用するアプリでは、https://chatgpt.com/oauth/client.json も固定のクライアント ID として使用できます。発行者の識別に対応していないサーバーでは、コールバックは従来どおり動作します。詳しくはこちら。

July 2026

  • ツールの公開範囲を指定する旧メタデータの非推奨化

    修正と改善

    • _meta["openai/visibility"] を非推奨としました。値を private にすると、モデルからはツールが見えなくなりますが、アプリに公開するかどうかは指定されないため、想定する公開先が曖昧になることがあります。_meta.ui.visibility を使用して、ツールをモデルのみ、アプリのみ、またはその両方に公開するかを指定してください。

June 2026

  • ChatGPT のアプリ権限設定

    修正と改善

    • ChatGPT ユーザーは、接続済みのアプリが許可を求めるタイミングを「毎回」「変更を加える前」「重要な変更を加える前のみ」の 3 通りから選べるようになりました。個人アカウントでは、全アプリ共通の設定とアプリごとの設定を指定できます。Business と Enterprise の管理者は、ワークスペース全体とアプリごとの既定値を管理できます。

May 2026

  • MCP Apps のホストスタイル変数

    修正と改善

    • ChatGPT は、初期化時に hostContext.styles.variables を通じて、MCP Apps で標準化されたホストの CSS 変数を提供するようになりました。ホストのテーマが変わると、ChatGPT は ui/notifications/host-context-changed を通じて変数の値を更新します。これにより、ホスト固有の色をハードコードせずに、アプリの配色を ChatGPT のライトテーマとダークテーマに合わせられます。

  • MCP Apps のツールライフサイクルの変更点

    修正と改善

    • ChatGPT がウィジェットを起動するとき、window.openai.toolResponseMetadata は、非表示の _meta を含め、MCP のツール結果を標準のエンベロープ形式のまま保持するようになりました。

    • ユーザーの承認が必要なツールでは、ChatGPT はツールの入力をウィジェットの初期グローバル変数にあらかじめ読み込む代わりに、承認後に MCP Apps のライフサイクル通知 ui/notifications/tool-input を通じてウィジェットに渡すようになりました。

  • MCP サーバーからの指示

    修正と改善

    • ChatGPT は、初期化時に MCP サーバーが返す指示を読み取るようになりました。ツールのメタデータとあわせてこれらの指示を参照し、複数のツールにまたがるワークフローや制約、サーバー全体に適用される指針を把握します。

  • 出力スキーマの例

    修正と改善

    • プラグイン UI と MCP サーバーのドキュメントに、outputSchema を使ったツールの例を追加しました。構造化コンテンツを返すツールでは、出力スキーマの宣言を推奨しています。

March 2026

  • プラグイン配布ガイド

    修正と改善

    • 承認済みの Apps SDK 連携機能を Codex プラグインとして配布できるようになりました。提供開始時点では、プラグインを利用できるのは Codex のみでした。

  • window.openai のファイルライブラリ用ヘルパー関数

    修正と改善

    • ユーザーの ChatGPT ファイルライブラリが利用可能な場合、ウィジェットは window.openai.selectFiles() を使ってライブラリから既存のファイルを選択できます。

    • ユーザーの ChatGPT ファイルライブラリが利用可能な場合、ウィジェットは window.openai.uploadFile(file, { library: true }) を使ってアップロードしたファイルをライブラリに保存できます。

  • 画像以外のファイルのアップロード

    修正と改善

    • window.openai.uploadFile が画像以外のファイル形式にも対応しました。

February 2026

  • MCP Apps との互換性

    修正と改善

  • プラグイン UI の更新(リダイレクト、ウィジェットの説明、フォローアップ時のスクロール)

    修正と改善

    • window.openai.openExternal({ href, redirectUrl }) で redirectUrl: false を指定すると、ホストが外部リンクの末尾に ?redirectUrl=... を追加しなくなります。

    • window.openai.setOpenInAppUrl({ href }) は、全画面表示で「 で開く」のリンク先を上書きするための公式の API です。この API を呼び出さない場合、ChatGPT は引き続きウィジェットの現在の iframe パスを開きます。

    • リソースの構築時に openai/widgetDescription が指定されている場合は、resource.description よりも優先して使用されます。

    • window.openai.sendFollowUpMessage が scrollToBottom パラメーターに対応しました。デフォルトは true です。false を指定すると、末尾への自動スクロールを無効にできます。

January 2026

  • 社内ナレッジとの互換性ガイド

  • ツール呼び出しのセッションメタデータと requestModal でのテンプレート切り替え

    修正と改善

    • ツール呼び出しに、匿名化された会話 ID _meta["openai/session"] が含まれるようになりました。この ID を使うと、同じ ChatGPT セッション内のリクエストを関連付けられます。

    • window.openai.requestModal({ template }) に registerResource で登録したテンプレートの URI を渡すと、別の登録済み UI テンプレートを開けるようになりました。

November 2025

  • リソースの更新