CaptchaSonic bersifat **agent-native**. AI agent apa pun dapat menyelesaikan CAPTCHA melalui **server MCP** kami, yang tersedia dalam dua cara:

- **Hosted:** `https://mcp.captchasonic.com` dengan API key Anda sebagai bearer token. Tidak perlu instalasi. Direkomendasikan.
- **Lokal:** `npx -y @captchasonic/mcp-server` melalui 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](/docs/mcp/get-started) untuk setiap client, atau baca catatan per agent di bawah. Jika agent Anda tidak dapat menggunakan MCP, panggil [SDK langsung](#without-mcp-direct-sdk) sebagai gantinya.

## Jalur Cepat untuk Agent

Tempelkan ini ke agent mana pun dan agent tersebut dapat menyelesaikan CAPTCHA dalam satu kali round trip:

```bash
# 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](/docs/mcp/for-agents). 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:

```bash
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:

```bash
/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:

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

```json
{
  "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`):

```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](/docs/mcp/get-started).

Client yang hanya menjalankan server lokal menggunakan blok stdio standar (lihat [Jalankan secara lokal](/docs/mcp/run-locally)):

```json
{
  "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](https://n8n.io/integrations/captchasonic/)) 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](/docs/integrations/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.

<LangTabs>
  <LangTabs.Tab label="Python">

<Snippet sdk="python" region="solveTurnstile" />

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

<Snippet sdk="typescript" region="solveTurnstile" />

  </LangTabs.Tab>
</LangTabs>

Lihat halaman [Python SDK](/docs/clients-sdks/python) dan [Node.js SDK](/docs/clients-sdks/nodejs) untuk daftar metode lengkap, atau [referensi REST API](/docs/api) untuk siklus tiga panggilan mentah.
