openai-docs

OpenAI Docs

developers.openai.com MCP サーバーを使用して、OpenAI の開発者向けドキュメントから信頼できる最新のガイダンスを提供します。「Docs MCP」とは、mcp__openaiDeveloperDocs__search_openai_docs と mcp__openaiDeveloperDocs__fetch_openai_doc を指します。API リファレンス、スキーマ、パラメーター、必須フィールドに関する質問では、利用可能な場合、mcp__openaiDeveloperDocs__get_openapi_spec も使用してください。公式ドメインのウェブ検索は、これらのツールが利用できない、または役に立たない場合のフォールバックです。Codex に関する幅広い質問では、Docs MCP より先に手動ヘルパーを使用してください。このスキルは、モデルの選択、API のモデル移行、プロンプトのアップグレードに関するガイダンスも担当します。

ワークフローの設定

情報源の優先順位

• Codex 自体に関する知識については、以下の Codex 情報源ルートを使用してください。手動ヘルパー、Docs MCP、または不確実性を限定した回答のいずれを使うかは、このルートに従って判断します。
• Codex 以外の OpenAI ドキュメントに関する質問では、最も関連性の高いドキュメントページを見つけるために mcp__openaiDeveloperDocs__search_openai_docs を使用してください。
• Codex 以外の OpenAI ドキュメントに関する質問では、回答の前に、関連するページを mcp__openaiDeveloperDocs__fetch_openai_doc で取得してください。検索結果が不明瞭な場合は、Docs MCP でより絞り込んだ検索を実行してください。公式 OpenAI ドキュメントの URL が判明している、または見つかった場合は、ウェブ検索の内容に頼る前に、その URL を Docs MCP 経由で取得してください。
• API リファレンス、スキーマ、パラメーター、必須フィールドに関する質問では、関連するガイドまたはリファレンスページと併せて API の構造を確認するため、利用可能な場合は mcp__openaiDeveloperDocs__get_openapi_spec を使用してください。
• 明確なクエリがなく、Codex 以外のページを閲覧または検索する必要がある場合に限り、mcp__openaiDeveloperDocs__list_openai_docs を使用してください。
• モデルの選択、「最新モデル」、またはデフォルトモデルに関する質問では、まず https://developers.openai.com/api/docs/guides/latest-model.md を取得してください。利用できない場合は、references/latest-model.md を読み込んでください。
• モデルのアップグレードまたはプロンプトのアップグレードでは、対象が「最新」「現行」「デフォルト」、または未指定の場合に限り、node scripts/resolve-latest-model-info.js を実行してください。それ以外の場合は、明示的に指定された対象を維持してください。
• 明示的な対象指定を維持してください。ユーザーが「GPT-5.4 に移行」のように対象モデルを指定した場合、latest-model.md にさらに新しいモデルが記載されていても、その指定された対象を維持してください。より新しいガイダンスについては、任意の情報として言及してください。
• 現在のリモートガイダンスが必要な場合は、返された移行ガイドとプロンプトガイドの URL を両方とも直接取得してください。直接取得に失敗した場合は、MCP または検索に切り替えてください。それも失敗した場合は、同梱のフォールバックリファレンスを使用し、フォールバックを使用したことを明記してください。

OpenAI 製品の概要

1. Apps SDK：ChatGPT にアプリのツールを公開する MCP サーバーと、ウェブコンポーネントの UI を提供して、ChatGPT アプリを構築します。
2. Responses API：エージェント型ワークフローにおける、状態を保持するマルチモーダルなツール使用インタラクション向けに設計された統合エンドポイントです。
3. Chat Completions API：会話を構成する一連のメッセージから、モデルの応答を生成します。
4. Codex：コードの作成、理解、レビュー、デバッグができる、ソフトウェア開発向けの OpenAI のコーディングエージェントです。
5. gpt-oss：Apache 2.0 ライセンスで公開された、オープンウェイトの OpenAI 推論モデル（gpt-oss-120b と gpt-oss-20b）です。
6. Realtime API：自然な音声同士の会話など、低レイテンシーのマルチモーダルな体験を構築します。
7. Agents SDK：モデルがツールやコンテキストを利用し、別のエージェントに処理を引き継ぎ、部分的な結果をストリーミングし、完全なトレースを保持できるエージェント型アプリを構築するためのツールキットです。

Codex 自体に関する知識

Codex 自体に関する質問、つまり設定、拡張、操作、トラブルシューティング、ローカルの状態、製品機能、または Codex の動作をどこに定義すべきかに関する質問には、この経路を使用してください。コードベースでプラグイン、スキル、フック、MCP サーバー、ブラウザー、自動化について言及しているだけでは、該当しません。一般的なソフトウェアのタスクには、そのタスクに直接回答してください。Codex 自体に関する知識が該当するかどうかを尋ねられた場合は、そのメタ質問に簡潔に回答し、依頼された成果物の作成を続けてください。

情報源ルート

Codex マニュアルは、Codex を幅広く統合して理解するための最初の情報源です。マニュアルと Docs MCP は異なる経路として扱い、公式ドキュメントの情報源として相互に置き換えられるものではありません。公開ユーザー向けの Codex 製品に関する回答では、情報源の経路は完結しています。マニュアル、この経路で必要な場合の Docs MCP、OpenAI 公式ウェブサイトでのフォールバック、そして質問がその機能に関するものである場合は、現在のセッションで利用可能な機能です。developers.openai.com 以外のナレッジベースは、公開製品に関する回答のこの経路には含まれません。

Codex の幅広い動作、セットアップ、カスタマイズ、スキル、プラグイン、MCP、フック、AGENTS.md、自動化、利用環境、ローカル状態、システムマップに関する質問の場合：

1. 同じスレッド内で取得したマニュアルとアウトラインがまだ新しい場合は、それらを再利用します。
2. それ以外の場合、通常の書き込み可能なセッションでは、まずスキルローカルのヘルパーを実行します。セッションが明示的に読み取り専用である場合、シェルを実行できない場合、または許可された一時キャッシュがないことがポリシーで明らかな場合に限り、試さずに省略します。
3. デフォルトでは、ヘルパーは使用可能な一時キャッシュディレクトリを次の順序で選択します。$TMPDIR/openai-docs-cache、%TEMP%\openai-docs-cache、%TMP%\openai-docs-cache、/private/tmp/openai-docs-cache、次に/tmp/openai-docs-cacheです。ワークスペースのみへの書き込みアクセスでは、この一時キャッシュを使用できません。
4. キャッシュディレクトリを上書きする必要がない限り、ヘルパーを直接実行します。ネイティブのfetchが利用できない場合、またはプロキシ環境変数が設定されている場合、ヘルパーはcurlにフォールバックするため、シェル固有のプロキシ用プレフィックスは不要です。<skill-dir>は、このスキルの実際のディレクトリに置き換えてください。コピーされたローカル評価用作業ディレクトリでは、通常.codex/skills/openai-docsです。

node <skill-dir>/scripts/fetch-codex-manual.mjs

キャッシュディレクトリを上書きする必要がある場合は、--cache-dir <cache-dir>を渡します。Windowsでは、ヘルパーが%TEMP%と%TMP%を自動的に確認します。PowerShellでは、$env:TEMP\\openai-docs-cacheが一般的な明示的指定です。

ヘルパーを利用できないと判断する根拠は、明示的な読み取り専用／シェル不可のポリシー、または実際のコマンド実行結果に限ります。サンドボックスを推測したり、ヘルパーの失敗を推測したりするだけでは、Docs MCP やウェブ検索に切り替える根拠として不十分です。実際にヘルパーコマンドが失敗した場合は、以下に示す公式情報源のうち、最も範囲の狭いものに進みます。

ヘルパーは情報の新しさを確認し、codex-manual.mdを書き込み、codex-manual.outline.mdを出力します。アウトラインには、ソースページと見出しの行範囲が記載されています。これを使って関連するマニュアルのセクションを選び、その後、Codex 製品に関する事実を確認するため、対象を絞ってマニュアルのセクションを読み込むか検索します。ヘルパーの場所を特定して実行するにはスキルディレクトリを使用します。ヘルパーの実行が成功したら、Codex 製品に関する事実や用語の網羅性を確認する際の検索範囲として、返されたマニュアルとアウトラインのパスを使用します。

Codex に関する追加の質問には、同じスレッド内のマニュアルとアウトラインのパスを再利用します。マニュアルの取得から約1日以上経過している場合、パスが使用できない場合、別のスレッドに由来するパスや出所が不確かなパスの場合、または情報が古くなっている可能性があり、最新情報が欠けている場合は、先に更新します。

マニュアルが現時点で十分に新しく、信頼できるかどうかを問われた場合は、一時キャッシュが許可されていればヘルパーを実行し、返されたステータス、マニュアルのパス、アウトラインのパスに基づいて回答します。

マニュアルで Codex に関する主張を確認できた場合は、マニュアルに基づいて回答し、その主張について情報源の追加調査を終了します。ドキュメントの検索がより広いユーザーのタスクにおける依存事項の一つにすぎない場合は、引き続きそのタスクに対応します。マニュアルに記載された内容については、マニュアルのソースページと既知のアンカーで、引用の根拠として十分です。

セッションが読み取り専用、シェル実行不可、または許可された一時キャッシュがないためにヘルパーを省略した場合、次の情報源は Docs MCP です。ウェブ検索にフォールバックする前に、mcp__openaiDeveloperDocs__search_openai_docsを呼び出し、関連する検索結果に対してmcp__openaiDeveloperDocs__fetch_openai_docを呼び出します。 新しいマニュアルで使われていない Codex の用語やモードをユーザーが挙げた場合は、マニュアル内で明らかに関連する概念を検索し、その正確な用語は文書化されていないことを伝えたうえで、最も近い文書化済みの用語を使用してください。プロンプトでその用語が Codex の動作にどう対応するかを尋ねられた場合は、関連するマニュアルのセクションから対応関係を判断してください。マニュアルを確認した後も、その正確な用語が重要である、または現在も使われている可能性が高い場合は、範囲を絞って Docs MCP で検索を 1 回行って取得し、それ以外の場合は、その用語や対応関係に関する情報源の確認を完了とします。

マニュアルを利用できない場合、ヘルパーが失敗した場合、一時キャッシュが許可されていない場合、重要な主張に関する情報が不足している、または古くなっている可能性が高い場合、あるいはユーザーがページ単位の引用を明示的に必要としている場合にのみ、次の公式情報源を最小限の範囲で使用してください。特定の Docs MCP 検索を 1 回行い、明らかに関連するページが見つかった場合は、取得を 1 回行うことを優先してください。未解決の Codex 機能名、頭字語、スケジュール用語、または正確なエラーテキストについては、ウェブ検索より先にこの Docs MCP の手順を行ってください。マニュアルと、許可された Docs MCP による不足情報の補完を行った後も不明点が残る場合は、範囲を限定した不確実性を示してください。公式ドメインを対象にしたウェブ検索は、この Docs MCP の手順が利用できない、または役に立たない場合にのみ行ってください。それでも主張を裏付けられない場合は、範囲を限定した不確実性を示して、それ以上の調査は行わないでください。公式ドキュメントやマニュアルの記述が、現在のセッションで明らかになっている呼び出し可能な機能と矛盾する場合は、その矛盾を伝え、その環境で確認された現在の動作を優先してください。

文書化されていない、または非公開と思われるモデルのスラッグ、製品モードのラベル、利用資格のラベル、アカウントのアクセス経路、ロールアウト名については、現在の公開ドキュメントと範囲を限定した不確実性に基づいて回答してください。これらのラベルを理由に、公開情報源の確認を打ち切らないでください。

サポート形式の診断では、プロバイダー固有のウェブ検索よりも、マニュアルに基づくレイヤーごとの回答を優先してください。確認するレイヤーは、インストール済み／有効化済みのプラグイン、同梱アプリまたはコネクターの認証、MCP の設定、ワークスペース／管理者ポリシー、再起動または新しいスレッドが必要かどうかの順です。それでも解決しない場合は、サポートまたはフィードバックを案内してください。

情報源の確認を行っても主張を裏付けられない場合は、調査範囲を広げず、範囲を限定した不確実性を示すか、サポート、管理者、または製品フィードバックへ案内してください。

未解決の製品用語については、マニュアルと、許可された次の公式情報源に基づいて回答してください。それらの情報源で用語を確認できない場合は、それらの情報源に基づく範囲を限定した不確実性を示してください。

サーフェスマップ

Codex の設定と永続的な指示を適用する場所が重複する場合は、対象範囲に合う最小限の場所を推奨してください。

• プロンプトまたはスレッドのコンテキスト -> 1 回限りのタスク制約。
• AGENTS.md -> 永続的なリポジトリの規約、コマンド、検証手順、レビュー時の期待事項。より深い階層にあるファイルは、そのサブツリー内に適用されます。
• プロジェクトの .codex/config.toml -> サンドボックス、MCP、フック、モデル、推論のデフォルトなど、信頼されたリポジトリに対する Codex の設定。
• グローバル設定またはグローバルガイダンス -> リポジトリをまたいで適用される個人用のデフォルト。
• スキル -> 参照資料やスクリプトを含む、再利用可能なタスクワークフロー。
• プラグイン -> スキルに加え、コマンド、ツール、MCP 設定、フック、アセット、アプリ、マーケットプレイスのメタデータを含む、インストール可能なバンドル。
• MCP サーバーまたはアプリコネクター -> ライブの外部データやアクション、または認可された非公開のアプリ／ワークスペースデータ。非公開の Google Docs、Calendar、Slack、GitHub、Notion などのデータには、ウェブ検索やモデルの記憶ではなくコネクターを使用してください。
• 自動化 -> スケジュールされたチェック、リマインダー、監視、フォローアップ作業。既存のスレッドで継続性が重要な場合は、スレッドのハートビートを使用してください。
• フック -> ツール呼び出し、コマンド、ファイル編集に対するライフサイクルの適用。

対象範囲が混在するリクエストは、無理に一つの回答にまとめず、分けてください。例：「常に X を実行するが、この PR に限る」の場合、今回の実行にはプロンプト／スレッドのコンテキストをデフォルトで使用します。永続させる必要がある場合にのみ AGENTS.md またはプロジェクト設定を使用し、機械的な適用にはフックのみを、スケジュールされた作業やフォローアップ作業には自動化のみを使用してください。

必要に応じて、次の簡易的なプロダクトマップを使用してください。CLI はターミナル中心のローカルリポジトリ作業、IDE 拡張機能はエディターに接続したコーディング、Codex アプリはデスクトップでの計画、レビュー、対話型作業、クラウド／ウェブはホストされた並列処理やオフロード作業、Browser Use／アプリ内ブラウザーは Codex が制御するウェブテスト、Chrome 拡張機能はユーザーの Chrome プロファイルを使用し、Computer Use はデスクトップアプリと OS の UI を操作します。config.toml のデフォルト、requirements.toml の制約、管理者ポリシーはそれぞれ分けてください。

境界と出力

• API キー認証があっても、ChatGPT、クラウドタスク、コネクターへのアクセスがあるとは限りません。プラグイン／アプリ／認証の問題では、回答する前に、バンドルの提供状況、プラグインのインストール／有効化状態、コネクター／アプリの認可、MCP の設定、再起動／更新の要件、ワークスペースのポリシー、サーフェスごとの提供状況を確認してください。
• サンドボックスやネットワークによる拒否には、明確な正当化理由を添えて、対象を絞ったエスカレーションが必要です。破壊的なコマンド、ワークスペース外への書き込み、広範なアクセス変更には、明示的な承認が必要です。
• メモリーはユーザーの好みやコンテキストの把握に役立ちますが、明示的なプロンプトの指示が優先され、現在の外部情報の情報源としてメモリーを使用することはできません。
• サーフェスの選択を肯定する回答では、次の形式を使用してください。推奨、理由、避けるべきこと、参照したマニュアル／情報源の根拠。
• ページ固有の Codex 引用が実際に必要な場合は、次のアンカーが適しています。concepts/customization#agents-guidance は AGENTS.md 用、concepts/customization#skills はスキル用、plugins/build#plugin-structure はプラグイン用、concepts/customization#mcp は MCP 用、config-advanced#hooks はフック用、app/automations#thread-automations はスレッドの自動化用、config-reference#configtoml は設定用です。

MCP サーバーが見つからない場合

MCP ツールが失敗する場合、または OpenAI ドキュメントのリソースが利用できない場合：

1. インストールコマンドを自分で実行してください：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
2. 権限またはサンドボックスが原因で失敗した場合は、権限を昇格して同じコマンドをすぐに再試行し、承認を得るための 1 文の正当化理由を添えてください。
3. 権限を昇格した試行も失敗した場合に限り、ユーザーにインストールコマンドの実行を依頼してください。
4. Codex の再起動をユーザーに依頼してください。
5. 再起動後に、ドキュメントの検索／取得をもう一度実行してください。

ワークフロー

1. 依頼が一般的なドキュメントの検索、モデルの選定、モデル文字列のアップグレード、プロンプトのアップグレードに関する案内、またはより広範な API／プロバイダーの移行のどれに該当するかを確認します。
2. Codex の自己知識に関する依頼では、上記の Codex 自己知識ソース手順に従います。
3. モデルの選定やアップグレードに関する依頼で、ユーザーが最新／現行／デフォルトの案内を求めている場合は、同梱の参考資料よりも最新のリモートドキュメントを優先します。
   • https://developers.openai.com/api/docs/guides/latest-model.md を取得します。
   • 最新のモデル ID と、明示的な移行またはプロンプトに関する案内へのリンクを探します。
   • 最新モデルのページに明示されたリンクを、URLから導き出したリンクより優先します。
   • 明示的なモデル名のリクエストでは、指定されたモデルを維持します。新しいリモートの案内については、任意の情報として言及します。
   • 動的な最新／現行／デフォルトのアップグレードでは、node scripts/resolve-latest-model-info.js を実行し、可能であれば返された両方のガイド URL を直接取得します。
   • ガイドを直接取得できない場合は、開発者向けドキュメントの MCP ツールまたは OpenAI の公式ドメインでの検索を使って、同じガイド内容を探します。
   • リモートドキュメントを利用できない場合は、同梱の代替資料を使用し、その資料に基づく案内であることを伝えます。
4. モデルのアップグレードでは、変更を最小限にとどめます。安全な場合に限り、OpenAI API の有効なモデルデフォルトと、それに直接関連するプロンプトのみを更新します。
5. ユーザーが明示的にアップグレードを求めない限り、過去のドキュメント、例、評価のベースライン、フィクスチャ、プロバイダーの比較、プロバイダーのレジストリ、料金表、エイリアスのデフォルト、低コストのフォールバック経路、用途が曖昧な古いモデルの使用箇所は変更しません。
6. ユーザーが明示的に求めない限り、モデルとプロンプトのアップグレードには SDK、ツール、IDE、プラグイン、シェル、認証、プロバイダー環境の移行を含めません。
7. アップグレードに、API のサーフェス、スキーマの再配線、ツールハンドラーの変更、またはモデル文字列の置換とプロンプト編集を超える実装作業が必要な場合は、ブロック中または確認が必要な事項として報告します。
8. 一般的なドキュメント検索では、まず必須用語を2〜6個含む、簡潔でタイトルのような検索クエリを使います。ユーザーの質問全体をキーワードの羅列にしないでください。最適なページと必要なセクションを取得し、簡潔な引用元を添えて回答します。

参照マップ

必要なものだけを読みます。

• https://developers.openai.com/api/docs/guides/latest-model.md -> 現在のモデル選定、および「最適／最新／現行モデル」に関する質問。
• scripts/fetch-codex-manual.mjs -> 現行の Codex マニュアルの取得、検証、ローカルの一時キャッシュ、アウトライン生成。
• https://developers.openai.com/codex/codex-manual.md -> セットアップ、カスタマイズ、スキル、プラグイン、MCP、フック、AGENTS.md、自動化、サーフェスの動作を含む、Codex の自己知識に関する現在の情報の統合。通常、一時キャッシュが利用可能な場合は、ヘルパー経由のパスと対象を絞ったファイル読み込みを使ってアクセスします。
• references/latest-model.md -> モデル選定、および「最適／最新／現行モデル」に関する質問用の同梱の代替資料。
• references/upgrade-guide.md -> モデルのアップグレードとアップグレード計画の依頼用の同梱の代替資料。
• references/prompting-guide.md -> プロンプトの書き換えとプロンプトの動作のアップグレード用の同梱の代替資料。

品質ルール

• OpenAI のドキュメントを信頼できる情報源として扱い、憶測を避けます。
• Codex の自己知識については、記憶した動作に頼らず、上記のソース経路に従います。
• 移行の変更は最小限にとどめ、動作を維持します。
• 可能であれば、プロンプトのみのアップグレードを優先します。
• 料金、利用可能状況、パラメーター、API の変更、互換性を損なう変更を創作しないでください。
• 引用はポリシー上の制限内で短くし、言い換えと引用元の提示を優先します。
• 複数のページで内容が異なる場合は、その違いを説明し、両方を引用します。
• 公式ドキュメントと、現在のセッションで検証済みの呼び出し可能な動作が食い違う場合、広範な主張や編集を行う前に、その矛盾を明示します。
• ドキュメントでユーザーのニーズが扱われていない場合は、その旨を伝え、次の手順を提案します。

ツールに関する注意事項

• OpenAI 関連の Markdown ドキュメントでは、Web 検索の前に MCP のドキュメント用ツールを使用してください。Codex のマニュアルに関するフローは例外です。Codex に関する幅広い情報をまとめる場合は、Codex の自己知識ソース手順に従ってください。
• MCP サーバーがインストールされているにもかかわらず、有意な結果が返されない場合は、フォールバックとして Web 検索を使用してください。
• Web 検索にフォールバックする場合は、公式の OpenAI ドメイン（developers.openai.com、platform.openai.com）に限定し、出典を引用してください。