CodexでMCPを設定した後は、ツールが表示されなくなります。まず、サーバーが現在のクライアントによってロードされているかを確認し、その後起動、認証、ツールフィルタリングをチェックしてください。 設定をすぐに削除して再インストールしないでください。 ほとんどの問題はcodex mcp listやTUIの/mcpとクリアな再起動で特定できます。
ステップ1:改造が同じ構成であることを確認
Codexアプリ、CLI、IDE拡張機能はCodex構成を共有しており、デフォルトの位置は~/.codex/config.tomlです。 信頼できるプロジェクトも利用.codex/config.toml。 異なるCODEX_HOMEが設定されている場合や設定ファイルが切り替わった場合、現在のクライアントは別のファイルを読み取ることができます。 まずは、ランを行ってください:
codex mcp listリストにターゲット名がない場合は、現在の環境でその構成が読み取られていないことを意味します。
ステップ2:クライアントにリロードさせる
CodexアプリでMCPを保存した後、再起動をクリックします。 IDE拡張については「Restart拡張」を選択してください。 CLIで新しいセッションを開始後、TUIで/mcpを入力してサーバーの状態と公開ツールを確認します。 config.tomlを改変するだけで古いセッションを使い続けると、ツールリストが更新されないことがあります。
ステップ3:起動失敗と認証失敗の区別
STDIOサーバーはローカルコマンド、パラメータ、動作ディレクトリ、環境変数に依存しています。 設定から起動コマンドを同じターミナルにコピーし、直接実行します。 プロンプトが存在しないか依存関係が欠けている場合は、まずPATH環境とランタイム環境を修復します。 HTTPサーバーがOAuthを必要とする場合、次のように実行されます:
codex mcp login <服务器名称>承認後、クライアントを再起動してください。 サーバーがゆっくり始めると、改善startup_timeout_sec; デフォルトの起動待ち時間はわずか10秒です。
ステップ4:ツールがフィルタリングされているか確認
設定項目enabled = falseサーバー全体を無効化enabled_tools、リストに記載されたツールのみを許可disabled_tools、許可リスト以降もツールを除外し続けます。 サーバーは接続されていてツールの数がゼロの場合は、モデルを疑うのではなく、これら3つの項目を優先的にチェックしましょう。
それでもツールが利用できない場合は、/mcp、起動コマンドエラー、サーバーログで表示される状態を保持してください。 これら3つは「設定未読み込み」「プロセス未開始」「認可未完了」「ツールフィルタリング済み」を明確に区別できます。その後の修復は対応するレイヤーのみを扱います。
