Добавление MCP-серверов в OpenAI Codex CLI

Codex хранит серверы в config.toml — по одной таблице [mcp_servers.<name>] на сервер. Добавить сервер можно командой codex mcp add.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

Файл проекта

.codex/config.toml (trusted projects only)

Ключ верхнего уровня

mcp_servers

Формат

toml

OAuth для удалённых серверов

●Да

Пример конфигурации

В этом примере добавлены размещённый сервер GitHub и Playwright в качестве локального сервера — в формате, который ожидает этот клиент.

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest

Примечания и особенности

• Тот же config.toml считывают Codex CLI, расширение Codex для IDE и приложение ChatGPT для компьютера.
• Проектный .codex/config.toml считывается только в доверенных проектах.
• env_vars передаёт переменные из оболочки по имени; bearer_token_env_var отправляет токен из переменной на удалённый сервер.
• Для каждого сервера можно задать параметры startup_timeout_sec, tool_timeout_sec, enabled_tools и disabled_tools.
• codex mcp login <name> запускает OAuth; поддерживаются CIMD и динамическая регистрация.

Создать конфигурацию OpenAI Codex CLI →

Другие клиенты