Máy chủ MCP của CaptchaSonic cung cấp cho mọi AI agent các công cụ để giải CAPTCHA: reCAPTCHA v2/v3, Cloudflare Turnstile và trang thử thách, PopularCaptcha kiểu hCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR và nhiều loại khác. Máy chủ dùng [Model Context Protocol](https://modelcontextprotocol.io), nên hoạt động với Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI và mọi client MCP khác.

  
    Dán một URL và khóa API của bạn. Không cần cài đặt, luôn được cập nhật.
  
  
    Dành cho client chỉ hỗ trợ máy chủ cục bộ. Chạy bằng `npx`. Xem [Chạy cục bộ](/docs/mcp/run-locally).
  

## URL máy chủ

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

Xác thực bằng khóa API CaptchaSonic dưới dạng bearer token:

```text
Authorization: Bearer sonic_xxx
```

> [!NOTE]
> Đây là URL máy chủ cho client MCP của bạn, không phải trang để mở trên trình duyệt. Lấy khóa API từ [bảng điều khiển](https://my.captchasonic.com). Các lần giải được tính phí vào khóa đó giống hệt như gọi API trực tiếp, và lần giải thất bại sẽ được hoàn tiền.

## Thiết lập client

Thay `sonic_xxx` bằng khóa API của bạ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">

Thêm vào `~/.cursor/mcp.json` (hoặc **Settings → MCP → Add server**):

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

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

Thêm vào `.vscode/mcp.json`. VS Code sẽ hỏi khóa một lần và lưu trữ an toàn:

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

Thêm vào `~/.codeium/windsurf/mcp_config.json`:

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

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

Thêm vào `~/.codex/config.toml` và xuất `CAPTCHASONIC_API_KEY` trong shell của bạn:

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

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

Thêm vào `~/.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 của Claude Desktop không gửi được header khóa API, nên hãy dùng máy chủ cục bộ. Thêm vào `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>

Client khác: dùng URL ở trên với transport Streamable HTTP và header `Authorization: Bearer`. Nếu client chỉ hỗ trợ máy chủ cục bộ (stdio), xem [Chạy cục bộ](/docs/mcp/run-locally).

## Kiểm tra hoạt động

Hỏi agent của bạn:

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

Agent sẽ gọi `get_balance` và trả lời số dư của bạn. Nếu thấy `ERROR_KEY_DOES_NOT_EXIST`, khóa trong cấu hình của bạn sai hoặc đã bị thu hồi.

## Agent của bạn có thể làm gì

| Công cụ | Dùng để |
|---|---|
| `solve_token_captcha` | reCAPTCHA v2/v3, Turnstile, thử thách Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Trả về token để gửi cùng biểu mẫu. |
| `solve_image_captcha` | Lưới ảnh, thanh trượt, thử thách nhấp, văn bản OCR và âm thanh. Trả về đáp án ngay. |
| `get_task_result` | Lấy token của tác vụ vẫn đang giải. |
| `get_balance` | Số dư ví và giới hạn gói. |
| `list_captcha_types` | Mọi loại được hỗ trợ cùng các trường bắt buộc. |

Đầy đủ tham số và định dạng đáp án: [Tham chiếu công cụ](/docs/mcp/tools). Thiết lập agent để tự làm việc này: [Dành cho agent](/docs/mcp/for-agents).
