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](https://modelcontextprotocol.io), então funciona no Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI e em todos os outros clientes MCP.

  
    Cole uma URL e sua chave de API. Nada para instalar, sempre atualizado.
  
  
    Para clientes que suportam apenas servidores locais. Executa com `npx`. Veja [Executar localmente](/docs/mcp/run-locally).
  

## URL do servidor

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

Autentique-se com sua chave de API do CaptchaSonic como token bearer:

```text
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](https://my.captchasonic.com). 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.

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

Adicione em `~/.cursor/mcp.json` (ou **Configurações → MCP → Adicionar servidor**):

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

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

Adicione em `.vscode/mcp.json`. O VS Code pede a chave uma vez e a armazena com segurança:

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

Adicione em `~/.codeium/windsurf/mcp_config.json`:

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

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

Adicione em `~/.codex/config.toml` e exporte `CAPTCHASONIC_API_KEY` no seu shell:

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

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

Adicione em `~/.gemini/settings.json`:

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

  </LangTabs.Tab>
  <LangTabs.Tab label="Claude Desktop">

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**):

```json
{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
</LangTabs>

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](/docs/mcp/run-locally).

## Verifique se funciona

Pergunte ao seu agente:

```text
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](/docs/mcp/tools). Configurar um agente para fazer isso sozinho: [Para agentes](/docs/mcp/for-agents).
