CapSolver MCPサーバーの使い方：AIエージェントの設定ガイド

TL;DR

• CapSolver MCPサーバーは5つのドキュメント済みツールを公開しています: solve_captcha、detect_captchas、solve_on_page、get_balance、およびget_supported_captchas。
• capsolver-coreをcapsolver-mcpの前にインストールし、MCPクライアントを設定して、環境変数にAPIキーを含むcapsolver-mcpコマンドを起動します。
• ブラウザツールにはブラウザエクストラとChromiumが必要です。トークンモードでは、CAPTCHAの種類、ページURL、サイトキーが既知であればブラウザが不要です。
• プロダクションエージェントには承認済みホストルール、1回のバウンデッドリカバリーアタック、ロギングのマスキング、アプリケーションレベルの成功チェックが必要です。

イントロダクション

CapSolver MCPサーバーの使い方についての最も安全な答えは、CAPTCHA処理をエージェントの新しい権限の源泉ではなく、狭いインフラストラクチャツールとして扱うことです。CapSolverは、公式のcapsolver-mcpサービスを提供しており、capsolver-coreをラップし、互換性のあるAIクライアントがドキュメント済みのCAPTCHAツールを検出できるようにします。エージェントは、認可されたブラウザワークフロー内でreCAPTCHA v2、reCAPTCHA v3（Enterpriseを含む）、またはCloudflare Turnstileの中断を回復できます。あなたのアプリケーションはスコープ、資格情報、リトライ制限、最終的なビジネスアサーションを所有しています。このガイドでは、実際のインストールとJSON構成を示し、すべてのツールと出力境界を説明し、法的で合理的で責任ある使用の停止条件を定義します。これはプライベート、制限、機密、または不正なデータへのアクセスを許可しません。

CapSolverの3つのレイヤーを理解する

CapSolver MCPサーバーの使い方を決める前に、製品レイヤーを分離してください。CapSolver for AI Agents overviewは、回復レイヤーアーキテクチャを説明しています。capsolver-coreは検出と解決を担当し、capsolver-agentはそれらのメソッドをエージェント呼び出し可能なスキーマにアダプトし、capsolver-mcpは同じ機能をMCPを介して公開します。

core SDK APIはcreate_capsolver、detect、get_captcha_info、solve、およびsolve_on_pageをドキュメント化しています。agent tool adapterはget_all_toolsとcreate_executorをドキュメント化しています。MCPサービスガイドは、インストール、トランスポート、構成、および5つのMCPツールの真実のソースです。

クライアントが既にMCPを話している場合にMCPを使用する

Claude Desktop、Cursor、Cline、VS Codeクライアント、または他の互換性のあるホストでCapSolver MCPサーバーを使用してください。関数コールループを自分で書いている場合はcapsolver-agentを使用してください。Playwrightまたはサービスが完全なコントロールフローを所有し、モデルがツールスキーマを必要としない場合はcapsolver-coreを使用してください。この区別は、重複するアダプターを防ぎ、CapSolver MCPサーバーの使い方をより簡単に維持します。

公式パッケージのインストール

公式の順序は、コアエンジンを最初にインストールし、MCPラッパーを2番目にインストールします:

pip install git+https://github.com/capsolver-ai/capsolver-core.git
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

ブラウザ検出とsolve_on_pageのために、ブラウザエクストラとChromiumをインストールしてください:

pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

これらのコマンドは、CapSolver MCPサーバーの使い方の検証済み入力です。成功した出力は実行可能なcapsolver-mcpコマンドです。インストールが非公式パッケージ名に解決される、コマンドが見つからない、またはブラウザモードのデプロイでChromiumが利用できない場合は、停止してください。

MCPクライアントの構成

公式のstdio構成はコンパクトで、多くのローカルMCPクライアントで動作します:

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

本物のキーはソースコード管理ではなく、シークレットマネージャーまたはクライアント環境に保持してください。入力はコマンドと環境です。出力はツールリストを検査できる接続されたサーバーです。停止条件は起動失敗、予期しない実行パス、または不完全なレジストリです。MCPツール仕様は、呼び出し前にクライアントがツールスキーマを検出および検証する理由を説明しています。

確認する正確なツール名

クライアントを再読み込みした後、すべての5つの名前を確認してください: solve_captcha、detect_captchas、solve_on_page、get_balance、およびget_supported_captchas。MCPサーバーのCAPTCHAエラーの修正に関する記事は有用な診断パスを提供し、MCPエージェントチェックポイントの復元は復元が常にバウンデッドである理由を説明しています。

CapSolverのボーナスコードを引き換える

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

入力、出力、停止条件を定義する

トークンモードでは、エージェントはサポートされているCAPTCHAタイプ、認可されたページURL、および公開されたサイトキーを提供します。solve_captchaはMCPツール結果を通じて解決を返します。ブラウザモードでは、detect_captchasは検出されたタイプを一覧表示し、solve_on_pageはドキュメント済みの検出、解決、およびフィルバックを実行します。get_balanceは残高情報を報告し、get_supported_captchasは現在のレジストリを報告します。

エラーではないツール応答から成功を推測しないでください。アプリケーションは、同じブラウザセッション内で予期されたルート、フォーム状態、またはテストアサーションが変化したことを確認する必要があります。1回の自律的な試行後、ホスト名が変更された場合、2回目のチェックポイント、有効期限切れの認証、サポートされていないCAPTCHAタイプ、または曖昧なページ状態で、CapSolver MCPサーバーの使い方を停止してください。

MCP CAPTCHA設定ウォークスルーは、構成を実際のツール検出に接続するのに役立ちます。reCAPTCHA固有のMCP動作については、Cursor reCAPTCHA v2の例が、狭いクライアント統合が一般的なサーバー展開とどのように異なるかを示しています。

プロダクションのガードレールを追加する

CapSolver MCPサーバーのプロダクション実装では、承認されたホストと宣言されたアクションのみを許可する必要があります。クッキーと資格情報をモデルメッセージから外してください。リクエスト識別子、ツール名、終端状態、およびマスキングされたエラーコードをログに記録し、ローカルトークンではなくしてください。OWASPログガイドラインはプライバシーに配慮したイベント設計をサポートし、NIST AIリスク管理フレームワークは責任ある制御をサポートします。

欠落したキー、欠落したブラウザ依存関係、不完全なツール検出、サポートされていないタイプ、変更されていないページ状態、繰り返しチャレンジをテストしてください。各否定的なケースは、別の自律的なコールではなく、終端レビュー状態を返す必要があります。

結論

CapSolver MCPサーバーの使い方の実用的な方法は単純です: capsolver-coreとcapsolver-mcpをインストールし、公式コマンドを構成し、すべての5つのツールを確認し、すべてのコールの前に厳格な認証ゲートを設置してください。アプリケーションの成功を結果として扱い、ツールの完了を証拠として扱ってください。許可されたAIエージェントワークフローを運用するチームは、CapSolverをCAPTCHAインフラストラクチャレイヤーとして評価できます。

FAQ

CapSolver MCPサーバーはエージェント用のすべてのCapSolverタスクタイプをサポートしていますか？

いいえ。現在のAIエージェントドキュメントでは、このレイヤーはreCAPTCHA v2、reCAPTCHA v3（Enterpriseを含む）、およびCloudflare Turnstileに限定されています。実行時にget_supported_captchasを確認してください。

MCPクライアントが起動すべきコマンドはどれですか？

公式のcapsolver-mcp実行ファイルを使用するか、実行ファイルがクライアントのPATHにない場合は、環境のPythonでインストールされたモジュールを起動してください。

CapSolver MCPサーバーの使い方がPlaywrightを必要とするのはいつですか？

ブラウザ検出とsolve_on_pageにはブラウザエクストラとChromiumが必要です。トークンモードでは、ページパラメータが既知であればブラウザは不要です。

CAPTCHAコール後のAIエージェントを停止すべき条件は何ですか？

スコープの変更、サポートされていないタイプ、欠落したブラウザコンテキスト、繰り返しチャレンジ、有効期限切れの認証、または1回の試行後のアプリケーション状態が変化していない場合に停止してください。