Codex CLIでMCPを設定・接続する方法｜手順と活用例を解説

｜広告運用ノウハウ公開中！

サービス紹介資料はこちらからダウンロード

OpenAIのCodex CLIは、ターミナルから使えるAIコーディングエージェントです。ここにMCP（Model Context Protocol）でツールやサービスを接続すると、Codexが外部のデータを参照したり、ツールを操作したりできるようになります。

この記事では、Codex CLIにMCPサーバーを追加する手順（コマンド／設定ファイル）と、LP最適化プラットフォーム「Squad beyond」を接続してレポートを分析する活用例までを解説します。

MCPそのものの基礎（定義・API連携との違い・マーケティング活用の全体像）は、MCPとは？マーケティングでの活用方法と事例で解説しています。本記事は「Codex CLIでの接続・活用」に絞って説明します。

1. Codex CLIのMCPとは

MCP（Model Context Protocol）は、AIツールと外部のデータ・ツールを接続するための共通の仕組みです。Codex CLIでMCPを使うと、Codexが自分の外側にあるデータ（レポートの数値、ファイル、外部サービスなど）を参照・操作できるようになります。

Codex CLIはMCPの「クライアント（接続する側）」として動作し、設定したMCPサーバー（接続される側）のツールを呼び出せます。

2. Codex CLIでMCPを使うとできること

CodexにMCPサーバーを接続すると、主に次のことができるようになります。

• データの取得（参照）：外部サービスのレポートやファイルをCodexが読み取る
• ツールの操作：Codexから外部ツールに対して、検索・データ更新などを実行する

たとえばWeb検索MCPを接続すれば最新情報を取得しながらコーディングでき、レポート系MCPを接続すれば成果データを参照しながら分析を依頼できます。

3. Codex CLIでMCPを使うための前提

• Codex CLIが利用できる環境：Codex CLIをインストール済みであること（ターミナルでの操作が前提です）。
• 接続方法はサーバーの種類で分かれる：ローカルで動くサーバー（STDIO）は codex mcp add コマンド、リモートのHTTPサーバー（Squad beyondなど外部サービス）は設定ファイル（config.toml）にURLを記述します（次章で解説）。
• 接続先サービスの対応：接続したいサービスがMCPに対応している必要があります。リモートサーバーの場合は認証（OAuthなど）が必要なことがあります。

どのツールを接続するか迷う場合は、MCP対応ツール・サーバーの選び方と比較で用途別に整理しています。

4. Codex CLIにMCPサーバーを追加する手順

4-1. ローカルサーバーをコマンドで追加する（STDIO）

自分のPC上で動くサーバー（STDIO）は、codex mcp add コマンドで手軽に追加できます。

codex mcp add <サーバー名> -- <実行コマンド>

例（Context7を追加する場合）：

codex mcp add context7 -- npx -y @upstash/context7-mcp

※codex mcp add はローカル（STDIO）サーバー向けのコマンドです。リモートのHTTPサーバーは、次の4-2の方法で設定します。

4-2. リモートサーバーを設定ファイル（config.toml）で追加する

Squad beyondのようなリモートのHTTPサーバーは、~/.codex/config.toml（またはプロジェクト内の .codex/config.toml）にURLを記述します。

[mcp_servers.サーバー名]url = "https://example.com/mcp"bearer_token_env_var = "TOKEN_ENV_VAR"   # 任意：トークンを入れた環境変数名

　

• 固定のヘッダーが必要な場合は http_headers を指定できます。
• OAuthに対応したサーバーは、codex mcp login <サーバー名> を実行すると、ブラウザが開いて認証されます。

4-3. 登録の確認と管理

• 動作確認：
  Codex TUI内で /mcp を実行すると、有効なサーバーとツールが表示されます。
• 一覧・詳細：
  codex mcp list で登録済みサーバーを確認できます（バージョンにより codex mcp get <名前> で詳細表示）。
• ツールの制御：
  設定で enabled_tools / disabled_tools を指定し、使用するツールを絞れます。

より詳しい仕様・最新の手順は、Codex公式ドキュメント「Model Context Protocol」を参照してください。

5. 【実例】Squad beyond MCPをCodex CLIに接続してLPを分析する

LP最適化プラットフォームのSquad beyondはMCPに対応しており、Codex CLIから直接データを参照・分析できます。

5-1. Codexへの接続

Squad beyondはリモートのHTTPサーバーとして提供されています。4-2の手順で config.toml にサーバーURLを記述し、codex mcp login でOAuth認証します。

[mcp_servers.squadbeyond]url = "https://squadbeyond-mcp-server-production.squadbeyond.workers.dev/mcp"

• 対応：Codex CLIが利用できる環境
• MCPサーバーURL：https://squadbeyond-mcp-server-production.squadbeyond.workers.dev/mcp
• 認証方式：OAuth（codex mcp login squadbeyond でブラウザ認証）

接続後に取得できるデータは、Squad beyond上のアカウント権限に連動します。

接続手順の詳細は、Squad beyond公式ヘルプのMCPの接続・設定方法を参照してください。

5-2. Codexからできること

接続すると、CodexからSquad beyond上の次のようなデータを扱えます。

• 日次・週次・月次のレポートデータ（PV・CV・CVRなど）の取得
• ステータスやフォルダ単位でのページ一覧の取得
• CVRや流入元、離脱状況などのパフォーマンス分析
• Branch Operation（バージョン×クリエイティブの掛け合わせ）の分析

5-3. 活用例

「今週のレポートを取得して、CVRが高い順にLPをランキングして」

このように自然文で指示するだけで、Codexがデータを参照してランキング化や分析を行います。媒体別のCVR比較や、週次レポートの下書き生成も同様に依頼できます。

取得したデータをもとにした検証の進め方は、ABテストのやり方で解説しています。

6. Codex CLIでMCPを使うときの注意点

• ツールの権限管理：enabled_tools / disabled_tools で使用するツールを絞り、書き込みを伴うツールは慎重に扱います。
• 認証情報の管理：トークンは環境変数で管理し、設定ファイルに直書きしないようにします。
• レート制限：Squad beyond MCPの場合、リクエストは1分間に10回までです（約1分で自動解除）。
• 権限との連動：取得できるデータはアカウント権限に紐づきます。権限のないデータは参照できません。
• つながらないとき：/mcp でサーバーが表示されない場合は、config.toml の構文エラー、OAuth認証の未完了、サーバーの起動タイムアウト（必要に応じて startup_timeout_sec を延長）を確認します。設定変更後はCodexを再起動します。

書き込みを伴うツールを使う際の注意点は、MCP導入のセキュリティと注意点で詳しく解説しています。

7. Codex CLIのMCPについてよくある質問（FAQ）

8. まとめ

Codex CLIはMCPに対応しており、ツールやサービスを接続すれば、ターミナルからAIが外部データを直接参照・操作できるようになります。

• ローカル（STDIO）サーバーは codex mcp add、リモートのHTTPサーバーは config.toml にURLを記述する
• リモートサーバーはURLを記述し、OAuthに対応するサーバーは codex mcp login でブラウザ認証する
• Squad beyond MCPに対応しており、レポート取得やLP分析を自然文の指示だけで実行できる

まずはWeb検索やレポート系のサーバーを1つ追加し、Codexからデータを扱う体験から始めてみてください。

　

｜広告運用ノウハウ公開中！

より詳しく知りたい方は資料をダウンロード！