Интеграция
Веб-поиск в Codex CLI: подключение MCP-сервера
OpenAI
Codex CLI работает в терминале и по умолчанию ограничен содержимым проекта. MCP-сервер срезAI добавляет ему веб-поиск, чтение страниц и проверку утверждений — конфигом в TOML, без написания обёрток.
Коротко
Веб-поиск в Codex CLI включается секцией [mcp_servers.srezai] в ~/.codex/config.toml: адрес https://srezai.ru/api/mcp и имя переменной окружения с ключом. Ключ в файл прописывать не нужно.
Шаг 1. Получите API-ключ
Зарегистрируйтесь и создайте ключ вида srz_live_… в личном кабинете. При регистрации начисляем 100 ₽ — этого хватает примерно на 1 000 запросов, карта для старта не нужна.
Шаг 2. Подключите MCP-сервер
Пошаговая настройка для Codex CLI — куда нажать и что вставить. Значения полей можно скопировать одним кликом.
- 1Возьмите API-ключ в личном кабинете, раздел «API-ключи»:Открыть раздел API-ключи
- 2Откройте (или создайте) файл конфигурации:
- 3Вставьте в него блок ниже.
- 4Задайте ключ в переменной окружения — выполните в терминале:
- 5Перезапустите Codex CLI.
[mcp_servers.srezai]
url = "https://srezai.ru/api/mcp"
bearer_token_env_var = "SREZAI_API_KEY"
startup_timeout_sec = 30Шаг 3. Перезапустите Codex CLI
После перезапуска у агента появятся инструменты web_search, read_url, extract, verify_claim и остальные. Проверить список и стоимость вызовов можно бесплатным get_usage.
Что агент сможет делать
Поиск причины ошибки сборки
Агент ищет обсуждения по тексту ошибки и читает найденные страницы в 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 запросов, чтобы попробовать без карты.
Подойдёт ли это модели с небольшим окном контекста?
Да. Черновая работа идёт вне контекста модели: чтение страницы отдаёт длинный документ окнами, извлечение по схеме возвращает только запрошенные поля, а проверка утверждения переваривает четыре-пять источников на нашей стороне и отдаёт вердикт с цитатами — сотни токенов вместо десятков тысяч.