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](https://modelcontextprotocol.io) üzerinden çalışır; bu yüzden Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI ve diğer tüm MCP istemcilerinde kullanılabilir.

  
    Tek bir URL ve API anahtarınızı yapıştırın. Kurulum gerektirmez, her zaman güncel kalır.
  
  
    Yalnızca yerel sunucuları destekleyen istemciler için. `npx` ile çalışır. Bkz. [Yerel olarak çalıştırma](/docs/mcp/run-locally).
  

## Sunucu URL'si

```text
https://mcp.captchasonic.com
```

CaptchaSonic API anahtarınızla bearer token olarak kimlik doğrulayın:

```text
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](https://my.captchasonic.com) ü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.

<LangTabs>
  <LangTabs.Tab label="Claude Code">

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

  </LangTabs.Tab>
  <LangTabs.Tab label="Cursor">

`~/.cursor/mcp.json` dosyasına ekleyin (veya **Settings → MCP → Add server**):

```json
{
  "mcpServers": {
    "captchasonic": {
      "url": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="VS Code">

`.vscode/mcp.json` dosyasına ekleyin. VS Code anahtarı bir kez sorar ve güvenli şekilde saklar:

```json
{
  "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 }
  ]
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Windsurf">

`~/.codeium/windsurf/mcp_config.json` dosyasına ekleyin:

```json
{
  "mcpServers": {
    "captchasonic": {
      "serverUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Codex">

`~/.codex/config.toml` dosyasına ekleyin ve shell'inizde `CAPTCHASONIC_API_KEY` değişkenini export edin:

```toml
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Gemini CLI">

`~/.gemini/settings.json` dosyasına ekleyin:

```json
{
  "mcpServers": {
    "captchasonic": {
      "httpUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Claude Desktop">

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**):

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

  </LangTabs.Tab>
</LangTabs>

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](/docs/mcp/run-locally).

## Çalıştığını kontrol edin

Agent'ınıza sorun:

```text
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ı](/docs/mcp/tools). Agent'ı bunu kendi başına yapacak şekilde kurmak: [Agent'lar için](/docs/mcp/for-agents).
