Codexの codex mcp add で公式ドキュメント検索を1つ増やす — OpenAI Docs MCPを10分でつなぐ
更新日: 2026-08-23
Codexで作業している途中、「この書き方、いまの公式仕様ではどうなってるんやろ」とブラウザへ戻ったことはありませんか。
今日は、Codex CLIへ OpenAIの公式ドキュメントを検索・閲覧する道具を1つだけ追加 します。使うのは codex mcp add です。
10分後の成功状態は、次の2つです。
-
codex mcp listにopenaiDeveloperDocsが出る - Codexへ「公式ドキュメントを調べて、出典URL付きで答えて」と頼める
MCPの仕組みを全部理解する必要はありません。まず1本つないで、「AIエージェントにできることが1つ増えた」を体験してみましょう。
今回扱うのは codex mcp add だけ
この記事では、MCPサーバーの作り方、認証付きサービス、FigmaやGitHub連携までは扱いません。公開されている読み取り専用のOpenAI Docs MCPを、Codexへ1つ登録するところだけ に絞ります。
codex mcp list も出てきますが、新しい機能として広げるためではありません。追加できたかを確認するチェックにだけ使います。
先に用語をやさしく整理する
AIエージェント は、質問へ文章で答えるだけでなく、許された範囲でファイルを読んだり、コマンドや道具を使ったりしながら作業を進めるAIです。
CLI（Command Line Interface） は、画面のボタンではなく、ターミナルへ文字を打って操作する方式です。
ターミナル は、パソコンへ文字の命令を渡すアプリです。macOSなら「ターミナル」、WindowsならPowerShellなどが該当します。
MCP（Model Context Protocol） は、AIと外部の道具・情報源をつなぐ共通の約束ごとです。たとえるなら、家電ごとに違う差し込み口を、共通のコンセントへそろえる仕組みに近いです。
MCPサーバー は、その共通の差し込み口の向こう側で、AIへ道具や情報を提供するプログラムです。今回つなぐOpenAI Docs MCPは、OpenAIの公式ドキュメントを検索し、ページ内容を読むためのサーバーです。
何が便利になるのか
接続前は、Codexで作業しながらブラウザを開き、検索し、該当ページを探し、必要な箇所をコピーして会話へ戻す流れになりがちです。
接続後は、Codexの会話の中で「OpenAIの公式ドキュメントを調べて」と頼めます。省けるのは、単なるコピペの数手だけではありません。いま書いているコードの文脈を保ったまま、公式情報を探しにいける のが大きいんです。
ただし、MCPをつなげば回答が必ず正しくなるわけではありません。AIがページを読み違えることもあります。重要な仕様は、回答に出典URLを付けてもらい、自分でも原文を確認する。この最後の確認は人間の仕事です。
始める前の前提
すでにCodex CLIを使える方は、この小見出しを飛ばして構いません。未導入なら、OpenAI公式リポジトリに掲載されているインストーラーを使います。
macOS / Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
インストール後に codex を実行し、画面の案内に従ってChatGPTでサインインします。この記事では、インストーラー自体の詳しい選び分けやAPIキー認証は扱いません。
また、codex mcp add を実行すると、通常は ~/.codex/config.toml に設定が保存されます。~ は自分のホームフォルダ、.codex はCodexの設定フォルダです。設定が増える操作だと理解してから進めましょう。
今回の接続先は、OpenAIが公開しているドキュメント専用サーバーです。公式説明では読み取り専用で、OpenAI APIを代わりに呼び出すものではありません。
筆者環境で確認した範囲
2026年8月23日に、macOS上の codex-cli 0.147.0 で次を確認しました。
-
codex mcp add --helpに、名前と--urlを受け取る公式構文が表示されること - 一時的な設定上書きで
openaiDeveloperDocsと公式URLがcodex mcp listに表示されること - 公式サーバーへMCPの初期化リクエストを送り、HTTP 200とサーバー名
openai-docs-mcpが返ること
既存の個人設定を書き換えないため、この記事の codex mcp add による永続登録と、登録後のモデル回答取得は筆者環境では実行していません。以下の追加・質問手順は公式Quickstart準拠ですが、筆者未実行です。
10分で接続する
1. Codex CLIが使えるか確認する
ターミナルで次を実行します。
codex --version
codex-cli とバージョン番号が出れば次へ進めます。command not found と出る場合は、まだインストールされていないか、ターミナルがCodexの場所を見つけられていません。
2. OpenAI Docs MCPを1つ追加する
次の1行をそのまま実行します。
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
それぞれの意味はこうです。
-
codex mcp add: CodexへMCPサーバーを追加する -
openaiDeveloperDocs: 自分のCodex内で使うサーバー名 -
--url: インターネット上のMCPサーバーをURLで指定する -
https://developers.openai.com/mcp: OpenAI公式Docs MCPの接続先
名前は短く分かりやすい方が、Codexが道具を選びやすくなります。この記事では公式Quickstartと同じ openaiDeveloperDocs を使います。
3. 一覧に出るか確認する
codex mcp list
一覧の中に、次の名前とURLが見えれば登録成功です。
openaiDeveloperDocs https://developers.openai.com/mcp
表示の列名や空白はCLIの版によって変わる可能性があります。完全に同じ見た目でなくても、名前とURLが見つかれば成功 と判断してください。
4. Codexを起動して1問だけ聞く
codex
ここから先は、通常のターミナルではなくCodexの入力欄です。次の文章を貼り付けます。
OpenAIの公式ドキュメントMCPを使って、Codex CLIのMCP設定が保存される既定のファイルを調べてください。出典URLも1つ付けてください。
公式MCPページに基づく回答なら、既定の設定ファイルとして ~/.codex/config.toml が示され、公式ページへのリンクが付くはずです。
ここで大事なのは、文章が一字一句同じかではありません。
- OpenAI Docs MCPを使ったことが会話上で分かる
- 設定ファイルの場所が答えに含まれる
-
developers.openai.comまたはlearn.chatgpt.comの出典URLが付く
この3点を確認できれば、最初の1回は完了です。
接続できたかの成功チェック
次の4項目を上から確認してください。
-
codex --versionが表示された -
codex mcp add ...がエラーなく終わった -
codex mcp listに名前とURLが出た - Codexの回答に公式ドキュメントの出典URLが付いた
一覧には出るのに質問時に使われない場合は、プロンプトで「OpenAIの公式ドキュメントMCPを使って」と明示します。複数の道具がある環境では、AIが別の検索手段を選ぶことがあるためです。
つまずきポイント
1. codex: command not found と出る
Codex CLIが未導入か、インストール後のターミナルを開き直していない可能性があります。公式CLIページで導入手順を確認し、新しいターミナルで codex --version をもう一度実行します。
2. mcp というサブコマンドが認識されない
CLIが古い可能性があります。まず codex --version と codex mcp --help を確認してください。更新方法は導入方法によって違うため、公式CLIページの当日手順に従うのが安全です。
3. 同じ名前がすでにある
先に codex mcp list を実行し、openaiDeveloperDocs があれば追加済みです。重複して登録せず、そのまま質問テストへ進みます。
4. URLを手入力して間違えた
接続先は次の1つです。
https://developers.openai.com/mcp
末尾を別のページURLへ変えず、公式Quickstartからコピーしてください。
5. 一覧には出るが、回答で使われない
質問へ「OpenAIの公式ドキュメントMCPを使って」「出典URLも付けて」の2点を入れます。必要ならCodexを終了して再起動し、もう一度試します。
6. 会社や学校のネットワークで接続できない
プロキシや外部サービス制限の可能性があります。勝手に制限を回避せず、管理者へ https://developers.openai.com/mcp への接続可否を確認してください。
7. 回答は来たが、本当に公式情報か不安
出典URLのドメインを見ます。今回のDocs MCPの対象は developers.openai.com、platform.openai.com、learn.chatgpt.com の公式ドキュメントです。重要な数値や仕様はリンク先の原文まで開いて確認します。
よくある質問
OpenAI APIキーは必要ですか
公式Docs MCPは公開のドキュメント専用サーバーとして案内されており、OpenAI APIを代わりに呼ぶものではありません。Codex CLI自体を使うためのサインイン条件は別にあります。
設定はどこに保存されますか
既定では ~/.codex/config.toml です。公式MCPページでは、信頼済みプロジェクトに限り .codex/config.toml へプロジェクト単位で設定できることも案内されています。この記事では個人の既定設定だけを扱います。
後で外したくなったらどうしますか
CLIには codex mcp remove があります。ただしこの記事の主題は追加なので、削除操作は実行しません。不要になった時に codex mcp --help と公式MCPページを再確認してから行ってください。
第三者のMCPサーバーも同じように追加できますか
仕組み上は追加できますが、安全性は別問題です。MCPサーバーは道具やデータへアクセスできるため、運営者、権限、認証、読み書きの範囲を確認してから接続してください。今回のDocs MCPが読み取り専用だからといって、すべてのMCPが同じではありません。
この方法が向かない条件
公式ページを月に1回見る程度なら、ブラウザ検索で十分です。設定を増やさず、検索結果から公式ドメインを開く方がシンプルでしょう。
MCPが効くのは、Codexで実装しながら公式仕様を何度も確認する人です。会話の文脈を保ち、検索と作業の往復を減らせます。
もう1つの限界は、Docs MCPはドキュメントを読む道具であって、コードの正しさを保証する審査員ではない ことです。出典、実行結果、テスト。この3つを最後に人間が照合してください。
まとめ
今日やったのは、AIエージェントへ道具を1つ増やすことでした。
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list
最初の一歩は、接続できたら自分がいま使っているOpenAI機能を1つだけ質問することです。たとえば「Responses APIのツール定義を公式ドキュメントから調べて、出典付きで要約して」で十分です。
大きな自動化より、信頼できる道具を1つずつ増やす。AIエージェント入門では、この順番がいちばん失敗しにくいんやと思います。
参考リンク
生成AI活用エンジニア&3児のパパ。AI×開発の実践知を毎日発信しています → X