Server MCP CaptchaSonic memberi AI agent apa pun tool untuk menyelesaikan CAPTCHA: reCAPTCHA v2/v3, Cloudflare Turnstile dan halaman tantangan, PopularCaptcha gaya hCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR, dan lainnya. Server ini menggunakan [Model Context Protocol](https://modelcontextprotocol.io), sehingga berfungsi di Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, dan setiap klien MCP lainnya.

  
    Tempel satu URL dan API key Anda. Tidak perlu instalasi, selalu up to date.
  
  
    Untuk klien yang hanya mendukung server lokal. Berjalan dengan `npx`. Lihat [Jalankan secara lokal](/docs/mcp/run-locally).
  

## URL server

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

Autentikasi dengan API key CaptchaSonic Anda sebagai bearer token:

```text
Authorization: Bearer sonic_xxx
```

> [!NOTE]
> Ini adalah URL server untuk klien MCP Anda, bukan halaman untuk dibuka di browser. Dapatkan API key Anda dari [dashboard](https://my.captchasonic.com). Penyelesaian ditagihkan ke key tersebut sama seperti panggilan API langsung, dan penyelesaian yang gagal dikembalikan dananya.

## Setup klien

Ganti `sonic_xxx` dengan API key Anda.

<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">

Tambahkan ke `~/.cursor/mcp.json` (atau **Settings → MCP → Add server**):

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

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

Tambahkan ke `.vscode/mcp.json`. VS Code meminta key sekali dan menyimpannya dengan aman:

```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">

Tambahkan ke `~/.codeium/windsurf/mcp_config.json`:

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

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

Tambahkan ke `~/.codex/config.toml` dan ekspor `CAPTCHASONIC_API_KEY` di shell Anda:

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

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

Tambahkan ke `~/.gemini/settings.json`:

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

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

Custom connector Claude Desktop tidak dapat mengirim header API key, jadi gunakan server lokal. Tambahkan ke `claude_desktop_config.json` (**Settings → Developer → Edit Config**):

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

  </LangTabs.Tab>
</LangTabs>

Klien lain: gunakan URL di atas dengan transport Streamable HTTP dan header `Authorization: Bearer`. Jika klien hanya mendukung server lokal (stdio), lihat [Jalankan secara lokal](/docs/mcp/run-locally).

## Pastikan berfungsi

Tanyakan ke agent Anda:

```text
Check my CaptchaSonic balance.
```

Agent akan memanggil `get_balance` dan membalas dengan saldo Anda. Jika muncul `ERROR_KEY_DOES_NOT_EXIST`, key di konfigurasi Anda salah atau sudah dicabut.

## Yang bisa dilakukan agent Anda

| Tool | Kegunaan |
|---|---|
| `solve_token_captcha` | reCAPTCHA v2/v3, Turnstile, tantangan Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Mengembalikan token untuk dikirim bersama formulir. |
| `solve_image_captcha` | Grid gambar, slider, tantangan klik, teks OCR, dan audio. Langsung mengembalikan jawaban. |
| `get_task_result` | Mengambil token yang masih diproses. |
| `get_balance` | Saldo dompet dan batas paket. |
| `list_captcha_types` | Setiap jenis yang didukung beserta field wajibnya. |

Parameter lengkap dan format jawaban: [Referensi tool](/docs/mcp/tools). Mengatur agent agar melakukannya sendiri: [Untuk agent](/docs/mcp/for-agents).
