Добавление solvethree MCP в Claude Desktop
Запустите локальный MCP-сервер solvethree через Claude Desktop с помощью npx. Claude может создавать и получать задачи, но сервер не управляет браузером и не заполняет формы. Ваше приложение по-прежнему должно отправлять возвращённое решение целевому сайту.
На этой странице
Подготовьте Node.js, учётные данные и профиль сайта
Установите Node.js 22 на компьютере, где работает Claude Desktop. Подготовьте API-ключ рабочего пространства и URL HTTP- или HTTPS-прокси. MCP-сервер использует один прокси, заданный через SOLVETHREE_PROXY; инструмент reCAPTCHA не принимает аргумент прокси.
Для reCAPTCHA сначала создайте активный профиль в разделе Профили сайтов. Настройте нужные целевое имя хоста, действие захвата и тип reCAPTCHA. Передача имени хоста и действия в Claude не создаёт этот профиль. Если он ещё не активен, см. настройку профиля сайта.
Добавьте конфигурацию Claude Desktop
- 1.
Откройте локальный файл конфигурации
В macOS используйте
~/Library/Application Support/Claude/claude_desktop_config.json. В Windows используйте%APPDATA%/Claude/claude_desktop_config.json. - 2.
Добавьте сервер solvethree
Используйте конфигурацию ниже. Если файл уже содержит
mcpServers, добавьте в него записьsolvethree, не заменяя остальные серверы. Замените оба заполнителя переменных окружения, не раскрывая их значения. - 3.
Перезапустите Claude Desktop
После сохранения перезапустите приложение, чтобы оно запустило сервер с новой конфигурацией.
{
"mcpServers": {
"solvethree": {
"command": "npx",
"args": [
"--yes",
"--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
"solvethree-mcp"
],
"env": {
"SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
"SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
}
}
}
}args обеспечивают загрузку официального архива SDK и запуск его исполняемого файла solvethree-mcp как локального stdio-сервера. Размещённого MCP-эндпоинта, который можно было бы указать, нет.
Отделяйте проверку от создания платных задач
Начните с solvethree_capabilities. Используйте solvethree_get_task, чтобы получить существующую задачу. Ни одна из этих операций не является запросом на создание нового решения.
solvethree_create_recaptchaпринимаетsiteв виде имени хоста,actionиrequestId, а также необязательныеrecaptchaTypeиwaitMs. Тип по умолчанию —enterprise-v3; также допускаетсяv3.solvethree_create_kasadaсоздаёт задачу Kasada. Отдельный продукт Kasada сейчас поддерживает HTTPS-цели наwww.ticketmaster.com, а не произвольные сайты.solvethree_create_tmptсоздаёт задачу TMPT. Задачи Event используют URL события; задачи Login — URL точки входа в процесс авторизации.
Дайте Claude явное разрешение создать одну задачу для согласованных цели и действия. Требуйте нового подтверждения перед запуском ещё одной платной задачи, в том числе замены после сбоя или отклонения целевым сайтом. Разрешение проверить задачу или опрашивать её статус не должно считаться разрешением создать другую.
Каждый инструмент создания требует requestId и создаёт не более одной задачи. Сохраняйте этот ID вместе с исходными входными данными. Если создание завершилось тайм-аутом, получите задачу, повторив тот же запрос с тем же ID, либо запросите её, если у вас уже есть ID задачи. Тайм-аут не доказывает, что создание не удалось. Изменение входных данных при повторном использовании ID вызывает конфликт; использование нового ID может создать ещё одну задачу.
При статусе pending или solving продолжайте запрашивать существующую задачу. Только ready содержит пригодное решение. При failed прекратите опрос и проверьте errorCode и error; средства за неудачные решения возвращаются. Не отправляйте автоматически те же некорректные входные данные повторно.
Передайте решение своему приложению
Claude получает конфиденциальные данные решения через хост MCP. Ваше приложение должно использовать результат для целевого ресурса, для которого он предназначен, с прокси, на котором решение было успешно получено, и возвращёнными userAgent и secChUa. Не получайте решение через настроенный прокси, чтобы затем отправить его с другого IP-адреса или с несвязанными идентификационными данными браузера.
| Задача | Что использует приложение |
|---|---|
| reCAPTCHA | solution.token, отправляемый в поле токена, которое ожидает целевой ресурс, — не идентификатор задачи. |
| Kasada | Возвращённый объект headers, применяемый вместе с соответствующими идентификационными данными браузера и прокси, на котором решение было успешно получено. |
| TMPT | Возвращённый токен как необработанное значение cookie tmpt, а не как токен reCAPTCHA или заголовки Kasada. |
Статус задачи ready означает, что решение создано, но не что сайт принял ваш последующий запрос. Если целевой ресурс отклоняет его, проверьте отправляемый токен, cookie или заголовки, прокси, идентификационные данные браузера и целевой URL, прежде чем разрешать получение ещё одного решения.
Источники и справочник API
Запустите первую задачу.
Начните с $5 на балансе рабочего пространства.