Добавление solvethree MCP в Codex

1. 1.

   Обеспечьте доступность Node.js 22 и npx

   Они должны быть доступны процессу, в котором работает Codex. Установка в отдельном окружении, к которому у Codex нет доступа, не позволит ему запустить сервер.

2. 2.

   Задайте переменные окружения хоста

   Задайте для SOLVETHREE_API_KEY API-ключ вашего рабочего пространства, а для SOLVETHREE_PROXY — URL прокси. Запустите Codex с доступом к этим переменным. При интеграции с IDE убедитесь, что процесс IDE тоже их наследует. Не включайте API-ключ в запросы к агенту и систему контроля версий.

3. 3.

   Активируйте профиль сайта reCAPTCHA

   В разделе Профили сайтов добавьте HTTPS-URL страницы, выберите тип reCAPTCHA и укажите действие для захвата. Дождитесь активации профиля. Настройте нужные имя хоста, действие для захвата и тип; сайт и действие, указанные в задаче, не создают профиль. Если это ваш первый целевой ресурс, см. руководство по настройке профиля сайта.

Codex CLI и IDE используют общий файл ~/.codex/config.toml. Также можно использовать .codex/config.toml доверенного проекта. Добавьте следующую запись сервера:

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

Эта запись запускает исполняемый файл solvethree-mcp из официального SDK через npx. env_vars передаёт существующие переменные хоста, а не задаёт их значения. Для этого локального сервера не нужно указывать удалённую конечную точку MCP или выполнять вход через OAuth.

startup_timeout_sec отводит 60 секунд на запуск сервера. tool_timeout_sec отводит 100 секунд на вызов инструмента. Ни одна из этих настроек не означает, что целевой сайт принял решение.

Выполните codex mcp list или откройте /mcp в TUI Codex, чтобы проверить настроенный сервер. Если он не запускается, убедитесь, что Codex может найти npx и унаследовал обе переменные окружения.

1. 1.

   Проверьте возможности

   Попросите Codex вызвать solvethree_capabilities, прежде чем выбирать инструмент решения. Для reCAPTCHA используйте solvethree_create_recaptcha.

2. 2.

   Укажите входные данные reCAPTCHA

   Передайте имя хоста в site, а также action и requestId. Инструмент также принимает необязательные recaptchaType и waitMs; тип по умолчанию — enterprise-v3. Единственный прокси он считывает из SOLVETHREE_PROXY, поэтому не рассматривайте его как настройку прокси для отдельного вызова. Не добавляйте поля type или url в запрос reCAPTCHA.

3. 3.

   Сохраняйте ID задачи и проверяйте её статус

   Каждый вызов создания создаёт не более одной задачи. Получите эту задачу через solvethree_get_task, используя возвращённый ID. Продолжайте проверять её, пока статус — pending или solving. Только ready содержит пригодное для использования решение. Если статус изменится на failed, прекратите опрос и изучите errorCode и error, прежде чем решать, что изменить.

MCP-сервер не управляет браузером, не проверяет его текущую сессию и не заполняет формы. Ваше приложение должно получить готовый результат reCAPTCHA и отправить solution.token целевому ресурсу.

Используйте возвращённые параметры идентификации браузера userAgent и secChUa с тем же прокси, который использовался для решения. Если ваш браузер или HTTP-клиент использует другой прокси или несвязанные параметры идентификации браузера, исправьте это перед отправкой. Добавление MCP-сервера не настраивает эти параметры за вас.

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