Le serveur MCP CaptchaSonic fournit à tout agent IA des outils pour résoudre les CAPTCHA : reCAPTCHA v2/v3, Cloudflare Turnstile et pages de défi, PopularCaptcha de style hCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR et plus encore. Il utilise le [Model Context Protocol](https://modelcontextprotocol.io), il fonctionne donc avec Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI et tous les autres clients MCP.

  
    Collez une URL et votre clé API. Rien à installer, toujours à jour.
  
  
    Pour les clients qui ne prennent en charge que les serveurs locaux. Fonctionne avec `npx`. Voir [Exécution locale](/docs/mcp/run-locally).
  

## URL du serveur

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

Authentifiez-vous avec votre clé API CaptchaSonic sous forme de jeton bearer :

```text
Authorization: Bearer sonic_xxx
```

> [!NOTE]
> Il s'agit de l'URL du serveur pour votre client MCP, et non d'une page à ouvrir dans un navigateur. Obtenez votre clé API sur le [tableau de bord](https://my.captchasonic.com). Les résolutions sont facturées sur cette clé exactement comme les appels API directs, et les résolutions en échec sont remboursées.

## Configuration du client

Remplacez `sonic_xxx` par votre clé 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">

Ajoutez dans `~/.cursor/mcp.json` (ou **Settings → MCP → Add server**) :

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

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

Ajoutez dans `.vscode/mcp.json`. VS Code demande la clé une seule fois et la stocke de manière sécurisée :

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

Ajoutez dans `~/.codeium/windsurf/mcp_config.json` :

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

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

Ajoutez dans `~/.codex/config.toml` et exportez `CAPTCHASONIC_API_KEY` dans votre shell :

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

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

Ajoutez dans `~/.gemini/settings.json` :

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

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

Les connecteurs personnalisés de Claude Desktop ne peuvent pas envoyer d'en-tête de clé API ; utilisez donc le serveur local. Ajoutez dans `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>

Pour tout autre client : utilisez l'URL ci-dessus avec le transport Streamable HTTP et un en-tête `Authorization: Bearer`. Si le client ne prend en charge que les serveurs locaux (stdio), voir [Exécution locale](/docs/mcp/run-locally).

## Vérifier le fonctionnement

Demandez à votre agent :

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

Il appelle `get_balance` et vous répond avec votre solde. Si vous voyez `ERROR_KEY_DOES_NOT_EXIST`, la clé de votre configuration est incorrecte ou révoquée.

## Ce que votre agent peut faire

| Outil | Utilisation |
|---|---|
| `solve_token_captcha` | reCAPTCHA v2/v3, Turnstile, défi Cloudflare, PopularCaptcha, GeeTest, MTCaptcha. Renvoie un jeton à soumettre avec le formulaire. |
| `solve_image_captcha` | Grilles d'images, curseurs, défis de clic, texte OCR et audio. Renvoie la réponse immédiatement. |
| `get_task_result` | Récupère un jeton encore en cours de résolution. |
| `get_balance` | Solde du portefeuille et limites du forfait. |
| `list_captcha_types` | Chaque type pris en charge avec ses champs requis. |

Paramètres complets et formats de réponse : [Référence des outils](/docs/mcp/tools). Configurer un agent pour qu'il fasse cela seul : [Pour les agents](/docs/mcp/for-agents).
