Agents IA & MCP
Utilisez CaptchaSonic depuis n'importe quel agent IA — Claude Code, Cursor, Windsurf, Antigravity, n8n — via le serveur MCP hébergé sur mcp.captchasonic.com, le serveur local npx ou directement le SDK.
CaptchaSonic est conçu pour les agents. Tout agent IA peut résoudre des CAPTCHA via notre serveur MCP, disponible de deux façons :
- Hébergé :
https://mcp.captchasonic.comavec votre clé API comme jeton bearer. Rien à installer. Recommandé. - Local :
npx -y @captchasonic/mcp-servervia stdio, pour les clients qui ne prennent en charge que les serveurs locaux.
Les deux exposent les mêmes cinq outils : solve_token_captcha, solve_image_captcha, get_task_result, get_balance et list_captcha_types. Commencez par le guide de démarrage MCP pour chaque client, ou consultez les notes par agent ci-dessous. Si votre agent ne peut pas parler MCP, appelez plutôt le SDK direct.
Parcours express pour les agents
Ajoutez ceci à n'importe quel agent : il peut résoudre des CAPTCHA en un seul aller-retour :
# Claude Code (or any MCP client): add the hosted server once
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
# Or, with no MCP — the same lifecycle via curl (replace TASK_ID after createTask):
curl -s https://api.captchasonic.com/createTask -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","taskId":"TASK_ID"}'
TIP
Orientez un agent vers MCP pour les agents IA. Il explique comment trouver les sitekeys, choisir le bon outil et soumettre le jeton, afin que l'agent puisse travailler sans instructions supplémentaires.
Claude Code
Ajoutez le serveur hébergé :
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
Vous préférez l'exécuter en local ? claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server vous donne les mêmes outils via stdio.
Plugin de compétences Claude (recommandé)
Pour des flux guidés, installez le plugin de compétences CaptchaSonic officiel. Il regroupe trois compétences Claude et connecte le serveur MCP hébergé à l'aide de la variable d'environnement SONIC_API_KEY. Exportez votre clé, démarrez Claude Code, puis exécutez :
/plugin marketplace add Captcha-Sonic/Agent-skills
/plugin install captchasonic
Trois compétences guident ensuite l'agent dans les flux courants :
captchasonic-setup— configuration initiale et vérification du MCP.captchasonic-solve— résolution de tout type de CAPTCHA, étape par étape.captchasonic-balance— consultation du solde et de l'état des crédits.
TIP
Utilisez get_balance (ou la compétence captchasonic-balance) comme garde-fou avant un lot de résolutions, afin que l'agent puisse s'arrêter tôt si les crédits sont insuffisants.
Antigravity
Enregistrez CaptchaSonic dans la configuration MCP d'Antigravity comme serveur stdio local :
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
Rechargez les serveurs MCP d'Antigravity et les outils CaptchaSonic apparaissent dans la liste d'outils de l'agent.
Cursor
Ouvrez Paramètres → MCP (ou modifiez ~/.cursor/mcp.json) et ajoutez le serveur hébergé :
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Windsurf
Ouvrez Paramètres → Cascade → MCP Servers (ou modifiez ~/.codeium/windsurf/mcp_config.json) :
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
MCP générique
Tout client MCP qui prend en charge les serveurs distants : utilisez https://mcp.captchasonic.com avec le transport Streamable HTTP et l'en-tête Authorization: Bearer sonic_xxx. Les configurations pour VS Code, Codex et Gemini CLI se trouvent dans le guide de démarrage.
Les clients qui ne exécutent que des serveurs locaux utilisent le bloc stdio standard (voir Exécution en local) :
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
n8n
CaptchaSonic dispose d'un nœud communautaire n8n vérifié (fiche n8n.io) qui encapsule plus de 20 types de CAPTCHA dans des nœuds de workflow glisser-déposer. Il fonctionne aussi bien comme nœud autonome que comme outil du nœud Agent IA de n8n.
→ Guide complet d'intégration n8n — installation pas à pas, configuration des identifiants, 4 recettes de workflow, configuration par type de CAPTCHA, gestion des erreurs et dépannage.
Installation rapide : Paramètres → Nœuds communautaires → installez n8n-nodes-captchasonic → créez un identifiant CaptchaSonic avec votre clé API → c'est terminé.
Sans MCP (SDK direct)
Si votre agent ne peut pas utiliser MCP, appelez directement le SDK. Un CAPTCHA de type jeton se résume à un seul appel de fonction.
result = solver.solve_turnstile(
website_url="https://example.com",
website_key="0x4AAAAAAA...",
proxy="http://user:pass@host:port", # optional
)
token = result["token"]await solver.solveTurnstile({
websiteURL: "https://example.com",
websiteKey: "0x4AAAAAAA...",
proxy: "http://user:[email protected]:8080",
});Consultez les pages SDK Python et SDK Node.js pour la liste complète des méthodes, ou la référence de l'API REST pour le cycle brut à trois appels.