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](https://modelcontextprotocol.io) und funktioniert daher in Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI und jedem anderen MCP-Client.

  
    Fügen Sie eine URL und Ihren API-Schlüssel ein. Nichts zu installieren, immer aktuell.
  
  
    Für Clients, die nur lokale Server unterstützen. Läuft mit `npx`. Siehe [Lokal ausführen](/docs/mcp/run-locally).
  

## Server-URL

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

Authentifizieren Sie sich mit Ihrem CaptchaSonic-API-Schlüssel als Bearer-Token:

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

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

Fügen Sie dies zu `~/.cursor/mcp.json` hinzu (oder über **Settings → MCP → Add server**):

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

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

Fügen Sie dies zu `.vscode/mcp.json` hinzu. VS Code fragt den Schlüssel einmal ab und speichert ihn sicher:

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

Fügen Sie dies zu `~/.codeium/windsurf/mcp_config.json` hinzu:

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

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

Fügen Sie dies zu `~/.codex/config.toml` hinzu und exportieren Sie `CAPTCHASONIC_API_KEY` in Ihrer Shell:

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

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

Fügen Sie dies zu `~/.gemini/settings.json` hinzu:

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

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

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

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

  </LangTabs.Tab>
</LangTabs>

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

## Funktion prüfen

Fragen Sie Ihren Agenten:

```text
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](/docs/mcp/tools). Einen Agenten so einrichten, dass er dies selbstständig tut: [Für Agenten](/docs/mcp/for-agents).
