MCP-Server — Erste Schritte
Verbinden Sie Claude, Cursor, VS Code, Codex oder jeden anderen MCP-Client mit CaptchaSonic über eine URL und Ihren API-Schlüssel, und lösen Sie CAPTCHAs aus jedem KI-Agenten heraus.
Der CaptchaSonic-MCP-Server gibt jedem KI-Agenten Tools zum Lösen von CAPTCHAs an die Hand: reCAPTCHA v2/v3, Cloudflare Turnstile und Challenge-Seiten, hCaptcha-artiges PopularCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR und mehr. Er spricht das Model Context Protocol und funktioniert daher in Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI und jedem anderen MCP-Client.
Gehosteter Server (empfohlen)
Fügen Sie eine URL und Ihren API-Schlüssel ein. Nichts zu installieren, immer aktuell.
Lokal ausführen
Für Clients, die nur lokale Server unterstützen. Läuft mit npx. Siehe Lokal ausführen.
Server-URL
https://mcp.captchasonic.com
Authentifizieren Sie sich mit Ihrem CaptchaSonic-API-Schlüssel als Bearer-Token:
Authorization: Bearer sonic_xxx
NOTE
Dies ist eine Server-URL für Ihren MCP-Client, keine Seite zum Öffnen im Browser. Holen Sie sich Ihren API-Schlüssel im Dashboard. Lösungen werden über diesen Schlüssel genauso abgerechnet wie direkte API-Aufrufe, und fehlgeschlagene Lösungen werden erstattet.
Client-Einrichtung
Ersetzen Sie sonic_xxx durch Ihren API-Schlüssel.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Fügen Sie dies zu ~/.cursor/mcp.json hinzu (oder über Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Fügen Sie dies zu .vscode/mcp.json hinzu. VS Code fragt den Schlüssel einmal ab und speichert ihn sicher:
{
"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 }
]
}
Fügen Sie dies zu ~/.codeium/windsurf/mcp_config.json hinzu:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Fügen Sie dies zu ~/.codex/config.toml hinzu und exportieren Sie CAPTCHASONIC_API_KEY in Ihrer Shell:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Fügen Sie dies zu ~/.gemini/settings.json hinzu:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Die benutzerdefinierten Connectors von Claude Desktop können keinen API-Schlüssel-Header senden, daher nutzen Sie den lokalen Server. Fügen Sie dies zu claude_desktop_config.json hinzu (Settings → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Jeder andere Client: Verwenden Sie die oben genannte URL mit dem Streamable-HTTP-Transport und einem Authorization: Bearer-Header. Unterstützt der Client nur lokale (stdio-)Server, siehe Lokal ausführen.
Funktion prüfen
Fragen Sie Ihren Agenten:
Check my CaptchaSonic balance.
Er ruft get_balance auf und antwortet mit Ihrem Guthaben. Sehen Sie ERROR_KEY_DOES_NOT_EXIST, ist der Schlüssel in Ihrer Konfiguration falsch oder widerrufen.
Was Ihr Agent tun kann
| Tool | Verwendung |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3, Turnstile, Cloudflare-Challenge, PopularCaptcha, GeeTest, MTCaptcha. Gibt ein Token zurück, das mit dem Formular übermittelt wird. |
solve_image_captcha | Bildraster, Schieberegler, Klick-Challenges, OCR-Text und Audio. Gibt die Antwort sofort zurück. |
get_task_result | Ein Token abrufen, das noch gelöst wird. |
get_balance | Guthaben im Wallet und Plan-Limits. |
list_captcha_types | Jeder unterstützte Typ mit seinen Pflichtfeldern. |
Alle Parameter und Antwortformate: Tool-Referenz. Einen Agenten so einrichten, dass er dies selbstständig tut: Für Agenten.