MCP 服务器 — 快速开始
只需一个 URL 和您的 API 密钥,即可将 Claude、Cursor、VS Code、Codex 及任何 MCP 客户端连接到 CaptchaSonic。让任意 AI 智能体求解 reCAPTCHA、Turnstile、hCaptcha 类、GeeTest 和图片验证码。
CaptchaSonic MCP 服务器为任何 AI 智能体提供验证码求解工具:reCAPTCHA v2/v3、Cloudflare Turnstile 和 Cloudflare 验证页、hCaptcha 类 PopularCaptcha、GeeTest、MTCaptcha、AWS WAF、TikTok、Binance、OCR 等。它基于 Model Context Protocol,因此可用于 Claude Code、Cursor、VS Code、Windsurf、Codex、Gemini CLI 以及所有其他 MCP 客户端。
托管服务器(推荐)
粘贴一个 URL 和您的 API 密钥即可。无需安装,始终保持最新。
本地运行
适用于只支持本地服务器的客户端,通过 npx 运行。参见本地运行。
Server URL
https://mcp.captchasonic.com
使用 CaptchaSonic API 密钥作为 Bearer 令牌进行认证:
Authorization: Bearer sonic_xxx
NOTE
这是供 MCP 客户端使用的服务器地址,不是用浏览器打开的页面。请在控制台获取 API 密钥。求解费用按与直接调用 API 相同的方式从该密钥扣除,失败的求解会退款。
Client setup
将 sonic_xxx 替换为您的 API 密钥。
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
添加到 ~/.cursor/mcp.json(或 Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
添加到 .vscode/mcp.json。VS Code 会提示输入一次密钥并安全保存:
{
"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 }
]
}
添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
添加到 ~/.codex/config.toml,并在 shell 中导出 CAPTCHASONIC_API_KEY:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
添加到 ~/.gemini/settings.json:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Claude Desktop 的自定义连接器无法发送 API 密钥请求头,因此请使用本地服务器。添加到 claude_desktop_config.json(Settings → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
其他客户端:使用上面的 URL,选择 Streamable HTTP 传输并添加 Authorization: Bearer 请求头。如果客户端只支持本地(stdio)服务器,请参见本地运行。
Check it works
对您的智能体说:
Check my CaptchaSonic balance.
它会调用 get_balance 并返回您的余额。如果看到 ERROR_KEY_DOES_NOT_EXIST,说明配置中的密钥错误或已被撤销。
What your agent can do
| 工具 | 用途 |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3、Turnstile、Cloudflare 验证页、PopularCaptcha、GeeTest、MTCaptcha。返回随表单提交的令牌。 |
solve_image_captcha | 图片网格、滑块、点选、文字识别和音频。立即返回答案。 |
get_task_result | 获取仍在求解中的令牌。 |
get_balance | 钱包余额和套餐限额。 |
list_captcha_types | 所有支持的类型及其必填字段。 |