Эта страница написана для ИИ-агентов. Дайте агенту ссылку на неё (или на [markdown-версию](/ru/docs/mcp/for-agents.md)), и он сможет сам настроиться и решать капчи без дополнительных инструкций.

## Connect

1. Попросите у пользователя API-ключ CaptchaSonic (начинается с `sonic_`). Его можно получить на https://my.captchasonic.com. Никогда не придумывайте ключ и не берите его из других мест.
2. Добавьте хостинг-сервер с транспортом Streamable HTTP:
   - URL: `https://mcp.captchasonic.com`
   - Заголовок: `Authorization: Bearer <ключ>`
3. Если у вашей среды есть CLI, используйте его. Claude Code:

```bash
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
```

4. Если среда поддерживает только локальные (stdio) серверы, запустите `npx -y @captchasonic/mcp-server` с переменной окружения `SONIC_API_KEY`, равной ключу.
5. Проверьте подключение вызовом `get_balance`. Число — всё работает; `ERROR_KEY_DOES_NOT_EXIST` — неверный ключ.

## Decide which tool

- На странице есть виджет капчи, который выдаёт скрытый токен (reCAPTCHA, Turnstile, hCaptcha-подобные, GeeTest, MTCaptcha), или страница Cloudflare «проверка браузера» → `solve_token_captcha`.
- Перед вами визуальная головоломка (выбрать картинки, сдвинуть слайдер, прочитать искажённый текст, прослушать аудио) → `solve_image_captcha`.
- Не уверены → вызовите `list_captcha_types`.

## Solve a token CAPTCHA

1. Найдите sitekey на странице:
   - reCAPTCHA: `data-sitekey` у `.g-recaptcha` или `render=` в URL скрипта `recaptcha/api.js`. Если страница вызывает `grecaptcha.execute`, это v3.
   - Turnstile: `data-sitekey` у `.cf-turnstile` (начинается с `0x4`).
   - hCaptcha-подобные: `data-sitekey` у `.h-captcha`.
   - GeeTest v4: `captchaId` в вызове `initGeetest4`.
2. Вызовите `solve_token_captcha` с `type`, `website_url` (URL страницы) и `website_key`.
3. Вставьте полученный `token` в поле формы виджета — `g-recaptcha-response`, `cf-turnstile-response` или `h-captcha-response` — и отправьте форму или вызовите callback страницы.
4. Для `cloudflare_challenge` установите возвращённые `cookies` и отправляйте дальнейшие запросы с возвращённым `user_agent`.
5. Если инструмент вернул `"status": "processing"`, подождите несколько секунд и вызовите `get_task_result` с `task_id`.

Токены действуют около двух минут. Решайте непосредственно перед отправкой.

## Solve an image CAPTCHA

1. Сохраните каждое изображение задания отдельно, в порядке на экране. Обрежьте до самого изображения, не отправляйте всю страницу.
2. Скопируйте текст задания точно (например, `Select all images with a bus`).
3. Вызовите `solve_image_captcha` с `type`, `images` и `question`. Для слайдеров передайте фрагмент в `examples`.
4. Примените `answers`, как описано в `answer_format` результата: кликните по индексам клеток, сдвиньте на полученное смещение или введите текст.

## Handle errors

- `ERROR_CAPTCHA_UNSOLVABLE` или `ERROR_CAPTCHA_TIMEOUT`: перезагрузите задание и попробуйте ещё раз. Списания не было.
- `ERROR_ZERO_BALANCE`: остановитесь и попросите пользователя пополнить баланс на https://my.captchasonic.com.
- `ERROR_MISSING_REQUIRED_FIELDS`: добавьте параметр, указанный в сообщении.
- Не зацикливайтесь. После двух неудач на одной странице сообщите пользователю.

Решайте капчи только на сайтах, которые пользователь имеет право автоматизировать.