クラウドコード CAPTCHA ソルバー: カップソルバー MCP セットアップガイド

TL;DR

• オフィシャルなcapsolver-mcpパッケージにClaude Codeを接続し、サポートされているCAPTCHA解消ツールを公開します。
• サポートされているCAPTCHAの種類をまず一覧表示してください。成功したツールの接続は、有料の解消リクエストが成功することを保証するものではありません。
• 既にサポートされているチャレンジタイプ、ページURL、サイトキーを持っている場合はsolve_captchaを使用してください。
• ページツールは独自のブラウザセッションを開きます。既存のClaudeブラウザタブを自動的に継続するものではありません。
• 返されたトークンや埋められたウィジェットは、ターゲットアプリケーションの最終的な承認チェックが必要です。

Claude Codeはブラウザタスクの作成やデバッグを支援できますが、サポートされているCAPTCHAが承認された操作を妨げる場合、実際の解消ツールが必要です。モデルに「より頑張って」と依頼しても、サイトパラメータ、API接続、結果の処理は提供されません。

CapSolverはMCPサービスを通じてこれらの機能を公開しています。このガイドでは、パッケージのインストール、Claude Codeへの接続、利用可能なツールの確認、解消呼び出しの選択について説明します。例は自分のページや許可された自動化タスクに関連しています。アカウントの作成や購入、制限されたデータへのアクセスを自動化するものではありません。

CapSolver MCPでClaude Codeが何ができるか？

Claude Codeは、サーバーを設定し承認した後、CapSolverのMCPツールを発見および呼び出すことができます。

オフィシャルなMCPサービスは5つのツールを公開しています：

ツール名は別々の操作を表しています。残高照会はページを認識しませんし、ウィジェットの検出は解消することを意味しません。実際に必要な操作から始めましょう。

このガイドで確認したインストールバージョンであるcapsolver-mcp 0.1.3は、サポートされているタイプツールを通じてreCaptchaV2、reCaptchaV3、およびcloudflareをリストアップしています。このインターフェースでは、CloudflareハンドラはTurnstileを指しています。名前をすべてのCloudflare応答やフルページチャレンジのサポートと誤解しないでください。

REST APIには他のタスクファミリがありますが、これらは自動的にこのMCPツールセットに追加されません。特に、CapSolverの別個のAPIが画像認識をサポートしているからといって、solve_captchaにImageToTextタスクを渡さないでください。

オフィシャルパッケージのインストール

Claude Codeが起動するPython環境に、CapSolverコア、MCPサーバー、およびブラウザの依存関係をインストールしてください。

以下のコマンドは、ここでのコアとMCPバージョンをピン留めしています：

python -m pip install capsolver-core==0.1.1 "capsolver-mcp[browser]==0.1.3"
python -m playwright install chromium

インストールはCapSolverのオフィシャルパッケージの指示に従います。ブラウザ拡張機能とChromiumはページツールに必要です。Playwrightブラウザのインストールガイドは、ブラウザバイナリがPythonパッケージとは別個の依存関係であることを説明しています。

次のステップでこのPython実行ファイルを使用してください。仮想環境にインストールし、別のPythonを設定した場合、capsolver_mcpをインポートできないとクライアントが報告する可能性がありますが、他の場所でインストールに成功している場合もあります。

Claude CodeとCapSolverアカウントキーも必要です。実際の解消に使用するには、Claude Codeを起動する環境にCAPSOLVER_API_KEYとして保存してください。チャットプロンプトに貼り付けたり、共有プロジェクトファイルにコミットしないでください。

パッケージの接続とローカル検出パスは、有料の認識とは別に確認できます。このガイドではライブの有料解消は示しません。そのステップには、アカウントと承認されたターゲットの現在のパラメータが必要です。

プロジェクトMCP設定にCapSolverを追加

プロジェクトの.mcp.jsonに、インストールしたパッケージのPython環境を指すcapsolverエントリを追加してください。

以下の構成は、CapSolverの文書化されたPythonモジュール起動パターンとClaude Codeの環境変数展開を使用しています。実際の絶対パスに置き換えてください：

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      }
    }
  }
}

.mcp.jsonに既存のサーバーが含まれている場合、既存のmcpServersオブジェクト内にこのエントリを追加してください。キーバリューはJSONファイルの外に保持されますが、Claude Codeを起動する際には変数が利用可能である必要があります。

Claude Codeの[MCP設定ドキュメントは、プロジェクトの範囲、環境変数の展開、サーバーの承認をカバーしています。意図したプロジェクトからClaude Codeを起動し、プロジェクトサーバーの承認プロンプトを確認し、インストールしたコマンドとパッケージが正しいことを確認した後のみ、このサーバーを承認してください。

プロジェクトディレクトリから設定を確認してください：

claude mcp list

対話型のClaude Codeセッション内で/mcpを使用してサーバーの状態と利用可能なコントロールを検査してください。保留中の承認ステータスは、プロジェクトサーバーがまだあなたのレビューを待っていることを意味します。実行可能ファイルが見つからないや接続に失敗した場合とは異なります。

解消をリクエストする前にツールを確認する

アカウントクレジットを消費する前に、Claude CodeにサポートされているCAPTCHAタイプを一覧表示してください。

適切な最初のリクエストは：

CapSolverのget_supported_captchasツールを使用し、このサーバーが現在サポートしているCAPTCHAタイプを教えてください。解消タスクを送信しないでください。

これにより、クライアントが実際のツールに接続できることを確認し、インストールされたサーバーの実際のカバレッジを得られます。MCPの[接続ライフサイクルは、初期化と後の操作を分離しています。接続の確立は、使い始めの開始に過ぎません。

アカウント照会のために、get_balanceをリクエストできます。アカウント情報が含まれる場合は、応答を非公開にしてください。この失敗はアカウントアクセスまたはサービス通信の問題を示し、有料解消を試みる前に解決する必要があります。

「CapSolverを知っている」というモデルの発言で準備状況を判断しないでください。実際のツールの結果を検査してください。発見されたツール、成功したアカウント照会、完了したCAPTCHA解消は異なる事実を確立します。

CapSolverのボーナスコードを取得する

自動化予算を即座に増やす！
CapSolverアカウントにチャージする際にボーナスコードCAP26を使用すると、すべてのチャージで5%のボーナスが得られます—制限なし。
今すぐCapSolverダッシュボードで取得してください。

知られているチャレンジパラメータでトークンモードを使用する

承認されたブラウザまたはアプリケーションフローがすでに必要なタイプ、ページURL、サイトキーを提供している場合はsolve_captchaを使用してください。

たとえば、Claude Codeに次のように指示してください：

私の承認されたテストページでreCAPTCHA v2を一度だけCapSolverのsolve_captchaで解消してください。私が提供した正確なページURLとサイトキーを使用してください。どちらかが欠けている場合は、推測せず、欠けた入力を報告してください。要約ではフルトークンを出力せず、ツールのステータスを返してください。

ツールのスキーマではcaptcha_type、website_url、website_keyを使用します。処理しているチャレンジで必要な追加パラメータを確認するには、発見されたスキーマをチェックしてください。RESTタスク名をMCPタイプフィールドにコピーしないでください。reCaptchaV2はMCP値であり、REST APIには独自の文書化されたタスク名があります。

その後、アプリケーションはターゲットの意図されたフローを通じて返されたトークンを消費する必要があります。MCP呼び出し自体はすべてのフォームを送信したり、ビジネス結果を検証したりしません。ページ固有のreCAPTCHA入力については、reCAPTCHA v2タスクドキュメントを参照してください。

パラメータが不明な場合、適切なブラウザツールで現在の承認されたページを検査してください。他のページから記憶したサイトキーは、現在のウィジェットの証拠ではありません。解決は実際にデバッグ中の操作に接続しておく必要があります。

ページツールを使用する際のブラウザ境界を意識する

ページツールはURLを受け入れ、MCPサービスによって作成されたブラウザセッションで動作します。

検出用に役立つリクエストは：

この承認されたページURLでCapSolverのdetect_captchasを呼び出し、検出されたタイプを報告してください。まだ解消しないでください。

ページの解消が意図された操作である場合、solve_on_pageはドキュメント化された検出、解消、結果の入力シーケンスを実行できます。そのコールを要求する前に、観測されたチャレンジとサポートされているカバレッジを確認してください。

重要な境界は、オフィシャルなMCP実装に表示されています：これらのツールはコール時にブラウザを開き、その後閉じます。別のブラウザMCPが保持するタブに接続したり、そのログイン状態を自動的に引き継ぐことはありません。

これは、いくつかのプライベートセッションステップを経てのみ利用可能なページよりも、直接アクセス可能なテストページの方が明確な出発点になります。タスクがすでに制御しているブラウザページに残らなければならない場合、その既存ページで動作するサポートされた統合を使用してください。CapSolver Core SDKは、この異なる統合要件のためのブラウザアダプター機能を文書化しています。

既存の[Claude Computer Useガイドは、隣接するブラウザエージェントの表面を議論しています。Claude Computer UseとこのClaude Code MCP設定は、交換可能な構成として扱われてはなりません。

CAPTCHAコールを繰り返す前にセットアップエラーを修正する

ほとんどのセットアップエラーは、実行可能ファイルのパス、環境、ブラウザのインストール、またはタスク入力に絞られます。

サーバーコマンドが見つからない場合、上記の絶対Pythonパスを使用してください。パッケージがインポートできない場合、同じPython環境にcapsolver-mcpとcapsolver-coreが含まれていることを確認してください。

ページ検出がブラウザ実行可能ファイルが見つからないと報告する場合、MCPサーバーを起動する環境でChromiumのインストールコマンドを実行してください。トークンモードではブラウザを起動する必要がないため、ブラウザスタートアップエラーとソルバーAPIエラーを区別してください。

サーバーが接続できたがAPIコールが失敗した場合、返されたエラーコードと赤色にされた要約を保持してください。別の試みを行う前に、アカウントキー、サポートされているタイプ、必要な入力、および現在のページ状態を確認してください。

解決がトークンを返すが元のアプリケーションが変化しない場合、結果の消費を検査してください。結果が意図されたワークフローで使用されたことを確認し、2つの別個のブラウザセッションが状態を共有していると仮定していないことを確認してください。

繰り返し試行の数を小さく保ちます。同じエラーが解決されない場合、エビデンスをレビューに返して、エージェントに無限に再試行するように指示しないでください。

CapSolverで信頼性のある自動化ワークフローを構築する

実際のMCP接続から始め、インストールされたツールセットを検査し、承認されたタスクのチャレンジに一致する操作をリクエストしてください。

CapSolverはClaude Codeに文書化されたCAPTCHA解消機能を提供します。正しい入力と明確なブラウザ境界がその機能を有用にし、最終的なアプリケーションの応答が意図されたタスクが実際に完了したかどうかを教えてくれます。

FAQ

Q: すべてのMCPツールでブラウザの依存関係が必要ですか？

いいえ。ページツールはブラウザ拡張機能とChromiumが必要です。トークンの解決やアカウントまたはカバレッジの照会は、対応するサービスやローカル機能を呼び出すためにブラウザを開く必要はありません。

Q: CapSolver MCPは既存のブラウザタブを継続できますか？

チェックされたバージョンのページツールは独自のブラウザセッションを開き、閉じます。別のブラウザツールが所有するタブを制御していると仮定しないでください。

Q: MCPサーバーはすべてのCapSolver RESTタスクをサポートしていますか？

いいえ。get_supported_captchasと発見されたツールスキーマをチェックしてください。別個のREST機能はこのMCPパッケージを通じて自動的に公開されません。

Q: Claude Codeが保留中の承認を表示するのはなぜですか？

プロジェクトのMCPサーバーは使用前に承認が必要な場合があります。Claude Codeで確認し、設定されたコマンドを確認してください。承認ステータスをAPIキーのエラーと誤って扱わないでください。

Q: 成功した解決はエージェントがタスクを完了したことを意味しますか？

いいえ。結果が意図されたアプリケーションで使用されたことを確認し、リクエストされたページ操作が完了したことを確認してください。トークンや埋められたウィジェットは中間結果です。