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"
}

HTTP タイプのサーバー

HTTP MCP サーバーの設定

[mcp_servers.docs]
# 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"]
ツール制限を使用すると、必要なツールのみを公開することでセキュリティを向上できます。

タイムアウト設定

タイムアウトの設定

[mcp_servers.slow_server]
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"

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"
}

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 ツール権限

MCP サーバーごとにツールの権限を個別に設定できます:

ツール権限の設定

[mcp_servers.docs.tools.search]
# 権限モード:ask | approve | deny
approval_mode = "approve"
権限モード説明
ask実行のたびに確認(デフォルト)
approve自動承認
deny自動拒否
ツール権限を設定するときは注意し、信頼するツールにのみ自動承認権限を付与してください。

よく使う MCP サーバー

ファイルシステムサーバー

ファイルシステム MCP

[mcp_servers.filesystem]
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"
}

PostgreSQL サーバー

PostgreSQL MCP

[mcp_servers.postgres]
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 サーバーはいくつサポートされていますか?

厳密な制限はありませんが、実際に必要なサーバーのみを設定することをお勧めします。

その他の拡張機能