Skip to content
CaptchaSonic

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"

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

ToolVerwendung
solve_token_captchareCAPTCHA v2/v3, Turnstile, Cloudflare-Challenge, PopularCaptcha, GeeTest, MTCaptcha. Gibt ein Token zurück, das mit dem Formular übermittelt wird.
solve_image_captchaBildraster, Schieberegler, Klick-Challenges, OCR-Text und Audio. Gibt die Antwort sofort zurück.
get_task_resultEin Token abrufen, das noch gelöst wird.
get_balanceGuthaben im Wallet und Plan-Limits.
list_captcha_typesJeder 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.