Добавление solvethree MCP в VS Code

Создайте или обновите .vscode/mcp.json, используя конфигурацию ниже. Если файл уже содержит другие серверы или параметры ввода, объедините записи, а не заменяйте их. VS Code должен иметь возможность запускать npx локально.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

Команда запускает solvethree-mcp из официального дистрибутива SDK. Два диалога ввода пароля передают этому процессу SOLVETHREE_API_KEY и SOLVETHREE_PROXY. Введите API-ключ рабочего пространства и URL HTTP(S)-прокси в этих диалогах, а не в чате или файле конфигурации, добавленном в репозиторий. URL прокси не должен содержать путь, строку запроса или фрагмент.

Структура конфигурации описана в справочнике по конфигурации MCP в VS Code. Это локальный процесс, а не удалённая конечная точка MCP.

После запуска сервера в VS Code попросите агента вызвать solvethree_capabilities, прежде чем запрашивать решение. Сервер предоставляет следующие инструменты:

• solvethree_capabilities — просмотр возможностей сервиса.
• solvethree_create_recaptcha — создание задачи reCAPTCHA.
• solvethree_create_kasada — создание отдельной задачи Kasada; сейчас поддерживаются только HTTPS-ресурсы на www.ticketmaster.com.
• solvethree_create_tmpt — создание задачи Ticketmaster TMPT для Event или Login.
• solvethree_get_task — получение статуса и результата задачи.

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

1. 1.

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

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

2. 2.

   Создайте одну задачу

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

3. 3.

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

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

Сохраните requestId, если время ожидания создания истекло. Он должен содержать 1–64 символа: буквы ASCII, цифры, подчёркивания или дефисы. Повторение того же запроса задачи с тем же идентификатором возвращает существующую задачу; изменение входных данных при повторном использовании этого идентификатора вызывает конфликт. Получите существующую задачу, прежде чем запрашивать новое логическое решение.

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

Другие инструменты возвращают иные данные: Kasada возвращает объект заголовков, которые нужно применять вместе, а TMPT — необработанное значение cookie tmpt. Используйте каждый результат вместе с соответствующими ему идентификационными данными браузера, прокси и целевым ресурсом.

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