AI-агенты и MCP

CaptchaSonic создан для работы с AI-агентами. Любой агент может решать CAPTCHA через наш MCP-сервер — единый stdio-бинарник, который предоставляет три инструмента (health_check, get_balance, solve_captcha) по протоколу Model Context Protocol. Поскольку MCP — это универсальный стандарт, один и тот же сервер подключается к Claude Code, Antigravity, Cursor, Windsurf и любому другому MCP-совместимому клиенту. Если ваш агент не поддерживает MCP, вы всегда можете обратиться к SDK напрямую.

Golden Path for Agents

Вставьте этот сниппет в любого агента — и он сможет решать CAPTCHA за один шаг:

# Claude Code (или любой MCP-клиент): зарегистрируйте сервер один раз
claude mcp add sonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server
# Без MCP — тот же жизненный цикл через curl (подставьте TASK_ID после createTask):
curl -s https://api.captchasonic.com/createTask  -H 'content-type: application/json' -d '{"clientKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"clientKey":"sonic_xxx","taskId":"TASK_ID"}'

---

Claude Code

Добавьте MCP-сервер командой claude mcp add. Передавайте API-ключ через переменную окружения, чтобы он не попадал в систему контроля версий:

claude mcp add sonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server

Эта команда запускает пакет @captchasonic/mcp-server через npx — отдельная установка не нужна. Предпочитаете зафиксированную глобальную установку? Выполните npm install -g @captchasonic/mcp-server один раз и используйте -- sonic-mcp в качестве команды.

После добавления агенту становятся доступны три инструмента:

• health_check — проверить, что API-сервер работает (API-ключ не требуется).
• get_balance — вернуть текущий баланс аккаунта в долларах США.
• solve_captcha — отправить CAPTCHA (изображение, сетка, слайдер, OCR, Geetest, TikTok, Binance и другие) и получить типизированное решение.

Также можно установить плагин со скиллами /sonic:* для рабочих процессов через слэш-команды, использующие тот же SDK. Добавьте маркетплейс один раз, затем установите плагин:

claude plugin marketplace add captchasonic/sonic-sdk
claude plugin install sonic@captchasonic

После установки доступны три слэш-команды:

/sonic:solve      # решить CAPTCHA по пути к изображению или URL
/sonic:balance    # проверить кредиты на аккаунте
/sonic:test-sdk   # дымовой тест SDK на боевом сервере

---

Antigravity

Antigravity использует стандартный протокол MCP, поэтому зарегистрируйте CaptchaSonic как обычный stdio-сервер в его конфигурации MCP. Добавьте следующую запись:

{
  "mcpServers": {
    "sonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": {
        "SONIC_API_KEY": "sonic_xxx"
      }
    }
  }
}

После сохранения перезагрузите MCP-серверы Antigravity, и инструменты health_check, get_balance и solve_captcha появятся в списке инструментов агента.

---

Cursor

В Cursor откройте Settings → MCP (или отредактируйте ~/.cursor/mcp.json) и добавьте stdio-сервер:

{
  "mcpServers": {
    "sonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": {
        "SONIC_API_KEY": "sonic_xxx"
      }
    }
  }
}

Перезапустите MCP-соединение Cursor. Три инструмента CaptchaSonic теперь доступны агенту.

---

Windsurf

В Windsurf откройте Settings → Cascade → MCP Servers (или отредактируйте ~/.codeium/windsurf/mcp_config.json) и добавьте тот же stdio-блок:

{
  "mcpServers": {
    "sonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": {
        "SONIC_API_KEY": "sonic_xxx"
      }
    }
  }
}

Обновите список серверов, и инструменты CaptchaSonic станут доступны в Cascade.

---

Generic MCP (stdio)

Любой MCP-клиент принимает один и тот же сырой stdio-конфиг. Укажите в command путь к бинарнику и передайте SONIC_API_KEY через env. Рантайм Node доступен уже сейчас; рантайм Python появится позже.

Node (@captchasonic/mcp-server):

{
  "mcpServers": {
    "sonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": {
        "SONIC_API_KEY": "sonic_xxx"
      }
    }
  }
}

Python — скоро. Python-пакет MCP, устанавливаемый через uvx, в разработке. Пока используйте рантайм Node выше или обращайтесь к SDK напрямую.

---

n8n

CaptchaSonic поставляет community-нод для n8n. В вашем экземпляре n8n перейдите в Settings → Community Nodes, установите n8n-nodes-captchasonic, затем создайте учётные данные CaptchaSonic с вашим API-ключом. Нод предоставляет операции решения и проверки баланса, которые можно добавить в любой рабочий процесс.

---

Without MCP (direct SDK)

Если ваш агент не может запустить MCP-сервер, обращайтесь к SDK напрямую. Токеновая CAPTCHA — это один вызов функции.

Python:

from captchasonic import CaptchaSonic

solver = CaptchaSonic("YOUR_API_KEY")
result = solver.solve_turnstile(
    website_url="https://example.com",
    website_key="0x4AAAAAAA...",
)
print(result["token"])

Node:

import { CaptchaSonic } from "captchasonic"

const solver = new CaptchaSonic("YOUR_API_KEY")
const result = await solver.solveTurnstile({
  websiteURL: "https://example.com",
  websiteKey: "0x4AAAAAAA...",
})
console.log(result.token)

Полный список методов смотрите на страницах Python SDK и Node.js SDK, а сырой жизненный цикл из трёх вызовов — в справочнике REST API.