Codex MCP サーバー設定
MCP(Model Context Protocol、モデルコンテキストプロトコル)を使用すると、Codex を外部ツールやサービスと統合できます。
このセクションでは、MCP サーバーの設定方法と使用方法について詳しく説明します。
MCP とは?
MCP は、AI モデルが外部ツールやサービスと標準化された方法で対話できるようにするオープンプロトコルです。MCP サーバーを使用すると、Codex の機能を拡張できます:
- ファイルシステムへの接続
- データベースへのアクセス
- プロジェクト管理ツールとの統合
- 外部 API の呼び出し
MCP はオープンなModel Context Protocol基づいて構築され、異なるツール間の標準化された統合をサポートします。
MCP 基本設定
Codex 設定メニュー
設定メニューから MCP サービスを管理または追加できます:

カスタム MCP に接続:

設定ファイルの場所
MCP サーバーは~/.codex/config.tomlのmcp_serversセクションで設定します。
stdio タイプのサーバー
stdio MCP サーバーの設定
[mcp_servers.filesystem]
# サーバー起動コマンド
command = "npx"
# コマンドに渡す引数
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
# サーバーの作業ディレクトリ
cwd = "/path/to/workdir"
# 環境変数の受け渡し
env = {
NODE_ENV = "production"
}
# サーバー起動コマンド
command = "npx"
# コマンドに渡す引数
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
# サーバーの作業ディレクトリ
cwd = "/path/to/workdir"
# 環境変数の受け渡し
env = {
NODE_ENV = "production"
}
HTTP タイプのサーバー
HTTP MCP サーバーの設定
[mcp_servers.docs]
# MCP HTTP サーバーのエンドポイント
url = "https://docs.example.com/mcp"
# 含まれる HTTP ヘッダー
http_headers = {
Authorization = "Bearer token"
}
# MCP HTTP サーバーのエンドポイント
url = "https://docs.example.com/mcp"
# 含まれる HTTP ヘッダー
http_headers = {
Authorization = "Bearer token"
}
MCP ツール設定
利用可能なツールの制限
MCP サーバーが公開するツールを制限できます:
ツールのホワイトリスト/ブラックリスト
[mcp_servers.filesystem]
# 許可されたツールのリスト
enabled_tools = ["read_file", "write_file", "list_directory"]
# 拒否されたツールのリスト(enabled_tools の後に適用)
disabled_tools = ["delete_file"]
# 許可されたツールのリスト
enabled_tools = ["read_file", "write_file", "list_directory"]
# 拒否されたツールのリスト(enabled_tools の後に適用)
disabled_tools = ["delete_file"]
ツール制限を使用すると、必要なツールのみを公開することでセキュリティを向上できます。
タイムアウト設定
タイムアウトの設定
[mcp_servers.slow_server]
command = "python"
args = ["-m", "slow_server"]
# 起動タイムアウト(秒、デフォルト 10)
startup_timeout_sec = 30
# 各ツール呼び出しのタイムアウト(秒、デフォルト 60)
tool_timeout_sec = 120
command = "python"
args = ["-m", "slow_server"]
# 起動タイムアウト(秒、デフォルト 10)
startup_timeout_sec = 30
# 各ツール呼び出しのタイムアウト(秒、デフォルト 60)
tool_timeout_sec = 120
MCP 認証設定
OAuth 設定
OAuth の設定
[mcp_servers.protected]
url = "https://api.example.com/mcp"
# 要求された OAuth スコープ
scopes = ["read", "write"]
# OAuth リソースパラメータ
oauth_resource = "codex-integration"
# Bearer トークン環境変数
bearer_token_env_var = "EXAMPLE_API_TOKEN"
url = "https://api.example.com/mcp"
# 要求された OAuth スコープ
scopes = ["read", "write"]
# OAuth リソースパラメータ
oauth_resource = "codex-integration"
# Bearer トークン環境変数
bearer_token_env_var = "EXAMPLE_API_TOKEN"
HTTP ヘッダー設定
HTTP ヘッダーの設定
[mcp_servers.api]
url = "https://api.example.com/mcp"
# 環境変数から HTTP ヘッダーを設定
env_http_headers = {
X_API_KEY = "MY_API_KEY"
}
# 静的 HTTP ヘッダー
http_headers = {
X_Custom_Header = "value"
}
url = "https://api.example.com/mcp"
# 環境変数から HTTP ヘッダーを設定
env_http_headers = {
X_API_KEY = "MY_API_KEY"
}
# 静的 HTTP ヘッダー
http_headers = {
X_Custom_Header = "value"
}
OAuth コールバック設定
OAuth コールバックの設定
# コールバックポートの固定
mcp_oauth_callback_port = 8080
# カスタムコールバック URL
mcp_oauth_callback_url = "https://my-devbox.example.com/callback"
# 認証情報の保存場所
mcp_oauth_credentials_store = "keyring" # file | keyring | auto
mcp_oauth_callback_port = 8080
# カスタムコールバック URL
mcp_oauth_callback_url = "https://my-devbox.example.com/callback"
# 認証情報の保存場所
mcp_oauth_credentials_store = "keyring" # file | keyring | auto
MCP ツール権限
MCP サーバーごとにツールの権限を個別に設定できます:
ツール権限の設定
[mcp_servers.docs.tools.search]
# 権限モード:ask | approve | deny
approval_mode = "approve"
# 権限モード:ask | approve | deny
approval_mode = "approve"
| 権限モード | 説明 |
|---|---|
ask | 実行のたびに確認(デフォルト) |
approve | 自動承認 |
deny | 自動拒否 |
ツール権限を設定するときは注意し、信頼するツールにのみ自動承認権限を付与してください。
よく使う MCP サーバー
ファイルシステムサーバー
ファイルシステム MCP
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
GitHub サーバー
GitHub MCP
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}
PostgreSQL サーバー
PostgreSQL MCP
[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]
よく使う MCP サーバー
npm を使用してさらに多くの MCP サーバーをインストールできます:
# 搜索 MCP 服务器 npm search @modelcontextprotocol/server # 安装 MCP 服务器 npm install -g @modelcontextprotocol/server-filesystem
OpenAI 公式はさまざまな MCP サーバーを提供しています。GitHub リポジトリで完全なリストを確認できます。
トラブルシューティング
サーバー起動失敗
以下を確認してください:
- コマンドと引数が正しいか
- 必要な依存関係がインストールされているか
- 環境変数が正しく設定されているか
ツール呼び出しタイムアウト
タイムアウト時間を増やします:
tool_timeout_sec = 120
認証の問題
OAuth コールバックポートが使用されておらず、認証情報ストレージが正しく設定されていることを確認してください。
を使用するとcodex --verbose詳細な MCP デバッグ情報を表示できます。
よくある質問
Q: MCP サーバーが起動できない?
コマンドが正しくインストールされているか確認し、手動でコマンドを実行してエラーがないか確認してください。
Q: ツール権限はどこで設定しますか?
設定ファイルのmcp_servers.<id>.tools.<tool>セクションで設定します。
Q: 特定の MCP サーバーを無効にするには?
設定にenabled = falseを追加するか、設定を直接削除してください。
Q: MCP サーバーはいくつサポートされていますか?
厳密な制限はありませんが、実際に必要なサーバーのみを設定することをお勧めします。
その他の拡張機能