Codex CLI MCP 入門ガイド：外部データとサービスを接続する

学習目標

このチュートリアルを完了すると、以下のことができるようになります：

• MCP（Model Context Protocol）とは何かを簡単な言葉で説明する
• Codex を外部データやサービスに接続する MCP サーバーを見つける
• codex mcp add コマンドで Codex CLI に MCP サーバーを追加する
• MCP サーバーが接続され、動作していることを確認する
• 会話の中で Codex に MCP ツールを使わせる

所要時間： 15–20 分

難易度： 初心者向け

対象バージョン： このチュートリアルは Codex CLI（コマンドライン版）を対象としています。MCP サーバーは codex mcp コマンドと ~/.codex/config.toml ファイルで設定します。デスクトップアプリが必要な場合は Codex デスクトップアプリ：インストールと初期設定ガイド をご覧ください。

前提条件

始める前に、以下の準備が必要です：

MCP とは？

MCP（Model Context Protocol、モデルコンテキストプロトコル）は、Codex などの AI アシスタントが外部データやサービスに接続するためのオープン標準です。すべてのツールが独自の統合を構築する代わりに、共通のプロトコルで通信する——いわば「万能プラグ」です。

MCP サーバーは、AI アシスタントにツール・データ・サービスを公開する小さなプログラムです。例えば：

• GitHub MCP サーバー：Codex が Issue の読み取り、Pull Request の作成、リポジトリの閲覧を可能に
• データベース MCP サーバー：Codex が自然言語でデータベースをクエリ可能に
• 検索 MCP サーバー：Codex がウェブ検索し、リアルタイムの結果を返せるように

MCP サーバーを追加すると、Codex は会話中にそのツールを自動的に呼び出せます——手動でデータをコピー＆ペーストする必要はありません。

Codex MCP の仕組み

Codex CLI には MCP サポートが組み込まれています。方向は2つあります：

1. 1Codex が MCP サーバーに接続する（このチュートリアルの中心）——codex mcp add でサーバーを追加し、Codex が会話中にそのツールを使えるようにする
2. 2他のツールが Codex に接続する——codex mcp-server コマンドで Codex を他の MCP クライアントに公開する（高度な使い方。FAQ で簡単に紹介）

設定は ~/.codex/config.toml の [mcp_servers.*] セクションに保存されます。codex mcp コマンドがこのファイルを自動的に編集します。

ステップ 1：MCP 設定を確認する

まず、お使いの Codex CLI が MCP をサポートしていることを確認します。ターミナルを開いて実行：

codex mcp list

表示される内容： 「MCP サーバーが設定されていません」というメッセージ（または既存のサーバー一覧）。コマンドが認識されない場合は Codex CLI を更新します：

npm install -g @openai/codex

表示される内容： 更新完了後にバージョン番号が表示されます。

ステップ 2：MCP サーバーを見つける

MCP サーバーは以下の場所で見つかります：

• Cataito の MCP ディレクトリ：/mcp を参照——55+ の厳選 MCP サーバー（GitHub、Figma、データベースなど）
• GitHub：mcp-server で検索——数千のコミュニティサーバーがあります
• npm：多くのサーバーは npx でインストールできます

このチュートリアルでは、**GitHub MCP サーバー**（Cataito 収録 55+ の MCP サーバーの一つ）を接続し、Codex がリポジトリ・Issue・Pull Request を読み取れるようにします。

別のサービス（Figma、Slack、データベース）を希望する場合も、同じ codex mcp add コマンドでOK——サーバー名とコマンドを置き換えるだけです。

ステップ 3：MCP サーバーを追加する（macOS と Linux）

macOS または Linux で、ターミナルを開いて GitHub MCP サーバーを登録します：

codex mcp add github -- npx -y @modelcontextprotocol/server-github

表示される内容： コマンドがエラーなく完了し、Codex がサーバーエントリを ~/.codex/config.toml に書き込みます。

ステップ 3：MCP サーバーを追加する（Windows）

Windows では、PowerShell を開いて GitHub MCP サーバーを登録します：

codex mcp add github -- npx -y @modelcontextprotocol/server-github

表示される内容： コマンドがエラーなく完了し、Codex がサーバーエントリを設定ファイル（%USERPROFILE%\.codex\config.toml）に書き込みます。

ステップ 4：サーバーが接続されていることを確認する

サーバーが正しく登録されたことを確認します：

codex mcp list

表示される内容： 設定済みの MCP サーバー一覧に github が表示されます。

単一のサーバーの詳細も確認できます：

codex mcp get github

表示される内容： サーバーの詳細（Codex が起動時に使用するコマンドを含む）。

ステップ 5：会話で MCP ツールを使う

Codex セッションを起動し、GitHub ツールを使わせます：

codex

次に、接続したサービスを利用するプロンプトを入力します。例：

facebook/react リポジトリのオープン Issue を一覧表示して

表示される内容： Codex が GitHub MCP サーバーのツールを自動的に呼び出し、データを取得して要約します。サーバーを追加した後は、MCP ツールはすべてのセッションで利用可能です——追加の設定は不要です。

ステップ 6：サーバーの削除または無効化（任意）

サーバーが不要になった場合は削除します：

codex mcp remove github

表示される内容： サーバーが codex mcp list から消えます。

エントリは残して Codex に読み込ませないようにするには、~/.codex/config.toml の該当行の先頭に # を付けてコメントアウトします。

トラブルシューティング

よくある質問

MCP を使うのに有料プランは必要ですか？ いいえ。MCP サポートは Codex CLI の一部で、ChatGPT プランと API キー認証の両方で利用できます。

別のモデルで MCP サーバーを使えますか？ はい——Codex がどのモデルを使っても、MCP ツールは利用可能です。

MCP 設定はどこに保存されますか？ ~/.codex/config.toml（macOS/Linux）または %USERPROFILE%\.codex\config.toml（Windows）の [mcp_servers.*] セクションです。

プロジェクト単位でサーバーを追加できますか？ はい——新しいバージョンの Codex では codex mcp add --scoped <名前> -- <コマンド> で、グローバルではなくプロジェクトの .codex/config.toml に書き込めます。

他のツールから MCP 経由で Codex を使えますか？ はい——codex mcp-server を実行すると、Codex CLI を他の MCP クライアント（Claude Code や Cursor など）に公開できます。これは高度な使い方です。詳細は Codex のドキュメントをご覧ください。

次のステップ

• データベース MCP サーバーを試し、自然言語でデータをクエリする
• 公式 MCP ディレクトリを探索し、自分のワークフローに合うサーバーを見つける
• Codex CLI 入門ガイド で Codex CLI のコマンドをさらに学ぶ
• グラフィカルインターフェースが好みなら Codex デスクトップアプリ：インストールと初期設定ガイド をご覧ください