Máy chủ MCP — Bắt đầu
Kết nối Claude, Cursor, VS Code, Codex hoặc bất kỳ client MCP nào với CaptchaSonic bằng một URL và khóa API, rồi giải CAPTCHA từ mọi AI agent.
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, nên hoạt động với Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI và mọi client MCP khác.
Máy chủ hosted (khuyến nghị)
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.
Chạy cục bộ
Dành cho client chỉ hỗ trợ máy chủ cục bộ. Chạy bằng npx. Xem Chạy cục bộ.
URL máy chủ
https://mcp.captchasonic.com
Xác thực bằng khóa API CaptchaSonic dưới dạng bearer token:
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. 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.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Thêm vào ~/.cursor/mcp.json (hoặc Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
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:
{
"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 }
]
}
Thêm vào ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Thêm vào ~/.codex/config.toml và xuất CAPTCHASONIC_API_KEY trong shell của bạn:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Thêm vào ~/.gemini/settings.json:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
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):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
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ộ.
Kiểm tra hoạt động
Hỏi agent của bạn:
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ụ. Thiết lập agent để tự làm việc này: Dành cho agent.