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