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

  
    URLとAPIキーを貼り付けるだけです。インストールは不要で、常に最新の状態に保たれます。
  
  
    ローカルサーバーにのみ対応しているクライアント向けです。`npx`で実行します。詳しくは[ローカルで実行](/docs/mcp/run-locally)をご覧ください。
  

## サーバーURL

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

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

```text
Authorization: Bearer sonic_xxx
```

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

## クライアントの設定

`sonic_xxx`をご自身の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">

`~/.cursor/mcp.json`に追加します（または**Settings → MCP → Add server**から追加します）:

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

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

`.vscode/mcp.json`に追加します。VS Codeは一度だけキーの入力を求め、安全に保存します:

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

`~/.codeium/windsurf/mcp_config.json`に追加します:

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

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

`~/.codex/config.toml`に追加し、シェルで`CAPTCHASONIC_API_KEY`をexportします:

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

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

`~/.gemini/settings.json`に追加します:

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

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

Claude Desktopのカスタムコネクターでは、APIキーのヘッダーを送れないため、ローカルサーバーを使います。`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>

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

## 動作確認

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

```text
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` | 対応するすべてのタイプと、それぞれに必要なフィールド。 |

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