MCP Sunucusu — Başlarken
Claude, Cursor, VS Code, Codex veya herhangi bir MCP istemcisini tek bir URL ve API anahtarınızla CaptchaSonic'e bağlayın; herhangi bir yapay zeka agent'ından CAPTCHA çözün.
CaptchaSonic MCP sunucusu, herhangi bir yapay zeka agent'ına CAPTCHA çözme araçları verir: reCAPTCHA v2/v3, Cloudflare Turnstile ve challenge sayfaları, hCaptcha benzeri PopularCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR ve daha fazlası. Model Context Protocol üzerinden çalışır; bu yüzden Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI ve diğer tüm MCP istemcilerinde kullanılabilir.
Barındırılan sunucu (önerilen)
Tek bir URL ve API anahtarınızı yapıştırın. Kurulum gerektirmez, her zaman güncel kalır.
Yerel çalıştırma
Yalnızca yerel sunucuları destekleyen istemciler için. npx ile çalışır. Bkz. Yerel olarak çalıştırma.
Sunucu URL'si
https://mcp.captchasonic.com
CaptchaSonic API anahtarınızla bearer token olarak kimlik doğrulayın:
Authorization: Bearer sonic_xxx
NOTE
Bu, tarayıcıda açılacak bir sayfa değil, MCP istemciniz için bir sunucu URL'sidir. API anahtarınızı dashboard üzerinden alın. Çözümler bu anahtara doğrudan API çağrılarındaki gibi faturalandırılır ve başarısız çözümler iade edilir.
İstemci kurulumu
Aşağıdaki sonic_xxx yerine API anahtarınızı yazın.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
~/.cursor/mcp.json dosyasına ekleyin (veya Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
.vscode/mcp.json dosyasına ekleyin. VS Code anahtarı bir kez sorar ve güvenli şekilde saklar:
{
"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 dosyasına ekleyin:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
~/.codex/config.toml dosyasına ekleyin ve shell'inizde CAPTCHASONIC_API_KEY değişkenini export edin:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
~/.gemini/settings.json dosyasına ekleyin:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Claude Desktop'ın özel connector'ları API anahtarı header'ı gönderemediği için yerel sunucuyu kullanın. claude_desktop_config.json dosyasına ekleyin (Settings → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Diğer istemciler: yukarıdaki URL'yi Streamable HTTP taşıma yöntemi ve Authorization: Bearer header'ı ile kullanın. İstemci yalnızca yerel (stdio) sunucuları destekliyorsa bkz. Yerel olarak çalıştırma.
Çalıştığını kontrol edin
Agent'ınıza sorun:
Check my CaptchaSonic balance.
Agent get_balance çağırır ve bakiyenizi yanıtlar. ERROR_KEY_DOES_NOT_EXIST görürseniz, yapılandırmanızdaki anahtar yanlış veya iptal edilmiş demektir.
Agent'ınız neler yapabilir
| Araç | Kullanım amacı |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3, Turnstile, Cloudflare challenge, PopularCaptcha, GeeTest, MTCaptcha. Formla göndermek için bir token döndürür. |
solve_image_captcha | Resim ızgaraları, kaydırıcılar, tıklama challenge'ları, OCR metni ve ses. Yanıtı hemen döndürür. |
get_task_result | Hâlâ çözülmekte olan bir token'ı getirir. |
get_balance | Cüzdan bakiyesi ve plan limitleri. |
list_captcha_types | Desteklenen her türü ve gerekli alanlarını listeler. |
Tüm parametreler ve yanıt formatları: Araçlar referansı. Agent'ı bunu kendi başına yapacak şekilde kurmak: Agent'lar için.