Codex CLI MCP 設定と安全な利用ガイド

MCP は変化する外部データやアクション、例えば公式ドキュメント、チケット、データベース、制御されたビジネス API への接続に適しています。静的なリポジトリルールは AGENTS.md に、再利用可能なローカルプロセスは Skill に置き、要件ごとに常駐サーバーを導入しないでください。

MCP Server はそれぞれがツールの接触面と信頼境界を拡大します。インストール前にメンテナ、転送方式、必要な認証情報、実行可能なアクション、データの行き先を確認してください。

まず目的が明確な読み取り専用サーバーを1つ追加し、設定、ツールの発見、削除フローに慣れてください。OpenAI Developer Docs MCP は公開ドキュメントの検索を提供し、コマンドにキーを入れる必要はありません。

リモートの HTTP サーバーは --url を使用し、ローカルの stdio サーバーはダブルダッシュの後に実行可能なコマンドを指定します。出所が信頼できると確認した場合のみ、Codex にローカルサーバープロセスの起動を許可してください。

stdio 設定は Codex によってローカルコマンドを起動し、--env でそのプロセス専用の環境変数を渡せます。HTTP 設定は URL に接続し、--bearer-token-env-var で token を保存する環境変数名を指定できます。

パラメータには環境変数名のみを記述し、token の値をコマンドや設定に直接書き込まないでください。OAuth サービスは codex mcp login を使用し、具体的な能力はサーバーに依存します。

サーバーを追加した後、プロンプトでどのソースを使うか、どのアクションを許可するか、読み取り専用かどうかを指示してください。デフォルトでツールがチケットを書いたり、データベースを変更したり、メッセージを送信したりしないようにしてください。

外部コンテンツにはプロンプトインジェクションや誤った情報が含まれる可能性があります。Codex はツールの結果をデータとして扱い、重要な意思決定はリポジトリの証拠や公式ソースとクロスチェックしてください。

共有 MCP 設定はコードレビューまたは管理者による管理を経るべきで、個人資格情報はユーザー環境に留める。ツール名、用途、責任者が追跡可能であり、期限切れサーバーは適時に削除される必要がある。

サーバーがアクセス可能なデータが、現在のタスクで読み取るべきものとは限らない。最小権限の原則に従い、特に本番データベース、個人文書、外部送信メッセージ機能を同時に広範なプロンプトに渡さないこと。

まず設定が存在するかを確認し、次にサーバープロセスまたは URL、認証、Codex 診断をチェックする。stdio が失敗した場合は同一ユーザー環境でサーバーの --help を手動で実行する。HTTP が失敗した場合は DNS、TLS、組織プロキシを先に検証する。

削除は Codex のサーバー設定のみを削除し、リモートの token を必ずしも取り消すわけではない。利用停止完了後、サーバー側でも資格情報を取り消す必要がある。