MCP reCAPTCHA ソルバー for AI エージェント: セットアップと統合

TL;DR

• mcp reCAPTCHAソルバーは、reCAPTCHAのタイプ、ページURL、および公開サイトキーがわかっている場合にsolve_captchaを使用します。ブラウザモードではdetect_captchasまたはsolve_on_pageを使用できます。
• MCPサービスは、ドキュメントに記載された5つのCapSolverツールのみを公開する必要があります。エージェントレイヤーはreCAPTCHA v2、reCAPTCHA v3（エンタープライズを含む）、およびTurnstileをカバーします。
• 保護されたアプリケーションは、返されたトークンを承認するかどうかを決定する必要があります。ツールの結果はビジネス上の成功信号ではありません。
• 変更されたアクション、古くなったページ、サイトキーの欠如、サポートされていないタイプ、または繰り返しのチャレンジは、自律的なフローを停止する必要があります。

イントロダクション

mcp reCAPTCHAソルバーは、許可されたAIエージェントタスクが既に遭遇したreCAPTCHAを知り、構造化された復元コールが必要な場合に最も役立ちます。CapSolverは、capsolver-mcpを通じて公式のsolve_captchaツールを公開し、detect_captchasとsolve_on_pageはブラウザ駆動型の復元をサポートします。統合は、ページURL、reCAPTCHAバージョン、サイトキー、ブラウザセッション、および認可されたアクションを1つのチェックポイントとして保持する必要があります。入力が変更された場合は推測せず、停止する必要があります。このチュートリアルでは、CapSolverのAIドキュメントから現在の名前のみを使用し、エージェントの能力をreCAPTCHA v2、reCAPTCHA v3（エンタープライズを含む）、およびCloudflare Turnstileに制限しています。許可されたシステムとデータに対して法的で合理的かつ責任ある作業にのみこのパターンを使用してください。

トークンモードとブラウザモードの選択

トークンモードは、mcp reCAPTCHAソルバーの単純な経路です。クライアントはsolve_captchaを呼び出して、ページURLとサイトキーを使用して既知のタイプを解決します。ブラウザモードでは、detect_captchasでページを検査するか、solve_on_pageでライブのPlaywrightコンテキストで検出、解決、およびフィルバックを実行できます。

CapSolver AIエージェントアーキテクチャはこの復元境界を説明しています。コアSDKモードはsolve、detect、get_captcha_info、およびsolve_on_pageを説明しています。reCAPTCHA v2クライアントモデルは公開されたサイトキーと応答ライフサイクルをドキュメント化し、reCAPTCHA v3アクションモデルはサイトオーナーがバックエンドでアクションとスコアを検証することを説明しています。

1つのチェックポイントレコードを使用してください

モデルトランスクリプトの外に、承認されたホスト名、URL、reCAPTCHAバージョン、サイトキー、期待されるアクション、ブラウザコンテキストID、および1回限りのカウンターを保存してください。mcp reCAPTCHAソルバーの出力は、会話メモリ内の再利用可能なトークンではなく、RESUME、REJECTED、またはREVIEWなどの赤示された終了状態である必要があります。

MCPサービスのインストールと登録

公式パッケージの順序を使用してください：

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

その後、環境変数CAPSOLVER_API_KEYでcapsolver-mcpを起動するようにMCPクライアントを構成してください。MCPサービスの構成はJSONブロックと正確なツールをドキュメント化しています。接続されたmcp reCAPTCHAソルバーはsolve_captcha、detect_captchas、solve_on_page、get_balance、およびget_supported_captchasを公開する必要があります。ツール名が欠如している場合や予期しないツールが表示されている場合は、停止してください。

エージェントツールリファレンスは、チームが関数コールループを所有している場合に、get_all_toolsとcreate_executorを通じて同じ機能がどのようにマッピングされるかを示しています。これにより、MCPとカスタムエージェントの統合が一貫性を持ち、メソッド名を発明することなく行えます。

検証された入力でreCAPTCHAツールを呼び出す

安全なツールのデモンストレーションは、ドキュメント化された自然言語形式です。MCPサーバーはクライアントに独自の入力スキーマを公開しています：

https://staging.example.org/loginでreCAPTCHA v2を解決するには、公開されたサイトキー6Lc...を使用してください。
エージェントに赤示された成功状態とリクエスト識別子のみを返してください。

入力はタイプ、認可されたページURL、および公開されたサイトキーです。ツールの出力には、インストールされたサーバーで定義された解決データが含まれます。信頼できるブラウザまたはアプリケーションコードは、それを即座に消費し、元のアクションを検証する必要があります。停止条件は、パラメータが欠如している、ホスト名が異なる、v3アクションの不一致、認証が期限切れ、または1回の試行に失敗した場合です。Cursor用のMCP reCAPTCHA例はクライアント固有のサブパターンを提供し、一般的なMCP CAPTCHAワークフローはサービスの検出をカバーしています。

CapSolverボーナスコードを取得してください

自動化予算を即座に増やしましょう！
CapSolverアカウントにチャージするときにボーナスコードCAP26を使用すると、毎回5%のボーナスが得られます — 限度はありません。
CapSolverダッシュボードで今すぐ利用してください

同じセッション内で保護されたアクションを検証する

mcp reCAPTCHAソルバーが成功するためには、元の許可されたタスクが期待される状態に到達している必要があります。reCAPTCHA v2の場合、これはステージングフォームの確認になるかもしれません。reCAPTCHA v3の場合、これはサイトオーナーのポリシーに従って保護されたアクションが受け入れられたものです。結果をホスト、セッション、アクション、またはアカウント間で移動しないでください。

reCAPTCHAトークン無効のトラブルシューティングフローは、悪いパラメータや古くなったコンテキストを隔離するのに役立ちます。サービスが接続されてもツールが失敗する場合は、MCPサーバーのエラーチェックリストを使用してください。その後、アプリケーションロジックを変更する前に。

レビューに必要な証拠のみを記録してください

承認されたホスト名、チャレンジバージョン、選択されたツール、開始および終了時間、終了状態、およびリクエスト識別子を記録してください。資格情報、クッキー、または生の解決値を記録しないでください。W3C Trace Context標準は有用な相関モデルを提供し、OWASPロギング原則は機密データを最小限に抑えるのに役立ちます。

本番環境前に失敗状態をテストする

無効なサイトキー、誤ったreCAPTCHAバージョン、変更されたアクション、期限切れのページ、ブラウザの依存関係の欠如、繰り返しのチャレンジ、および拒否されたアプリケーションの応答をテストしてください。すべての失敗は、1回の試行後にREVIEWでmcp reCAPTCHAソルバーのフローを終了する必要があります。ポジティブなテストでは、同じブラウザコンテキストが元のアクションを完了し、エージェントが終了状態のみを受け取ることを証明する必要があります。

結論

信頼できるmcp reCAPTCHAソルバーは、公式のMCPツールを発見し、検証されたreCAPTCHA入力を1つの認可されたチェックポイントにバインドし、適切なツールを一度呼び出し、同じセッション内で保護されたアクションを検証するという狭いシーケンスです。モデルが範囲を拡大したり、不確実性を許可として解釈したりしないようにしてください。許可されたエージェントワークフローを実装するチームは、CapSolverをreCAPTCHA復元インフラストラクチャとして使用できます。

FAQ

mcp reCAPTCHAソルバーはreCAPTCHA v3を処理できますか？

はい。現在のCapSolver AIドキュメントはreCAPTCHA v2とv3（エンタープライズを含む）をカバーしています。保護されたアプリケーションは依然としてアクションと承認ポリシーを所有しています。

エージェントはsolve_captchaまたはsolve_on_pageを呼び出すべきですか？

タイプ、URL、およびサイトキーがわかっている場合はsolve_captchaを使用してください。検出とフィルバックがライブページコンテキストで必要になる場合はブラウザツールを使用してください。

MCPツールの結果を別のページで再利用できますか？

いいえ。認可されたURL、ブラウザセッション、および保護されたアクションにバインドし、すぐに使用してください。

MCP reCAPTCHAソルバーはいくつの自動試行を行いますか？

1回の制限付き試行を使用してください。繰り返しのチャレンジ、変更された入力、または拒否されたアプリケーション状態の場合はレビューに移動してください。