Servidor MCP — Primeiros passos
Conecte Claude, Cursor, VS Code, Codex ou qualquer cliente MCP ao CaptchaSonic com uma URL e sua chave de API, e resolva CAPTCHAs a partir de qualquer agente de IA.
O servidor MCP do CaptchaSonic oferece a qualquer agente de IA ferramentas para resolver CAPTCHAs: reCAPTCHA v2/v3, Cloudflare Turnstile e páginas de desafio, hCaptcha-style PopularCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR e outros. Ele usa o Model Context Protocol, então funciona no Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI e em todos os outros clientes MCP.
Servidor hospedado (recomendado)
Cole uma URL e sua chave de API. Nada para instalar, sempre atualizado.
Executar localmente
Para clientes que suportam apenas servidores locais. Executa com npx. Veja Executar localmente.
URL do servidor
https://mcp.captchasonic.com
Autentique-se com sua chave de API do CaptchaSonic como token bearer:
Authorization: Bearer sonic_xxx
NOTE
Esta é a URL do servidor para o seu cliente MCP, não uma página para abrir no navegador. Obtenha sua chave de API no painel. As resoluções são cobradas dessa chave exatamente como nas chamadas diretas à API, e as resoluções com falha são reembolsadas.
Configuração do cliente
Substitua sonic_xxx pela sua chave de API.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Adicione em ~/.cursor/mcp.json (ou Configurações → MCP → Adicionar servidor):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Adicione em .vscode/mcp.json. O VS Code pede a chave uma vez e a armazena com segurança:
{
"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 }
]
}
Adicione em ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Adicione em ~/.codex/config.toml e exporte CAPTCHASONIC_API_KEY no seu shell:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Adicione em ~/.gemini/settings.json:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Os conectores personalizados do Claude Desktop não conseguem enviar um cabeçalho com a chave de API, então use o servidor local. Adicione em claude_desktop_config.json (Configurações → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Qualquer outro cliente: use a URL acima com o transporte Streamable HTTP e um cabeçalho Authorization: Bearer. Se o cliente suportar apenas servidores locais (stdio), veja Executar localmente.
Verifique se funciona
Pergunte ao seu agente:
Check my CaptchaSonic balance.
Ele chama get_balance e responde com o seu saldo. Se aparecer ERROR_KEY_DOES_NOT_EXIST, a chave na sua configuração está incorreta ou foi revogada.
O que o seu agente pode fazer
| Ferramenta | Use para |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3, Turnstile, desafio Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Retorna um token para enviar com o formulário. |
solve_image_captcha | Grades de imagens, controles deslizantes, desafios de clique, texto OCR e áudio. Retorna a resposta imediatamente. |
get_task_result | Busca um token que ainda está sendo resolvido. |
get_balance | Saldo da carteira e limites do plano. |
list_captcha_types | Todos os tipos suportados com seus campos obrigatórios. |
Parâmetros completos e formatos de resposta: Referência de ferramentas. Configurar um agente para fazer isso sozinho: Para agentes.