Как подключить Закупки MCP к Codex

Закупки MCP можно использовать в Codex для поиска карточек и разбора документов прямо в рабочем проекте. Для российского сервиса нужен адрес https://mcptender.ru/mcp и действующий доступ аккаунта. Настройка ниже использует ключ через переменную окружения, без сохранения его значения в TOML.

Подготовьте аккаунт и папку

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

Создайте отдельную папку для работы с закупками. В ней удобно хранить исходные документы, таблицу требований и список вопросов. Права на запись в папку определяются настройками Codex; подключение MCP само по себе их не расширяет.

Добавьте конфигурацию MCP

В настройках Codex для MCP используется таблица сервера. Пример можно добавить в пользовательский ~/.codex/config.toml; при использовании конфигурации проекта проверьте выбранную область настроек.

[mcp_servers.tenders]
url = "https://mcptender.ru/mcp"
bearer_token_env_var = "TENDER_MCP_KEY"
tool_timeout_sec = 60

Поле bearer_token_env_var содержит имя переменной, а не сам ключ. До запуска клиента задайте значение TENDER_MCP_KEY способом, подходящим вашей системе. Поле url должно указывать на MCP endpoint, а не на страницу кабинета.

Эта схема соответствует официальной документации OpenAI. Подробности доступных параметров следует сверять с документацией вашей версии Codex; для первого теста достаточно адреса и авторизации.

Проверьте окружение процесса

Если вы задали переменную в терминале, запускайте Codex из процесса, который её получил. Уже открытое приложение не наследует изменения окружения из другого терминала. После изменения настроек может потребоваться перезапуск клиента или MCP-подключения.

Проверять значение ключа выводом в чат не нужно. Убедитесь локально, что переменная задана для нужного процесса, а сам ключ активен в кабинете. Ключ от модели OpenAI не подходит вместо ключа Закупки MCP.

Выполните первый поиск

Через сервер tenders покажи доступные источники. Найди несколько собранных закупок по слову «ремонт». Верни номера, предмет и ссылки на оригиналы. Пока не запускай сбор и не сохраняй наблюдения. Если инструмент недоступен, сообщи точную ошибку.

В результате должен быть реальный вызов инструмента выбранного сервера. Одного текста «подключение работает» недостаточно. Сверьте одну найденную карточку по номеру и исходной ссылке.

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

Проверьте чтение и сохранение файла

Выберите карточку с доступным ТЗ и попросите прочитать небольшой раздел. Агент должен показать статус файла и вернуть цитату с позицией. После этого при необходимости поручите сохранить оригинал в папку проекта.

Скачивание требует сетевого доступа, а сохранение — разрешения на запись. Временная ссылка может истечь; в этом случае запросите новую для того же документа. Если доступна контрольная сумма оригинала, сверка поможет проверить, какой файл сохранён.

Как различать ошибки

Не отключайте все ограничения клиента ради одного файла. Сначала установите, какой именно шаг не прошёл. В обращении в поддержку достаточно времени, имени инструмента и кода ошибки без секрета.

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