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

1. 1.

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

   Задайте для SOLVETHREE_API_KEY API-ключ вашего рабочего пространства, а для SOLVETHREE_PROXY — прокси, который будете использовать для получения и отправки решения. Обе переменные должны быть доступны процессу, запускающему Cursor. Не указывайте учётные данные напрямую в конфигурации проекта.

2. 2.

   Выберите файл конфигурации

   Используйте .cursor/mcp.json для настройки отдельного проекта или ~/.cursor/mcp.json для настройки на уровне пользователя. Запись проекта с именем solvethree переопределяет глобальную запись с тем же именем.

3. 3.

   Добавьте запись сервера

   Используйте конфигурацию ниже. Если файл уже содержит другие серверы, добавьте solvethree в существующий объект mcpServers, а не заменяйте файл.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

Это запускает solvethree-mcp из официального дистрибутива SDK через npx. Конфигурация наследует окружение Cursor и не зависит от подстановки переменных окружения внутри JSON.

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

Проверьте инструменты MCP в Cursor и вывод журналов MCP. Сервер предоставляет solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt и solvethree_get_task. Сначала вызовите solvethree_capabilities, чтобы проверить доступные операции.

Сервер не запускается.

Найдите ошибку запуска в журналах MCP.

Попробуйте: Если Cursor не находит npx, добавьте его в PATH окружения Cursor и перезапустите Cursor.

Сервер сообщает об отсутствии переменных окружения.

Проверьте окружение, из которого действительно был запущен Cursor, а не только текущий терминал.

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

Cursor использует не ту конфигурацию, которую вы ожидали.

Проверьте наличие записи solvethree в обоих файлах конфигурации.

Попробуйте: Обновите или удалите запись проекта, если вы хотели использовать глобальную.

Описание интерфейса настройки Cursor см. в официальной документации MCP.

1. 1.

   Убедитесь, что профиль сайта активен

   В разделе Профили сайтов настройте нужное имя хоста, действие для захвата и тип reCAPTCHA. Перед запросом решения убедитесь, что профиль активен. Передача имени хоста и действия инструменту не создаёт профиль. Процесс захвата описан в руководстве по настройке профиля сайта.

2. 2.

   Вызовите инструмент reCAPTCHA

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

3. 3.

   Отслеживайте задачу до конечного статуса

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

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

После перехода задачи в готовое состояние работа сервера MCP заканчивается. Ваше приложение должно отправить возвращённый токен reCAPTCHA целевому ресурсу, для которого он предназначен. Используйте возвращённые идентификационные данные userAgent и secChUa с тем же прокси, который настроен для получения решения. Смена прокси или использование несвязанных идентификационных данных браузера может привести к сбою запроса.

При использовании других инструментов не путайте типы решений: Kasada возвращает объект заголовков, которые нужно применять вместе, а TMPT — необработанное значение cookie tmpt. Ни то ни другое не является токеном reCAPTCHA.

Cursor получает конфиденциальные данные решения в ответе инструмента. Результат ready означает, что решение создано, а не что целевой ресурс принял запрос вашего приложения. Если отправка не удалась, проверьте отправляемый токен или cookie, идентификационные данные и прокси, прежде чем оплачивать ещё одно решение.