「CodexでMCPを使って外部ツールと連携したいけれど、設定方法が分からない」「設定例を試しても接続できず、どこを直せばよいのか迷っている」という方もいるのではないでしょうか。
CodexでMCP連携を使い始める際は、利用環境に合った設定方法と、接続先で必要になる認証を押さえることが大切です。
そこで本記事では、CodexのMCP連携の仕組みから設定方法・使い方まで解説します。Claude Codeなど、ほかの生成AIツールと併用する際の活用例も紹介します。
CodexのMCP連携とは

MCPは、AIツールと外部のデータや機能を接続するための共通規格です。Codexに対応するMCPサーバーを追加すると、そのサーバーが提供するツールを通じて、情報を取得したり、操作を実行したりできるようになります。
例えば、外部資料の内容を手作業でコピーして渡す代わりに、Codexから必要な情報を検索・取得できるようになるのがメリットです。利用できる機能は、接続先のMCPサーバーや許可した権限によって異なります。
外部MCPサーバーへの接続と旧サーバー化機能の違い
CodexとMCPの連携について調べると、「Codexに外部のMCPサーバーを追加する方法」と「Codex自体をMCPサーバーとして動かす方法」が出てきます。名前が似ているため混同しやすいものの、どちらのツールから、どちらを呼び出すかが異なります。
| 比較項目 | Codexから外部MCPサーバーに接続する | CodexをMCPサーバーとして動かす旧方式 |
|---|---|---|
| 操作の起点 | Codex | Claude Codeなどの別のツール |
| 呼び出す対象 | 外部のMCPサーバー | MCPサーバーとして動くCodex |
| 目的 | 外部の情報や機能をCodexで使う | 別のツールからCodexに作業を依頼する |
現在のCodexでは、MCPサーバーを登録することで外部ツールの機能を利用できます。一方、以前提供されていた「codex mcp-server」コマンドは削除されました。外部アプリケーションからCodexを操作する方法として、Codex App ServerやCodex SDKなどがありますが、従来のMCPサーバー機能とは異なる仕組みです。
Codexについてあまり理解していないという方は以下の記事を先にチェックしてみてください。
CodexのMCP連携でできること
CodexをMCPサーバーと連携させると、外部の資料を参照しながらコードを書いたり、接続先のサービスに保存されたデータを更新したりと、対応できる作業の幅が広がります。ここでは、CodexとMCPサーバーを連携させることでできることを5つ紹介します。
- 外部ドキュメントを参照する
- 業務データを検索・更新する
- ブラウザ操作や開発を支援する
- 3D制作やゲーム開発を支援する
- 他生成AIツールとの共同作業を進めやすくする
①外部ドキュメントを参照する
「公式ドキュメントを読んでも、自分のコードにどう当てはめればよいか分からない」という場面では、CodexのMCP連携による資料の参照がおすすめです。ドキュメントを検索できるMCPサーバーを接続すれば、Codexが必要な情報を取得し、その内容を踏まえて実装方法を検討できます。
例えば、OpenAIが公開しているドキュメント用MCPサーバーでは、公式ドキュメントの検索と本文の取得が可能です。Codexからドキュメント用MCPサーバーを利用すれば、資料を手作業で探してコピーし、コードと照らし合わせる手間を減らせるのがメリットです。
②業務データを検索・更新する
CodexのMCP連携は、社内に蓄積された情報を探し、日々の業務に活かす用途でも利用できます。例えば、Notionが提供するMCPサーバーと連携すれば、認証されたユーザーの権限と利用可能なツールの範囲内で、ページの検索・読み取り・作成・更新などを行えます。
活用例としては、以下のような依頼が考えられます。
- 「案件名に関連する議事録を探し、決定事項をまとめて」
- 「この打ち合わせメモを整理して、Notionに新しいページを作って」
資料を探すところから整理・記録までを続けて依頼できるため、複数の画面を行き来する負担を減らせます。特に、案件ごとの情報が多く、必要な記録を探すのに時間がかかっている人には便利な使い方です。
③ブラウザ操作や開発を支援する
Webサイトを作っていると、「コードは修正したのに表示が崩れる」「ボタンを押しても反応しない」といった問題にあいます。CodexにMCP経由でブラウザ用のツールを接続すると、実際の画面やエラー情報を確認しながら、原因を調べる作業を支援できます。
例えば、Chrome DevTools MCPサーバーでは、
- ブラウザ操作の自動化
- スクリーンショットの取得
- コンソールメッセージや通信内容の確認
- パフォーマンス分析
などの機能があります。画面の見た目だけでは分からない不具合も、調査対象にできるのが特徴です。
④3D制作やゲーム開発を支援する
CodexからMCPサーバーを通じて利用できる機能は、資料管理やWeb開発だけではありません。BlenderやUnity向けのMCPサーバーを利用すれば、制作ソフト内の操作にもCodexを活用できます。
設定項目を一つずつ探して操作する負担を減らし、動きを試す工程に時間を使いやすくなるでしょう。CodexとMCPサーバーを使った制作支援を試すなら、接続先が対応する操作を確認したうえで、結果を確認しやすい作業から始めるのがおすすめです。
⑤他生成AIツールとの共同作業を進めやすくする
MCPは、CodexとClaude Codeなど、複数の生成AIツールを使い分ける際にもおすすめ。双方に対応するMCPサーバーをそれぞれ設定すれば、同じ外部サービスやドキュメントを参照しながら作業できます。
例えば、OpenAIのドキュメント用MCPサーバーは、CodexとClaude Codeの両方に接続できます。共通の情報源を使えるため、ツールを切り替えるたびに資料を探して貼り付ける手間を減らせるのがメリットです。
ただし、同じMCPサーバーに接続しても、会話履歴や作業状況が自動で共有されるわけではありません。決定事項や引き継ぐ内容は、別途伝える必要があります。
CodexでMCPサーバーを設定する方法
CodexのMCP連携は、ターミナルのコマンドから追加するほか、VS Code拡張やデスクトップアプリの設定画面からも登録できます。普段使っている環境に合わせて、操作しやすい方法を選びましょう。
- CLIでサーバーを追加する
- VS Code拡張で設定する
- デスクトップアプリで設定する
- プロジェクトごとに設定する
①CLIでサーバーを追加する
Codex CLIを利用しているなら、「codex mcp add」でサーバーを追加できます。ここでは、公式ドキュメントを検索できるOpenAIのMCPサーバーを例に進めます。Codex CLIが利用できるターミナルを開き、次のコマンドを実行してください。
| codex mcp add openaiDeveloperDocs –url https://developers.openai.com/mcp |
openaiDeveloperDocsはCodex内で接続先を識別する名前、「–url」の後ろはMCPサーバーの接続先です。追加したら、次のコマンドで登録を確認します。
| codex mcp list |
初めてCodexでMCP連携を試す際は、このように接続先とコマンドが明示されている例から始めると、入力内容に迷いにくいでしょう。
②VS Code拡張で設定する
VS CodeでCodexを使っている場合は、拡張機能の設定画面からMCPサーバーを追加できます。普段の編集画面から操作できるため、ターミナルでの設定に慣れていない方にも個人的にはわかりやすいと思います。
以下の手順で進めます。
- Codex拡張の歯車メニューを開く
- 「MCP servers」を選択する
- 「Add server」を押す
- サーバー名と接続方式を選び、URLまたは起動コマンドを入力する
- 保存して「Restart extension」を実行する
OAuth認証が必要な接続先では、サーバー一覧の「Authenticate」から認証も進めます。先ほどのOpenAIドキュメント用サーバーなら、接続方式は「Streamable HTTP」、URLは「https://developers.openai.com/mcp」です。
③デスクトップアプリで設定する
デスクトップアプリでは、設定画面に接続先を入力して、Codexで利用するMCPサーバーを登録します。ここでは、「ChatGPT desktop app」の手順を紹介します。
- Settingsを開く
- MCP serversを選択する
- Add serverを押す
- サーバー名と接続方式を設定する
- URLまたは起動コマンドを入力する
- 保存してRestartを実行する
認証が必要なサーバーは「Authenticate」からログインし、入力欄で「/mcp」を開いて接続状況を確認します。入力内容に迷ったら、まず接続先の提供元が紹介する方式を確認してください。
「MCPサーバーのURLがあるからHTTP」「手元で起動するプログラムだからSTDIO」と整理すると、設定項目の意味が分かりやすくなります。
④プロジェクトごとに設定する
「この案件ではドキュメント検索を使い、別の案件ではブラウザ確認用のツールを使いたい」という場合は、Codexで利用するMCPサーバーをプロジェクト単位で設定できます。案件に必要な接続先を、プロジェクト内のファイルで管理する方法です。
ユーザー共通の設定とは、保存場所が異なります。
| 適用範囲 | 設定ファイル |
|---|---|
| ユーザー共通 | ~/.codex/config.toml |
| プロジェクト単位 | プロジェクト内の.codex/config.toml |
設定するには、対象プロジェクトのフォルダ内に「.codex」フォルダを作成し、その中に「config.toml」を配置します。記述方法はユーザー共通の設定と同じです。
| [mcp_servers.openaiDeveloperDocs]url = “https://developers.openai.com/mcp” |
ただし、プロジェクト内の設定が読み込まれるのは、信頼済みのプロジェクトに限られます。ファイルを配置しても反映されない場合は、対象プロジェクトの状態も確認してください。
ここまでの設定を見て、「手順は分かったけれど、自分の仕事でどう使えばよいか迷う」という方は、実際にツールを作りながら学ぶ方法もあります。そこで「Codexセミナー」の受講を検討してみてください。
Codex・プログラミング未経験者を対象に、業務ツール開発や自動化を実践する講座で、PDF・画像のExcel化や、議事録・日報をもとにした報告メールの下書き作成などを学べます。
個人的に魅力を感じるのは、転記や報告メールの作成など、普段の仕事で手間がかかる作業を題材に学べる点です。「この作業を自動化したい」という目的を持って取り組めるので、操作方法を覚えるだけでなく、受講後に自分の業務へ取り入れるイメージも持ちやすいと思います。
| セミナー名 | Codexセミナー |
|---|---|
| 運営元 | GETT Proskill(ゲット プロスキル) |
| 価格(税込) | 38,500円〜 |
| 受講期間 | 2日間 |
| 受講形式 | 対面(東京) |
CodexのMCP連携の使い方と基本コマンド

CodexでMCPサーバーの設定が終わったら、接続先の認証と登録内容を確認し、実際にツールを使ってみましょう。基本操作で使うコマンドと設定は、以下のとおりです。
- loginで認証する
- list・getで設定を確認する
- 接続したツールを呼び出す
- サーバーを無効化・削除する
①loginで認証する
Notionなどの外部サービスにMCP接続する場合、MCPサーバーの登録に加えて、そのサービスへのアクセスを許可する認証が必要になることがあります。OAuth対応の接続先では、次のコマンドを実行してください。
| codex mcp login my-server |
コマンドのloginは小文字で入力します。実行後は表示される案内に従い、接続先のアカウントでログインして、アクセスを許可する範囲を確認します。ここで行うのは、Codex本体へのログインではなく、CodexからMCP経由で利用する外部サービスの認証です。
②list・getで設定を確認する
「サーバーを追加したはずなのに見つからない」というときは、設定をやり直す前に、登録内容を確認してみてください。Codex CLIでは、「codex mcp list」と「codex mcp get」を使って接続先の設定を調べられます。
まず、登録済みのMCPサーバーをまとめて確認するには、次のコマンドを実行します。
| codex mcp list |
一覧の中から確認したいサーバーを見つけたら、getで個別の設定を表示します。
| codex mcp get my-server |
例えば、接続先のURLを間違えていないか、ローカルMCPサーバーの起動コマンドが正しいかを見直す際におすすめです。全体を把握するならlist、特定の設定を調べるならgetと覚えておくと使い分けやすいでしょう。
③接続したツールを呼び出す
接続を確認できたら、Codexの対話画面から、実行したい作業を日本語で依頼します。MCPツールごとのコマンドをすべて覚える必要はなく、利用する接続先と作業内容を伝えるのが基本です。
例えば、OpenAIのドキュメント用MCPサーバーを登録している場合は、次のように入力してみてください。
| OpenAIのドキュメントMCPを使って、APIの認証方法を調べてください。設定手順と参照元のURLをまとめてください。 |
このサーバーは公式ドキュメントの検索・取得に対応しているため、CodexのMCP連携が動作するかを確認する最初の依頼にも使えます。
④サーバーを無効化・削除する
しばらく使わない接続先は無効化し、今後使う予定がないものは登録を削除すると、Codexに登録したMCPサーバーの設定を整理できます。
一時的に利用を止める場合は、「config.toml」で対象MCPサーバーの設定を探し、「enabled=false」を追加します。すでに「enabled=true」がある場合は、その値を変更してください。例えば、OpenAIドキュメント用サーバーを無効化する設定は次のとおりです。
| [mcp_servers.openaiDeveloperDocs]url = “https://developers.openai.com/mcp” enabled = false |
URLや起動コマンドを残したまま停止できるため、再び使うときは「enabled=true」に戻せます。設定後は、利用しているアプリや拡張機能を再起動し、反映を確認しましょう。完全に登録を削除する場合は「codex mcp remove my-server」を実行します。
以下の記事では、Codexの使い方についても紹介していますので、あわせてご覧ください。
CodexのMCP連携についてのまとめ
CodexのMCP連携を仕事に活かすには、普段手間がかかっている作業を一つ選び、その作業に必要なツールを接続するところから始めましょう。例えば、公式ドキュメントの検索や議事録の整理など、結果を確認しやすい用途なら、導入によって何が楽になるのかを実感しやすくなります。
最初から多くのサーバーを追加する必要はありません。まずは利用環境に合った方法で一つ登録し、必要な認証と接続確認を済ませ、具体的な依頼を試してみてください。取得した情報や操作結果を確認しながら、任せる範囲を少しずつ広げていくことが大切です。






