El servidor MCP de CaptchaSonic da a cualquier agente de IA herramientas para resolver CAPTCHAs: reCAPTCHA v2/v3, Cloudflare Turnstile y páginas de desafío, PopularCaptcha de tipo hCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR y más. Funciona con el [Model Context Protocol](https://modelcontextprotocol.io), así que es compatible con Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI y cualquier otro cliente MCP.

  
    Pega una URL y tu clave de API. No hay nada que instalar y siempre está actualizado.
  
  
    Para clientes que solo admiten servidores locales. Se ejecuta con `npx`. Consulta [Ejecutar en local](/docs/mcp/run-locally).
  

## URL del servidor

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

Autentícate con tu clave de API de CaptchaSonic como token bearer:

```text
Authorization: Bearer sonic_xxx
```

> [!NOTE]
> Esta es una URL de servidor para tu cliente MCP, no una página para abrir en el navegador. Obtén tu clave de API en el [panel](https://my.captchasonic.com). Las resoluciones se cargan a esa clave exactamente igual que las llamadas directas a la API, y las resoluciones fallidas se reembolsan.

## Configuración del cliente

Sustituye `sonic_xxx` por tu clave 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">

Añade a `~/.cursor/mcp.json` (o **Settings → MCP → Add server**):

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

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

Añade a `.vscode/mcp.json`. VS Code pide la clave una vez y la guarda de forma segura:

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

Añade a `~/.codeium/windsurf/mcp_config.json`:

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

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

Añade a `~/.codex/config.toml` y exporta `CAPTCHASONIC_API_KEY` en tu shell:

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

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

Añade a `~/.gemini/settings.json`:

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

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

Los conectores personalizados de Claude Desktop no pueden enviar una cabecera con la clave de API, así que usa el servidor local. Añade a `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>

Cualquier otro cliente: usa la URL de arriba con el transporte Streamable HTTP y una cabecera `Authorization: Bearer`. Si el cliente solo admite servidores locales (stdio), consulta [Ejecutar en local](/docs/mcp/run-locally).

## Comprueba que funciona

Pregúntale a tu agente:

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

Llamará a `get_balance` y te responderá con tu saldo. Si ves `ERROR_KEY_DOES_NOT_EXIST`, la clave de tu configuración es incorrecta o ha sido revocada.

## Lo que puede hacer tu agente

| Herramienta | Para qué sirve |
|---|---|
| `solve_token_captcha` | reCAPTCHA v2/v3, Turnstile, desafío de Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Devuelve un token para enviar con el formulario. |
| `solve_image_captcha` | Cuadrículas de imágenes, deslizadores, desafíos de clic, OCR de texto y audio. Devuelve la respuesta de inmediato. |
| `get_task_result` | Obtiene un token que todavía se está resolviendo. |
| `get_balance` | Saldo de la cartera y límites del plan. |
| `list_captcha_types` | Todos los tipos admitidos con sus campos obligatorios. |

Parámetros completos y formatos de respuesta: [Referencia de herramientas](/docs/mcp/tools). Configurar un agente para que haga esto por sí mismo: [Para agentes](/docs/mcp/for-agents).
