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"
~/.cursor/mcp.jsonに追加します(またはSettings → MCP → Add serverから追加します):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
.vscode/mcp.jsonに追加します。VS Codeは一度だけキーの入力を求め、安全に保存します:
{
"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 }
]
}
~/.codeium/windsurf/mcp_config.jsonに追加します:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
~/.codex/config.tomlに追加し、シェルでCAPTCHASONIC_API_KEYをexportします:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
~/.gemini/settings.jsonに追加します:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Claude Desktopのカスタムコネクターでは、APIキーのヘッダーを送れないため、ローカルサーバーを使います。claude_desktop_config.jsonに追加します(Settings → Developer → Edit Configから開けます):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
その他のクライアントでは、上のURLをStreamable HTTPトランスポートとAuthorization: Bearerヘッダーとともに使ってください。クライアントがローカル(stdio)サーバーにしか対応していない場合は、ローカルで実行をご覧ください。
動作確認
エージェントに次のように尋ねてください:
Check my CaptchaSonic balance.
エージェントはget_balanceを呼び出し、残高を返信します。ERROR_KEY_DOES_NOT_EXISTと表示される場合は、設定内のキーが誤っているか、無効化されています。
エージェントにできること
| ツール | 用途 |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3、Turnstile、Cloudflareチャレンジ、PopularCaptcha、GeeTest、MTCaptcha。フォームと一緒に送信するトークンを返します。 |
solve_image_captcha | 画像グリッド、スライダー、クリックのチャレンジ、OCRテキスト、音声。回答をすぐに返します。 |
get_task_result | まだ解決中のトークンを取得します。 |
get_balance | ウォレットの残高とプランの上限。 |
list_captcha_types | 対応するすべてのタイプと、それぞれに必要なフィールド。 |
パラメーターと回答形式の全体は、ツールのリファレンスをご覧ください。エージェントがこれを自律的に行えるようにする設定は、エージェント向けをご覧ください。