MCP-сервер — начало работы
Подключите Claude, Cursor, VS Code, Codex и любой MCP-клиент к CaptchaSonic по одному URL с вашим API-ключом. Решайте reCAPTCHA, Turnstile, hCaptcha-подобные, GeeTest и графические капчи из любого ИИ-агента.
MCP-сервер CaptchaSonic даёт любому ИИ-агенту инструменты для решения капч: reCAPTCHA v2/v3, Cloudflare Turnstile и страницы проверки Cloudflare, hCaptcha-подобные PopularCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR и другие. Сервер работает по протоколу Model Context Protocol, поэтому подходит для Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI и любого другого MCP-клиента.
Хостинг-сервер (рекомендуется)
Один URL и ваш API-ключ. Ничего не нужно устанавливать, всегда актуальная версия.
Локальный запуск
Для клиентов, которые поддерживают только локальные серверы. Запуск через npx. См. Локальный запуск.
Server URL
https://mcp.captchasonic.com
Авторизация — API-ключ CaptchaSonic в заголовке Bearer:
Authorization: Bearer sonic_xxx
NOTE
Это адрес сервера для MCP-клиента, а не страница для браузера. API-ключ можно получить в личном кабинете. Решения списываются с этого ключа так же, как прямые вызовы API; неудачные решения возвращаются.
Client setup
Замените sonic_xxx на свой API-ключ.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Добавьте в ~/.cursor/mcp.json (или Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Добавьте в .vscode/mcp.json. VS Code один раз запросит ключ и сохранит его в защищённом хранилище:
{
"servers": {
"captchasonic": {
"type": "http",
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer ${input:captchasonic-key}" }
}
},
"inputs": [
{ "type": "promptString", "id": "captchasonic-key", "description": "CaptchaSonic API key", "password": true }
]
}
Добавьте в ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Добавьте в ~/.codex/config.toml и экспортируйте CAPTCHASONIC_API_KEY в окружении:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Добавьте в ~/.gemini/settings.json:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Пользовательские коннекторы Claude Desktop не умеют передавать заголовок с API-ключом, поэтому используйте локальный сервер. Добавьте в claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Любой другой клиент: укажите URL выше с транспортом Streamable HTTP и заголовком Authorization: Bearer. Если клиент поддерживает только локальные (stdio) серверы, см. Локальный запуск.
Check it works
Попросите агента:
Check my CaptchaSonic balance.
Агент вызовет get_balance и сообщит баланс. Если вы видите ERROR_KEY_DOES_NOT_EXIST, ключ в конфигурации неверен или отозван.
What your agent can do
| Инструмент | Для чего |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3, Turnstile, проверка Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Возвращает токен для отправки с формой. |
solve_image_captcha | Сетки изображений, слайдеры, клики, распознавание текста и аудио. Ответ приходит сразу. |
get_task_result | Получить токен, который ещё решается. |
get_balance | Баланс кошелька и лимиты тарифа. |
list_captcha_types | Все поддерживаемые типы и их обязательные поля. |
Все параметры и форматы ответов: Справочник инструментов. Как настроить агента на самостоятельную работу: Для агентов.