Serveur MCP — Démarrage
Connectez Claude, Cursor, VS Code, Codex ou tout client MCP à CaptchaSonic avec une seule URL et votre clé API, et résolvez les CAPTCHA depuis n'importe quel agent IA.
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, il fonctionne donc avec Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI et tous les autres clients MCP.
Serveur hébergé (recommandé)
Collez une URL et votre clé API. Rien à installer, toujours à jour.
Exécution locale
Pour les clients qui ne prennent en charge que les serveurs locaux. Fonctionne avec npx. Voir Exécution locale.
URL du serveur
https://mcp.captchasonic.com
Authentifiez-vous avec votre clé API CaptchaSonic sous forme de jeton bearer :
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. 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.
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
Ajoutez dans ~/.cursor/mcp.json (ou Settings → MCP → Add server) :
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Ajoutez dans .vscode/mcp.json. VS Code demande la clé une seule fois et la stocke de manière sécurisée :
{
"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 }
]
}
Ajoutez dans ~/.codeium/windsurf/mcp_config.json :
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Ajoutez dans ~/.codex/config.toml et exportez CAPTCHASONIC_API_KEY dans votre shell :
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
Ajoutez dans ~/.gemini/settings.json :
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
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) :
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
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.
Vérifier le fonctionnement
Demandez à votre agent :
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. Configurer un agent pour qu'il fasse cela seul : Pour les agents.