AI Agent & MCP
Gunakan CaptchaSonic dari AI agent mana pun — Claude Code, Cursor, Windsurf, Antigravity, n8n — melalui server MCP yang di-host di mcp.captchasonic.com, server npx lokal, atau langsung dengan SDK.
CaptchaSonic bersifat agent-native. AI agent apa pun dapat menyelesaikan CAPTCHA melalui server MCP kami, yang tersedia dalam dua cara:
- Hosted:
https://mcp.captchasonic.comdengan API key Anda sebagai bearer token. Tidak perlu instalasi. Direkomendasikan. - Lokal:
npx -y @captchasonic/mcp-servermelalui stdio, untuk client yang hanya mendukung server lokal.
Keduanya menyediakan lima tool yang sama: solve_token_captcha, solve_image_captcha, get_task_result, get_balance dan list_captcha_types. Mulailah dengan panduan MCP Get Started untuk setiap client, atau baca catatan per agent di bawah. Jika agent Anda tidak dapat menggunakan MCP, panggil SDK langsung sebagai gantinya.
Jalur Cepat untuk Agent
Tempelkan ini ke agent mana pun dan agent tersebut dapat menyelesaikan CAPTCHA dalam satu kali round trip:
# Claude Code (or any MCP client): add the hosted server once
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
# Or, with no MCP — the same lifecycle via curl (replace TASK_ID after createTask):
curl -s https://api.captchasonic.com/createTask -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","taskId":"TASK_ID"}'
TIP
Arahkan agent ke MCP untuk AI Agent. Panduan itu menjelaskan cara menemukan sitekey, memilih tool yang tepat, dan mengirimkan token, sehingga agent dapat bekerja tanpa instruksi tambahan.
Claude Code
Tambahkan server hosted:
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
Lebih suka menjalankannya secara lokal? claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server memberi Anda tool yang sama melalui stdio.
Plugin skill Claude (direkomendasikan)
Untuk alur kerja yang terpandu, instal plugin skill CaptchaSonic resmi. Plugin ini berisi tiga skill Claude dan menghubungkan server MCP hosted menggunakan variabel lingkungan SONIC_API_KEY. Ekspor key Anda, jalankan Claude Code, lalu jalankan:
/plugin marketplace add Captcha-Sonic/Agent-skills
/plugin install captchasonic
Tiga skill kemudian memandu agent melalui alur kerja yang umum:
captchasonic-setup— pengaturan MCP pertama kali dan verifikasi.captchasonic-solve— menyelesaikan CAPTCHA jenis apa pun dengan panduan langkah demi langkah.captchasonic-balance— memeriksa saldo akun dan status kredit.
TIP
Gunakan get_balance (atau skill captchasonic-balance) sebagai penjaga sebelum sekumpulan penyelesaian, agar agent dapat berhenti lebih awal jika kredit menipis.
Antigravity
Daftarkan CaptchaSonic di konfigurasi MCP Antigravity sebagai server stdio lokal:
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Muat ulang server MCP Antigravity dan tool CaptchaSonic akan muncul di daftar tool agent.
Cursor
Buka Settings → MCP (atau edit ~/.cursor/mcp.json) dan tambahkan server hosted:
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Windsurf
Buka Settings → Cascade → MCP Servers (atau edit ~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
MCP generik
Client MCP apa pun yang mendukung server remote: gunakan https://mcp.captchasonic.com dengan transport Streamable HTTP dan header Authorization: Bearer sonic_xxx. Konfigurasi VS Code, Codex dan Gemini CLI tersedia di panduan Get Started.
Client yang hanya menjalankan server lokal menggunakan blok stdio standar (lihat Jalankan secara lokal):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
n8n
CaptchaSonic memiliki node komunitas n8n terverifikasi (daftar di n8n.io) yang membungkus 20+ jenis captcha menjadi node alur kerja drag-and-drop. Node ini berfungsi sebagai node mandiri maupun sebagai tool untuk node AI Agent di n8n.
→ Panduan Lengkap Integrasi n8n — instalasi langkah demi langkah, pengaturan credential, 4 resep alur kerja, konfigurasi per jenis captcha, pola penanganan error, dan pemecahan masalah.
Instalasi cepat: Settings → Community Nodes → instal n8n-nodes-captchasonic → buat credential CaptchaSonic dengan API key Anda → selesai.
Tanpa MCP (SDK langsung)
Jika agent Anda tidak dapat menggunakan MCP, panggil SDK secara langsung. CAPTCHA berbasis token cukup dengan satu pemanggilan fungsi.
result = solver.solve_turnstile(
website_url="https://example.com",
website_key="0x4AAAAAAA...",
proxy="http://user:pass@host:port", # optional
)
token = result["token"]await solver.solveTurnstile({
websiteURL: "https://example.com",
websiteKey: "0x4AAAAAAA...",
proxy: "http://user:[email protected]:8080",
});Lihat halaman Python SDK dan Node.js SDK untuk daftar metode lengkap, atau referensi REST API untuk siklus tiga panggilan mentah.