Веб-поиск в Codex CLI: подключение MCP-сервера

OpenAI

Codex CLI работает в терминале и по умолчанию ограничен содержимым проекта. MCP-сервер срезAI добавляет ему веб-поиск, чтение страниц и проверку утверждений - конфигом в TOML, без написания обёрток.

Коротко

Веб-поиск в Codex CLI включается секцией [mcp_servers.srezai] в ~/.codex/config.toml: адрес https://srezai.ru/api/mcp и имя переменной окружения с ключом. Ключ в файл прописывать не нужно.

1

Получите API-ключ

Создать ключ в ЛК

Создайте ключ в личном кабинете. Стартовый бонус 100 ₽ (примерно 1 000 запросов) начисляется после подтверждения Telegram и подписки на канал — карта для старта не нужна.

2

Подключите MCP-сервер

Выберите удобный способ: передать настройку агенту готовым промптом или настроить JSON-конфиг вручную.

Промпт для чата Codex CLI
Подключи MCP-сервер srezai к Codex CLI: нужен живой веб-поиск, чтение страниц и проверка фактов как встроенные инструменты.

Параметры сервера:
- имя сервера: srezai
- транспорт: Streamable HTTP
- адрес: https://srezai.ru/api/mcp
- заголовок: Authorization: Bearer srz_live_ВАШ_КЛЮЧ

Файл конфига Codex CLI: ~/.codex/config.toml
Формат: toml

Готовый блок для вставки:

[mcp_servers.srezai]
url = "https://srezai.ru/api/mcp"
bearer_token_env_var = "SREZAI_API_KEY"
startup_timeout_sec = 30

Что нужно сделать:
1. Открой ~/.codex/config.toml; если файла нет - создай его вместе с родительскими каталогами.
2. Добавь сервер с параметрами выше и сохрани изменения. Ключ в заголовке - плейсхолдер: я подставлю свой.
3. Скажи, как перезапустить Codex CLI, чтобы инструменты подхватились.
4. Проверь, что подключилось: у тебя должны появиться инструменты web_search, image_search, read_url, read_urls, fetch_page, extract, map, crawl, verify_claim, answer_search, deep_research и get_usage.

Если структура конфига в Codex CLI другая - приведи блок к её формату сам и скажи, что изменил. Если данных не хватает, спроси меня, а не догадывайся.
3

Перезапустите Codex CLI

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

Что агент сможет делать

Поиск причины ошибки сборки

Агент ищет обсуждения по тексту ошибки и читает найденные страницы в Markdown, оставаясь в терминале.

Актуальные примеры использования API

read_url открывает страницу документации и отдаёт чистый текст без навигации - в контекст уходит меньше токенов.

Проверка версии и совместимости

verify_claim возвращает вердикт по конкретному утверждению с цитатами и ссылками на источники.

Частые вопросы

Как передать ключ в Codex CLI, не записывая его в конфиг?

В секции сервера укажите bearer_token_env_var = "SREZAI_API_KEY" и экспортируйте переменную в окружении. Так ключ не попадёт в файл конфигурации и в историю репозитория.

Почему в Codex CLI не приходит скриншот страницы?

Codex - текстовый клиент и не отображает картинку в результате инструмента, поэтому fetch_page отдаёт ему текст страницы и ссылку на файл скриншота вместо встроенного изображения.

Нужен ли VPN, чтобы веб-поиск работал в Codex CLI?

Нет. Сервис размещён в России, запросы идут напрямую с вашей машины или сервера на srezai.ru, оплата в рублях с российской карты или через СБП.

Сколько стоит подключить веб-поиск к Codex CLI?

Подключение бесплатное, платите только за запросы: от 0,1 ₽ за вызов, без подписки и месячных квот. Стартовый бонус 100 ₽ (около 1 000 запросов, чтобы попробовать без карты) начисляем после подтверждения Telegram и подписки на наш канал в личном кабинете.

Подойдёт ли это модели с небольшим окном контекста?

Да. Черновая работа идёт вне контекста модели: чтение страницы отдаёт длинный документ окнами, извлечение по схеме возвращает только запрошенные поля, а проверка утверждения переваривает четыре-пять источников на нашей стороне и отдаёт вердикт с цитатами - сотни токенов вместо десятков тысяч.