Codex App Serverとは？できること・使い方・MCPとの違いをわかりやすく解説
Codex App Serverとは、OpenAI CodexをCLI、IDE、Webアプリ、macOSアプリなど複数の画面から使えるようにするための裏側の仕組みです。普通にCodex CLIを使うだけなら意識しなくてもよい機能ですが、Codex連携ツールを作る人にとっては重要な基盤です。
この記事では、Codex App Serverの役割、できること、MCPとの違い、codex app-serverコマンドの基本を、初心者にもわかるように整理します。
前提：App ServerはOpenAIの公式ブログやCodexリポジトリで説明されている仕組みですが、CLI上では experimental と表示されます。2026年5月7日時点の情報として読み、実運用では最新の公式情報を確認してください。
Codex App Serverとは？
Codex App Serverは、Codex本体のエージェント機能を、外部のアプリや画面から扱いやすくするためのサーバーです。
OpenAIの公式記事では、CodexはWebアプリ、CLI、IDE拡張、macOSアプリなど複数の場所で使われる一方、内部では同じ「Codex harness」が動いていると説明されています。この共通のエージェント基盤と各アプリをつなぐ役割を持つのがCodex App Serverです。
ざっくり言えば、Codex App Serverは「Codexの頭脳と、ユーザーが触る画面の間にある共通窓口」です。
Codex App Serverでできること
Codexの会話や作業をアプリから操作できる
App Serverを使うと、クライアントアプリはCodexに対して「新しい作業を始める」「進捗を受け取る」「承認を返す」「差分やメッセージを表示する」といった操作ができます。
これは単純なチャットAPIとは違います。コード修正、テスト実行、ファイル変更、承認待ち、作業結果のストリーミングなど、AIエージェントらしい複数ステップの作業を扱うための仕組みです。
CLI・IDE・Webなど複数の画面で同じ仕組みを使える
CodexはCLIだけでなく、VS Code拡張やWeb、macOSアプリなどでも使われます。画面ごとにCodexの中身を作り直すのではなく、App Serverを共通窓口にすることで、同じエージェント機能を複数のUIから使えるようになります。
将来的なCodex連携の土台になる
公式記事では、App ServerはCodexを自社製品やIDE、開発者向けツールに組み込むための第一級の統合方法として説明されています。今後、Codexを外部アプリに組み込む場面では、このApp Serverの理解が重要になる可能性があります。
なぜCodexにApp Serverが必要なのか
Codex CLIだけなら、ターミナル上で動けば十分です。しかし、IDEやデスクトップアプリ、WebアプリからCodexを使う場合は、より細かい情報が必要になります。
- エージェントが今何をしているのかをリアルタイムに表示したい
- ファイル差分をUI上で見せたい
- 危険なコマンドの実行前にユーザー承認を取りたい
- 途中で画面を閉じても、作業状態を復元したい
- 複数のCodex作業を並行して扱いたい
こうした体験を作るには、単純な「リクエストを送って返事を待つ」形式では足りません。Codex App Serverは、Codexの作業をイベントとして細かく流し、アプリ側がそれを画面に反映できるようにします。
Codex App ServerとMCPの違い
Codex周辺ではMCPという言葉もよく出てきます。ここが混乱しやすいポイントです。
| 項目 | Codex App Server | MCP |
|---|---|---|
| 主な役割 | Codex本体をアプリから操作する | AIに外部ツールやデータを使わせる |
| 対象 | Codexの会話、作業、差分、承認、設定など | ファイル、DB、API、SaaS、社内ツールなど |
| 使う人 | Codex連携アプリやIDE拡張を作る人 | AIにツール連携を追加したい人 |
| イメージ | Codexを動かすためのリモコン | AIに渡す外部ツール箱 |
覚え方：MCPは「AIが何を使えるか」を広げる仕組み。Codex App Serverは「Codexをどの画面からどう操作するか」を整える仕組みです。
codex app-serverコマンドの基本
手元のCodex CLIでは、次のコマンドでApp Server関連のヘルプを確認できます。
codex app-server --helpヘルプ上では、App Serverは experimental な機能として表示されます。主なコマンドは以下です。
| コマンド | 用途 |
|---|---|
codex app-server |
App Serverを起動する |
codex app-server proxy |
実行中のApp Server制御ソケットへstdioを中継する |
codex app-server generate-ts |
App ServerプロトコルのTypeScript型定義を生成する |
codex app-server generate-json-schema |
App ServerプロトコルのJSON Schemaを生成する |
通信方式：stdio・unix・ws
--listenオプションでは、App Serverの待ち受け方法を指定できます。デフォルトはstdio://です。
stdio://：標準入出力で通信する。ローカルアプリやIDE連携向けunix://：Unixソケットで通信するws://IP:PORT：WebSocketで通信する。非ループバックでは認証設定が重要off：ローカル通信を公開しない
初心者がいきなりWebSocketで公開する必要はありません。まずは「Codexの内部連携用に、stdioで動く仕組み」と理解しておけば十分です。
一般ユーザーは使う必要がある？
結論から言うと、普通にCodex CLIでコードを書いたり、レビューしたり、記事作成を手伝わせたりするだけなら、Codex App Serverを直接使う必要はほとんどありません。
App Serverが必要になるのは、次のようなケースです。
- Codexを自作アプリに組み込みたい
- Codex用のIDE拡張やデスクトップアプリを作りたい
- Codexの作業進捗、差分、承認フローを独自UIで表示したい
- Codexプロトコルの型定義やJSON Schemaを使って連携を作りたい
一般ユーザー向けの理解：Codex App Serverは「自分で使いこなす機能」というより、CodexをIDEやアプリに組み込むための開発者向け基盤です。
Codex App Serverを使うときの注意点
実験的機能として扱う
手元のCLIヘルプではcodex app-serverに experimental と表示されます。今後、コマンド、プロトコル、オプションが変わる可能性があります。記事や社内ドキュメントに固定仕様として書く場合は注意が必要です。
WebSocket公開時は認証を確認する
App Serverはws://IP:PORTで待ち受けることもできますが、ネットワーク越しに公開する場合は認証設定が重要です。ヘルプには capability-token や signed-bearer-token などの認証モードが表示されています。
Codexはローカルファイルやシェル実行に関わる強力なツールです。よく理解しないまま外部公開するのは避けるべきです。
MCPと混同しない
MCPは外部ツールをAIに渡す仕組みで、App ServerはCodex本体をクライアントから操作する仕組みです。どちらもJSON-RPCに近い通信を使うため似て見えますが、目的は違います。
まとめ：Codex App ServerはCodex連携の裏側を支える仕組み
Codex App Serverは、CodexをCLI、IDE、Web、デスクトップアプリなど複数の画面から使えるようにするための共通基盤です。
一般ユーザーが直接操作する場面は多くありませんが、Codexをアプリに組み込む開発者にとっては、会話、作業進捗、差分、承認、設定などを扱う重要なインターフェースになります。
まずは「MCPは外部ツール連携、App ServerはCodex本体を操作する仕組み」と整理しておくと、Codex周辺の技術が理解しやすくなります。
