Codexの設定 - MCPサーバのソースを表示

== 概要 ==
MCP (Model Context Protocol) は、LLMと外部ツールの統合を標準化したオープンプロトコルである。<br>
<br>
OpenAI Codex CLIは、このプロトコルに対応しており、MCPサーバを設定することにより、ドキュメント参照、ブラウザ操作、デザインツール、イシュートラッカー、GitHubリポジトリ管理など多様な外部システムと連携できる。<br>
<br>
Codex CLIのMCP設定の主な特長を以下に示す。<br>
* Codex CLI と IDE Extensionの設定共有
*: <u>~/.codex/config.toml</u> のユーザ設定はCLIとVS Code拡張機能の両方で共有される。
* TOML形式の設定ファイル
*: MCPサーバはTOML形式の設定ファイルで管理される。
* 2つのトランスポート方式
*: ローカルプロセス起動のSTDIO方式 と URLによるStreamable HTTP方式をサポートする。
* Skillsとの連携
*: Skillsファイルから必要なMCPサーバの依存関係を宣言でき、スキル実行時に自動的にロードされる。
<br>
下表に、Codex CLIのMCP連携により接続できる主な外部システムを示す。<br>
<br>
<center>
{| class="wikitable"
|+ MCP連携の主な用途
! カテゴリ !! 主な用途 !! 例
|-
| ドキュメント || 最新の公式ドキュメント参照 || Context7
|-
| ブラウザ || ウェブ操作・スクレイピング || Chrome DevTools、Playwright
|-
| デザイン || UIデザインファイル参照 || Figma
|-
| イシュー管理 || タスク・課題管理 || Linear、GitHub Issues
|-
| バージョン管理 || リポジトリ操作 || GitHub MCP
|-
| ファイルシステム || ローカルファイル操作 || Filesystem MCP
|}
</center>
<br><br>

== 設定ファイルの保存場所 ==
MCPサーバの設定は、ユーザスコープとプロジェクトスコープの2つの場所で管理される。<br>
<br>
<center>
{| class="wikitable"
|+ 設定ファイルの保存場所
! スコープ !! ファイルパス !! 説明
|-
| ユーザ (グローバル) || <u>~/.codex/config.toml</u> || 全プロジェクトで共通のMCPサーバ設定<br>Codex CLIとIDE Extension (VS Code等) で共有される。
|-
| プロジェクト || <u>.codex/config.toml</u> || プロジェクトルートに配置するプロジェクト固有の設定<br>信頼済みのプロジェクトとして承認された場合のみロードされる。
|}
</center>
<br>
プロジェクトスコープの設定ファイルは、Codexがそのプロジェクトディレクトリを信頼済みとして認識した場合にのみ読み込まれる。<br>
これにより、クローンしたばかりの第三者リポジトリが自動的に任意のMCPサーバを起動するリスクを回避できる。<br>
<br><br>

== 2つのトランスポート方式 ==
Codex CLIのMCPサーバは、2つのトランスポート方式をサポートしている。<br>
<br>
==== STDIOサーバ (ローカルプロセス起動) ====
STDIOサーバは、ローカルプロセスとして起動してstdin/stdoutで通信するトランスポート方式である。<br>
<br>
ファイルシステム操作、コード解析ツール等、システムリソースへの直接アクセスが必要なツールに適している。<br>
<br>
STDIOサーバの設定では、<code>command</code>、<code>args</code>、<code>env</code> を使用してプロセスを起動する。<br>
<br>
TOMLサンプルを以下に示す。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.context7]
 command = "npx"
 args = ["-y", "@upstash/context7-mcp"]
 
 [mcp_servers.filesystem]
 command = "npx"
 args = ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
 env = { LOG_LEVEL = "info" }
 cwd = "/home/user"
 startup_timeout_sec = 15
 tool_timeout_sec = 60
 </syntaxhighlight>
<br>
==== HTTPサーバ (Streamable HTTP) ====
HTTPサーバは、URLを指定してHTTP経由で通信するトランスポート方式である。<br>
<br>
クラウドサービスやリモートAPIへの接続に適しており、GitHub MCP等のWebサービスとの連携に使用される。<br>
<br>
HTTPサーバの設定では、<code>url</code> にサーバのエンドポイントを指定する。<br>
認証が必要な場合は、<code>bearer_token_env_var</code> または <code>http_headers</code> を使用する。<br>
<br>
TOMLサンプルを以下に示す。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.github_mcp]
 url = "http://localhost:3000/mcp"
 bearer_token_env_var = "GITHUB_TOKEN"
 startup_timeout_sec = 15
 tool_timeout_sec = 90
 
 [mcp_servers.remote_api]
 url = "https://api.example.com/mcp"
 http_headers = { "X-Custom-Header" = "custom-value" }
 env_http_headers = { "Authorization" = "API_KEY_ENV_VAR" }
 enabled = true
 </syntaxhighlight>
<br><br>

== TOML設定オプション ==
各MCPサーバで使用できる設定オプションを示す。<br>
<br>
==== STDIO Server用設定 ====
下表に、STDIOトランスポート方式で使用できる設定オプションを示す。<br>
<br>
<center>
{| class="wikitable"
|+ STDIO Server設定オプション
! オプション !! 型 !! デフォルト !! 説明
|-
| <code>command</code> || 文字列 || (必須) || 起動するコマンド<br>例: <code>"npx"</code>、<code>"node"</code>、<code>"python"</code>
|-
| <code>args</code> || 文字列配列 || [] || コマンドに渡す引数リスト<br>例: <code>["-y", "@upstash/context7-mcp"]</code>
|-
| <code>env</code> || テーブル || {} || プロセスに渡す環境変数<br>例: <code>{ API_KEY = "value" }</code>
|-
| <code>cwd</code> || 文字列 || (なし) || プロセスの作業ディレクトリ<br>省略時はCodexの作業ディレクトリを使用する。
|-
| <code>startup_timeout_sec</code> || 整数 || 10 || サーバ起動完了を待機する最大秒数
|-
| <code>tool_timeout_sec</code> || 整数 || 60 || ツール呼び出しの完了を待機する最大秒数
|-
| <code>enabled</code> || 真偽値 || true || <code>false</code> に設定すると、このサーバを無効化する。
|-
| <code>required</code> || 真偽値 || false || <code>true</code> にすると、サーバが起動できない場合にCodexの起動を中止する。
|}
</center>
<br>
==== HTTP Server用設定 ====
下表に、HTTPトランスポート方式で使用できる設定オプションを示す。<br>
<br>
<center>
{| class="wikitable"
|+ HTTP Server設定オプション
! オプション !! 型 !! デフォルト !! 説明
|-
| <code>url</code> || 文字列 || (必須) || MCPサーバのエンドポイントURL<br>例: <code>"https://api.example.com/mcp"</code>
|-
| <code>bearer_token_env_var</code> || 文字列 || (なし) || BearerトークンとなるAPIキーを格納した環境変数名<br>例: <code>"GITHUB_TOKEN"</code>
|-
| <code>http_headers</code> || テーブル || {} || 静的なHTTPヘッダ<br>例: <code>{ "X-Custom" = "value" }</code>
|-
| <code>env_http_headers</code> || テーブル || {} || 環境変数を参照するHTTPヘッダ<br>例: <code>{ "Authorization" = "TOKEN_ENV_VAR" }</code>
|-
| <code>startup_timeout_sec</code> || 整数 || 10 || サーバへの初回接続確立を待機する最大秒数
|-
| <code>tool_timeout_sec</code> || 整数 || 60 || ツール呼び出しの完了を待機する最大秒数
|-
| <code>enabled</code> || 真偽値 || true || <code>false</code> に設定すると、このサーバを無効化する。
|}
</center>
<br><br>

== codex mcpサブコマンド ==
下表に、MCPサーバを管理するためのCLIサブコマンドを示す。<br>
<br>
<center>
{| class="wikitable"
|+ codex mcp サブコマンド一覧
! コマンド !! 説明
|-
| <code>codex mcp add &lt;name&gt; -- &lt;command&gt;</code> || STDIOサーバをユーザ設定に追加する。
|-
| <code>codex mcp list</code> || 設定済みのMCPサーバ一覧を表示する。
|-
| <code>codex mcp list --json</code> || MCPサーバ一覧をJSON形式で出力する。
|-
| <code>codex mcp get &lt;name&gt;</code> || 指定したMCPサーバの設定詳細を表示する。
|-
| <code>codex mcp get &lt;name&gt; --json</code> || 指定したMCPサーバの設定詳細をJSON形式で出力する。
|-
| <code>codex mcp login &lt;name&gt;</code> || 指定したHTTPサーバのOAuth認証フローをブラウザで開始する。
|-
| <code>codex mcp logout &lt;name&gt;</code> || 指定したHTTPサーバのOAuth認証情報をキャッシュから削除する。
|-
| <code>codex mcp remove &lt;name&gt;</code> || 指定したMCPサーバをユーザ設定から削除する。
|}
</center>
<br>
各コマンドの使用例を以下に示す。<br>
<br>
 # サーバ一覧を表示
 codex mcp list
 
 # JSON形式で出力
 codex mcp list --json
 
 # 特定サーバの詳細を確認
 codex mcp get context7
 
 # サーバを削除
 codex mcp remove context7
<br><br>

== CLI でサーバを追加する例 ==
<code>codex mcp add</code> コマンドを使用して、対話なしにMCPサーバを追加できる。<br>
<br>
基本的なコマンド形式を以下に示す。<br>
<br>
 codex mcp add <name> -- <command> [args...]
<br>
==== 例1: Context7 (ドキュメント参照) ====
Context7 MCPサーバを追加する例を以下に示す。<br>
<br>
 codex mcp add context7 -- npx -y @upstash/context7-mcp
<br>
==== 例2: 環境変数を指定してサーバを追加 ====
<code>--env</code> オプションで環境変数を指定してサーバを追加する例を以下に示す。<br>
<br>
 codex mcp add my_server --env API_KEY=mykey -- node /path/to/server.js
<br>
APIキーを直接コマンドラインに記述する代わりに、シェルの環境変数から参照することも可能である。<br>
<br>
 codex mcp add my_server --env API_KEY=$MY_API_KEY -- node /path/to/server.js
<br>
==== 例3: 複数引数 (Chrome DevTools) ====
Chrome DevTools MCPサーバのように複数の引数が必要な場合の例を以下に示す。<br>
<br>
 codex mcp add chrome_devtools -- npx -y @modelcontextprotocol/server-puppeteer --headless false --port 9222
<br>
追加後は、<code>codex mcp get</code> コマンドで設定内容を確認できる。<br>
<br>
 codex mcp get chrome_devtools
<br><br>

== OAuth設定 (HTTPサーバ) ==
HTTPサーバでOAuth認証を使用する場合の設定方法を示す。<br>
<br>
==== グローバル設定 ====
OAuth認証に関するグローバル設定は、<code>mcp_oauth_callback_port</code> および <code>mcp_oauth_callback_url</code> で行う。<br>
<br>
デフォルトでは、Codexはエフェメラルポート (OS が自動割り当てする使用中でないポート) を使用してOAuthコールバックを受け付ける。<br>
固定ポートが必要な場合は <code>mcp_oauth_callback_port</code> に明示的なポート番号を指定する。<br>
<br>
 <syntaxhighlight lang="toml">
 # OAuthコールバックを受け付ける固定ポート (省略時はエフェメラルポート)
 mcp_oauth_callback_port = 3939
 
 # リバースプロキシ等を使用する場合はコールバックURLを明示指定
 mcp_oauth_callback_url = "https://example.com/callback"
 </syntaxhighlight>
<br>
==== サーバ設定と login コマンド ====
OAuth対応のHTTPサーバを設定して認証を行う手順を以下に示す。<br>
<br>
まず、TOMLファイルにサーバを定義する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.github_mcp]
 url = "https://api.githubcopilot.com/mcp/"
 startup_timeout_sec = 20
 tool_timeout_sec = 120
 </syntaxhighlight>
<br>
次に、以下に示すコマンドでブラウザ経由のOAuth認証フローを開始する。<br>
<br>
 codex mcp login github_mcp
<br>
コマンドを実行するとブラウザが開き、OAuthプロバイダの認証ページが表示される。<br>
認証を完了すると、アクセストークンがローカルにキャッシュされ、以降のリクエストで自動的に使用される。<br>
<br>
認証情報を削除する場合は以下のコマンドを実行する。<br>
<br>
 codex mcp logout github_mcp
<br><br>

== HTTPヘッダ設定 ==
HTTPサーバでカスタムヘッダを使用する2つの方法を示す。<br>
<br>
==== 静的ヘッダ (http_headers) ====
固定値のHTTPヘッダを設定する場合は <code>http_headers</code> を使用する。<br>
<br>
設定ファイルに平文で記載される値であるため、機密情報以外のヘッダに使用することを推奨する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.custom_service]
 url = "https://api.example.com/mcp"
 
 [mcp_servers.custom_service.http_headers]
 "X-Service-Version" = "v2"
 "X-Client-Name"     = "codex-cli"
 "Content-Type"      = "application/json"
 </syntaxhighlight>
<br>
==== 環境変数参照ヘッダ (env_http_headers) ====
APIキーやトークン等の機密情報を含むヘッダは、<code>env_http_headers</code> を使用して環境変数から参照する。<br>
テーブルのキーはHTTPヘッダ名、値は参照する環境変数名を指定する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.secure_api]
 url = "https://secure.example.com/mcp"
 
 [mcp_servers.secure_api.http_headers]
 "X-Service-Version" = "v1"
 
 [mcp_servers.secure_api.env_http_headers]
 "Authorization" = "SECURE_API_TOKEN"
 "X-API-Key"     = "SECURE_API_KEY"
 </syntaxhighlight>
<br>
上記の設定では、実行時に環境変数 <code>SECURE_API_TOKEN</code> の値が <u>Authorization</u> ヘッダとして送信される。<br>
<br><br>

== タイムアウト設定のガイドライン ==
MCPサーバのタイムアウト設定には、<code>startup_timeout_sec</code> と <code>tool_timeout_sec</code> の2つのオプションがある。<br>
<br>
* <code>startup_timeout_sec</code>
*: サーバの起動完了またはHTTP接続確立を待機する最大秒数
*: デフォルトは10秒
*: npmパッケージのダウンロードが必要なSTDIOサーバや初期化処理が重いサーバは延長する。
* <code>tool_timeout_sec</code>
*: ツール呼び出しの完了を待機する最大秒数
*: デフォルトは60秒
*: データベースクエリ、外部API呼び出し、ファイル処理等の処理時間に応じて調整する。
<br>
下表に、用途別のタイムアウト調整ガイドを示す。<br>
<br>
<center>
{| class="wikitable"
|+ タイムアウト設定ガイド
! 用途・環境 !! startup_timeout_sec !! tool_timeout_sec !! 説明
|-
| 高速STDIOサーバ || 5〜10秒 || 30〜60秒 || ローカルスクリプト等、すぐに起動するサーバ
|-
| npmパッケージ起動 || 15〜30秒 || 60〜120秒 || 初回起動時にダウンロードが発生するサーバ
|-
| HTTPサーバ || 15〜30秒 || 60〜120秒 || ネットワーク遅延を考慮した設定
|-
| Docker等大規模初期化 || 30〜60秒 || 60〜180秒 || コンテナ起動等、初期化に時間がかかる環境
|-
| 長時間処理ツール || 10〜30秒 || 60〜300秒 || 大規模ファイル処理、長時間クエリ等
|}
</center>
<br><br>

== アクティブMCPサーバの確認 ==
セッション中にアクティブなMCPサーバとツールの状態を確認する方法を示す。<br>
<br>
Codexのチャット画面で以下のスラッシュコマンドを入力することにより、現在接続中のMCPサーバ一覧と各サーバが提供するツールの一覧を確認できる。<br>
<br>
 /mcp
<br>
詳細情報を確認する場合は、以下に示すコマンドを実行する。<br>
<br>
 /mcp verbose
<br>
<code>/mcp verbose</code> では、各サーバの接続状態、利用可能なツール一覧、ツールのパラメータ情報、最終接続時刻等の詳細情報が表示される。<br>
<br><br>

== MCPサーバ設定サンプル ==
代表的なMCPサーバの設定例を示す。<br>
<br>
==== Context7 (ドキュメント) ====
最新の公式ドキュメントをCodexに提供するContext7の設定例を以下に示す。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.context7]
 command = "npx"
 args    = ["-y", "@upstash/context7-mcp"]
 startup_timeout_sec = 20
 tool_timeout_sec    = 60
 enabled  = true
 required = false
 </syntaxhighlight>
<br>
==== GitHub MCP (HTTP + OAuth) ====
GitHub MCP ServerをOAuth認証で使用する場合の設定例を以下に示す。<br>
<br>
設定後、<code>codex mcp login github</code> を実行してOAuth認証を行う。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.github]
 url                 = "https://api.githubcopilot.com/mcp/"
 startup_timeout_sec = 20
 tool_timeout_sec    = 120
 enabled             = true
 </syntaxhighlight>
<br>
==== ローカルFilesystemサーバ ====
ローカルファイルシステムを操作するMCPサーバの設定例を以下に示す。<br>
<br>
<code>args</code> の末尾にアクセスを許可するディレクトリパスを指定する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.filesystem]
 command = "npx"
 args    = ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
 cwd     = "/home/user"
 startup_timeout_sec = 15
 tool_timeout_sec    = 60
 </syntaxhighlight>
<br>
==== カスタム環境変数を使用 ====
環境変数でAPIキーを渡すカスタムMCPサーバの設定例を以下に示す。<br>
<br>
<code>config.toml</code> に平文のシークレットを記載せず、環境変数から参照することを推奨する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.my_api_server]
 command = "node"
 args    = ["/home/user/.local/bin/my-mcp-server/index.js"]
 cwd     = "/home/user/.local/bin/my-mcp-server"
 startup_timeout_sec = 10
 tool_timeout_sec    = 60
 
 [mcp_servers.my_api_server.env]
 API_KEY      = "${MY_API_KEY}"
 API_ENDPOINT = "https://api.example.com"
 LOG_LEVEL    = "info"
 </syntaxhighlight>
<br><br>

== セキュリティと認証 ==
MCPサーバの認証設定とセキュリティ上の注意事項を示す。<br>
<br>
==== Bearer Token認証 (bearer_token_env_var) ====
HTTPサーバへの認証にBearerトークンを使用する場合は <code>bearer_token_env_var</code> を利用する。<br>
<br>
この設定では、指定した環境変数の値が自動的に <code>Authorization: Bearer &lt;value&gt;</code> ヘッダとして送信される。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.private_api]
 url                  = "https://private.example.com/mcp"
 bearer_token_env_var = "PRIVATE_API_TOKEN"
 </syntaxhighlight>
<br>
==== カスタムヘッダ認証 ====
BearerトークンではなくAPIキーをカスタムヘッダで送信する場合は <code>env_http_headers</code> を使用する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.api_key_service]
 url = "https://service.example.com/mcp"
 
 [mcp_servers.api_key_service.env_http_headers]
 "X-API-Key" = "SERVICE_API_KEY"
 </syntaxhighlight>
<br>
==== APIキーの安全な管理 ====
APIキーを安全に管理するための推奨事項を以下に示す。<br>
<br>
* <u>config.toml</u> に平文のAPIキーを直接記載しない。
*: 環境変数 (<code>${ENV_VAR}</code>) または <code>bearer_token_env_var</code>、<code>env_http_headers</code> を使用して参照する。
*: <br>
* <u>~/.codex/config.toml</u> はホームディレクトリに配置されるため、パーミッションを確認する。
*: <code>chmod 600 ~/.codex/config.toml</code> を実行して読み取り権限を制限することを推奨する。
*: <br>
* プロジェクトの <u>.codex/config.toml</u> をGitリポジトリに含める場合は、APIキー等の機密情報を記載しない。
*: <u>.gitignore</u> に <u>.codex/config.toml</u> を追加することを検討する。
<br><br>

== Codex自体をMCPサーバとして起動 ==
Codex CLI自体をMCPサーバとして起動し、他のツールやクライアントから接続することができる。<br>
<br>
以下に示すコマンドを実行して、Codexをstdio経由のMCPサーバとして起動する。<br>
<br>
 codex mcp serve
<br>
この機能の主な用途を以下に示す。<br>
* 他のAIツールやMCPクライアントからCodexの機能を呼び出す。
* Claude Desktop等のMCPクライアントでCodexをツールとして使用する。
* 複数のAIエージェントを連携させるマルチエージェント構成を構築する。
<br>
Claude Desktop等からCodexをMCPサーバとして使用する場合の設定例を以下に示す。<br>
<br>
 <syntaxhighlight lang="json">
 {
    "mcpServers": {
       "codex": {
          "command": "codex",
          "args": ["mcp", "serve"]
       }
    }
 }
 </syntaxhighlight>
<br>
<code>codex mcp serve</code> はダウンストリームクライアントが接続を終了するまで実行し続け、クライアント終了時に自動的に終了する。<br>
<br><br>

== MCPとSkillsの連携 ==
Skillsファイルの <u>agents/openai.yaml</u> にMCPサーバの依存関係を宣言することにより、スキル実行時に必要なMCPサーバが自動的にロードされる。<br>
<br>
==== agents/openai.yaml によるMCP依存宣言 ====
スキルが必要とするMCPサーバを <code>mcpServers</code> フィールドに列挙する。<br>
<br>
 <syntaxhighlight lang="yaml">
 # agents/openai.yaml
 name: my-skill
 description: ドキュメント参照とGitHub操作が必要なスキル
 
 mcpServers:
    - context7
    - github
 </syntaxhighlight>
<br>
==== 依存MCPサーバの自動ロード ====
<code>mcpServers</code> に列挙したサーバは、スキルのトリガー時にCodexが自動的に起動・接続する。<br>
<br>
設定ファイル (<u>config.toml</u>) にそのサーバが定義されていない場合のふるまいは、feature flagにより制御される。<br>
<br>
* 不足しているMCPの自動インストール機能
*: デフォルト: 有効
*: 設定ファイルに存在しないMCPサーバがスキルに宣言されている場合、Codexは自動的にインストールを試みる。
*: この機能はデフォルトで有効になっており、必要なサーバが未設定でもスキルを実行できる。
<br>
==== yamlサンプル ====
複数のMCPサーバに依存するスキルの設定例を以下に示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 # agents/openai.yaml
 name: full-stack-review
 description: フルスタックコードレビュースキル。ドキュメント参照、GitHub操作、ファイルシステムアクセスを使用する。
 
 mcpServers:
    - context7
    - github
    - filesystem
 
 model: o4-mini
 temperature: 0.2
 </syntaxhighlight>
<br><br>

== よくある設定パターン ==
==== 複数のSTDIOサーバを同時に使用 ====
複数のMCPサーバを同時に設定する場合の例を以下に示す。<br>
各サーバは独立したプロセスとして管理される。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.context7]
 command = "npx"
 args    = ["-y", "@upstash/context7-mcp"]
 
 [mcp_servers.filesystem]
 command = "npx"
 args    = ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
 
 [mcp_servers.sequential_thinking]
 command = "npx"
 args    = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
 </syntaxhighlight>
<br>
==== 起動が遅いサーバ向けのタイムアウト調整 (Docker例) ====
Dockerコンテナとして起動するMCPサーバや初期化に時間が掛かるMCPサーバは、<code>startup_timeout_sec</code> を延長する。<br>
<br>
 <syntaxhighlight lang="toml">
 [mcp_servers.db_server]
 command = "docker"
 args    = ["run", "--rm", "-i", "-e", "DATABASE_URL", "my-db-mcp-image:latest"]
 startup_timeout_sec = 60
 tool_timeout_sec    = 180
 required = false
 
 [mcp_servers.db_server.env]
 DATABASE_URL = "${DATABASE_URL}"
 </syntaxhighlight>
<br>
==== プロジェクトスコープのMCP ====
プロジェクト固有のMCPサーバは <u>.codex/config.toml</u> に定義して、チームで共有する。<br>
機密情報を含まない設定のみをリポジトリにコミットすることを推奨する。<br>
<br>
 <syntaxhighlight lang="toml">
 # .codex/config.toml (プロジェクトルート)
 [mcp_servers.project_docs]
 command = "npx"
 args    = ["-y", "@upstash/context7-mcp"]
 
 [mcp_servers.project_linter]
 command = "node"
 args    = ["./tools/mcp-linter/index.js"]
 cwd     = "."
 startup_timeout_sec = 10
 tool_timeout_sec    = 30
 </syntaxhighlight>
<br><br>

== トラブルシューティング ==
MCPサーバが正常に動作しない場合の対処方法を示す。<br>
<br>
==== Startup Timeoutエラー ====
サーバの起動がタイムアウトする場合の確認事項と対処方法を以下に示す。<br>
<br>
* 原因と確認事項
*: <code>command</code> で指定したコマンドが正しくインストールされていない。
*: npmパッケージの初回ダウンロードに時間がかかっている。
*: <code>cwd</code> で指定したディレクトリが存在しない。
* 対処方法
*: <code>startup_timeout_sec</code> の値を20〜60秒に増やす。
*: コマンドを手動で実行して正常に起動することを確認する。
*: npmパッケージの場合は事前に <code>npx -y &lt;package&gt;</code> を実行してキャッシュしておく。
<br>
 # STDIOサーバを手動で起動して動作確認
 npx -y @upstash/context7-mcp
 
 # 設定内容を確認
 codex mcp get context7
<br>
==== Tool Timeoutエラー ====
ツール呼び出しがタイムアウトする場合の確認事項と対処方法を以下に示す。<br>
<br>
* 原因と確認事項
*: 処理に時間がかかる操作 (大規模ファイル処理、重いデータベースクエリ等) を実行している。
*: ネットワーク遅延やサーバの応答が遅い。
* 対処方法
*: <code>tool_timeout_sec</code> の値を120〜300秒に増やす。
*: 大規模な操作を分割して小さなリクエストに分ける。
<br>
==== HTTP接続失敗 ====
HTTPサーバへの接続に失敗する場合の確認事項と対処方法を以下に示す。<br>
<br>
* 原因と確認事項
*: <code>url</code> で指定したエンドポイントに誤りがある。
*: 認証トークンが無効または期限切れである。
*: ファイアウォールやプロキシが接続をブロックしている。
* 対処方法
*: <code>curl</code> コマンドでエンドポイントへの接続を確認する。
*: <code>bearer_token_env_var</code> に指定した環境変数が正しく設定されているか確認する。
*: OAuthを使用している場合は <code>codex mcp logout &lt;name&gt;</code> を実行してから再度 <code>codex mcp login &lt;name&gt;</code> で認証し直す。
<br>
 # HTTPエンドポイントへの接続確認
 curl -v https://api.example.com/mcp
 
 # 環境変数の確認
 echo $GITHUB_TOKEN
 
 # OAuth再認証
 codex mcp logout github
 codex mcp login github
<br><br>

== 関連ページ ==
* [[Codexの設定 - 機能]]
* [[Codexの設定 - サブエージェント]]
* [[Codexの設定 - SKILL]]
* [[MCPサーバ - Context7]]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Codex,OpenAI,Codex CLI,MCP,Model Context Protocol,AI,Development,Programming,SUSE,Linux,TOML,OAuth
|description={{PAGENAME}} - OpenAI Codex CLIのMCPサーバ設定に関する手順 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]