Servidor MCP — Primeros pasos
Conecta Claude, Cursor, VS Code, Codex o cualquier cliente MCP a CaptchaSonic con una URL y tu clave de API, y resuelve CAPTCHAs desde cualquier agente de IA.
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, así que es compatible con Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI y cualquier otro cliente MCP.
Servidor alojado (recomendado)
Pega una URL y tu clave de API. No hay nada que instalar y siempre está actualizado.
Ejecutar en local
Para clientes que solo admiten servidores locales. Se ejecuta con npx. Consulta Ejecutar en local.
URL del servidor
https://mcp.captchasonic.com
Autentícate con tu clave de API de CaptchaSonic como token bearer:
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. 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.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Añade a ~/.cursor/mcp.json (o Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Añade a .vscode/mcp.json. VS Code pide la clave una vez y la guarda de forma segura:
{
"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 }
]
}
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Añade a ~/.codex/config.toml y exporta CAPTCHASONIC_API_KEY en tu shell:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Añade a ~/.gemini/settings.json:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
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):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
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.
Comprueba que funciona
Pregúntale a tu agente:
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. Configurar un agente para que haga esto por sí mismo: Para agentes.