MCP для Codex: подключение сервера через config.toml и командой

Короткий ответ

У Codex два пути. Быстрый — одна команда в терминале:

codex mcp add context7 -- npx -y @upstash/context7-mcp

Медленный, но нагляднее — руками дописать таблицу в ~/.codex/config.toml. Файл конфигурации может лежать и в проекте: .codex/config.toml, тогда сервер поднимется только для этого проекта.

Как выглядит конфиг

Codex использует TOML, а не JSON, как большинство редакторов. Каждый сервер — отдельная таблица:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

Имя после точки произвольное, по нему сервер будет виден агенту. Если серверу нужны ключи, добавьте их через флаг при установке:

codex mcp add мой-сервер --env API_KEY=значение -- npx -y пакет-сервера

Полезные команды

codex mcp list

Показывает, что уже подключено. Первое, что стоит запустить, если агент не видит инструмент: возможно, сервер просто не добавился.

codex mcp login имя-сервера

Нужна для серверов с авторизацией через OAuth — например, когда сервер ходит в ваш аккаунт стороннего сервиса. Без этого шага сервер будет виден, но все вызовы станут отваливаться по правам.

Полный список подкоманд открывается через codex mcp --help.

Чем это отличается от Cursor

Разница только в форме записи. В Cursor это JSON-файл mcp.json, в Codex — TOML и команда. Сами серверы одни и те же: один и тот же файловый сервер или сервер документации подключается к обоим, меняются только четыре строчки конфига.

Это и есть смысл протокола: сервер пишется один раз и работает с любым агентом, который умеет MCP. Подробнее — в объяснении, что такое MCP-сервер.

Если сервер не поднялся

Проверьте, что команда вообще запускается. Скопируйте её из конфига и выполните в терминале руками. Сервер, который падает сам по себе, в Codex тоже не заработает.

Смотрите на кавычки в TOML. Здесь строки в двойных кавычках, а массив аргументов — в квадратных скобках. Одиночные кавычки в TOML означают другое и часто дают неочевидную ошибку.

Проверьте, тот ли файл правите. Проектный .codex/config.toml перекрывает домашний, и правки в домашнем при этом выглядят как не сработавшие.

С чего начать

Хороший первый сервер для Codex — сервер документации: агент перестаёт выдумывать методы библиотек и берёт актуальную справку. Второй по полезности — доступ к вашему трекеру задач, чтобы не пересказывать задачу словами.

Не подключайте всё подряд. Каждый сервер добавляет агенту инструменты, и на большом количестве модель начинает выбирать не тот. Общие принципы разобраны в инструкции по подключению MCP, а риски доступа — в материале про безопасность.