Skip to content
CaptchaSonic

MCPサーバー — はじめに

Claude、Cursor、VS Code、Codex、その他のMCPクライアントを、1つのURLとAPIキーでCaptchaSonicに接続し、どのAIエージェントからでもCAPTCHAを解決できます。

CaptchaSonic MCPサーバーは、どのAIエージェントにもCAPTCHA解決のツールを提供します。対応するのは、reCAPTCHA v2/v3、Cloudflare Turnstileとチャレンジページ、hCaptcha系のPopularCaptcha、GeeTest、MTCaptcha、AWS WAF、TikTok、Binance、OCRなどです。Model Context Protocolに対応しているため、Claude Code、Cursor、VS Code、Windsurf、Codex、Gemini CLI、その他すべてのMCPクライアントで動作します。

ホスト型サーバー(推奨)

URLとAPIキーを貼り付けるだけです。インストールは不要で、常に最新の状態に保たれます。

ローカルで実行

ローカルサーバーにのみ対応しているクライアント向けです。npxで実行します。詳しくはローカルで実行をご覧ください。

サーバーURL

https://mcp.captchasonic.com

CaptchaSonic APIキーを、ベアラートークンとして使って認証します:

Authorization: Bearer sonic_xxx

NOTE

これはMCPクライアント用のサーバーURLです。ブラウザーで開くページではありません。APIキーはダッシュボードで取得してください。解決の料金は、直接のAPI呼び出しと同様にそのキーに請求され、失敗した解決は返金されます。

クライアントの設定

sonic_xxxをご自身のAPIキーに置き換えてください。

claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
  --header "Authorization: Bearer sonic_xxx"

その他のクライアントでは、上のURLをStreamable HTTPトランスポートとAuthorization: Bearerヘッダーとともに使ってください。クライアントがローカル(stdio)サーバーにしか対応していない場合は、ローカルで実行をご覧ください。

動作確認

エージェントに次のように尋ねてください:

Check my CaptchaSonic balance.

エージェントはget_balanceを呼び出し、残高を返信します。ERROR_KEY_DOES_NOT_EXISTと表示される場合は、設定内のキーが誤っているか、無効化されています。

エージェントにできること

ツール用途
solve_token_captchareCAPTCHA v2/v3、Turnstile、Cloudflareチャレンジ、PopularCaptcha、GeeTest、MTCaptcha。フォームと一緒に送信するトークンを返します。
solve_image_captcha画像グリッド、スライダー、クリックのチャレンジ、OCRテキスト、音声。回答をすぐに返します。
get_task_resultまだ解決中のトークンを取得します。
get_balanceウォレットの残高とプランの上限。
list_captcha_types対応するすべてのタイプと、それぞれに必要なフィールド。

パラメーターと回答形式の全体は、ツールのリファレンスをご覧ください。エージェントがこれを自律的に行えるようにする設定は、エージェント向けをご覧ください。