CapSolver MCP を rtrvr ブラウザエージェントに接続する方法

TL;DR

• rtrvrはMCPを通じて外部のCAPTCHAツールを呼び出すことができます。 そのツールシステムはストリーミングHTTPまたはSSEサーバーを受け入れ、修飾された名前でインポートされたツールを公開します。
• セッションにバインドされたブラウザ作業にはトークンモードツールを使用してください。 2番目のブラウザを開かずにトークンを返し、rtrvrは元のタブとアプリケーション固有の送信ステップを担当します。
• 2つのsolve_captchaという名前のツールを混同しないでください。 rtrvrはその名前の組み込みブラウザアクションをドキュメント化していますが、外部のMCPサーバーはcapsolver.solve_captchaなどの修飾されたツールとして別個にインポートします。
• 返されたトークンはブラウザタスクの成功を証明するものではありません。 同じタブ、意図されたアプリケーションの応答、リトライ制限、および最終的なワークフローステートを確認してください。

イントロダクション：rtrvrにタイプ付きチャレンジツールを接続する

rtrvrはChrome拡張機能、クラウドブラウザ、API、MCP、CLI、SDKを統合して、エージェント駆動のブラウザ作業を提供します。そのツールコールレイヤーは、外部のMCPサーバーに接続し、チャットや再利用可能なJavaScriptサブルーチンからツールを呼び出すこともできます。CapSolverは、所有または自動化の許可を得たウェブサイトやテスト環境のチャレンジ処理サービスとして、このアーキテクチャに適合します。

このガイドでは、2つのドキュメント化されたインターフェースが実際にサポートする狭い統合を示します。rtrvrはアクティブなブラウザタブを制御します。CapSolver MCPはタイプ付きトークンモードツールを提供します。小さなrtrvrサブルーチンはリクエストを検証し、修飾されたMCPツールを呼び出し、ワークフローに構造化された結果を返します。最終的なページの更新はアプリケーション固有のステップであり、CAPTCHAトークンはチャレンジコンテキストにバインドされており、一般的なクリック結果ではありません。

このガイドは、製品間の公式なネイティブパートナーシップを前提としていません。また、CapSolver MCPがrtrvrの内部ブラウザオブジェクトに接続できるとは主張していません。代わりに、rtrvrの公開された外部ツール契約とCapSolverの公開されたMCPツールスキーマを使用します。

rtrvrとCapSolverの統合がサポートする内容

rtrvrのツールコールドキュメントでは、ユーザーがURLでMCPサーバーを接続し、インポートされたツールを有効化し、@toolnameで直接呼び出し、カスタムツール内でrtrvr.callTool(name, params)で組み合わせることができると述べています。インポートされたMCPツールはサーバー接頭辞で保存され、2つのシステムが同じツール名を公開する場合に重要です。

CapSolverのMCPServiceドキュメントは5つのツールを公開しています：

ログイン中のrtrvrタブでは、solve_captchaが実用的な開始点です。ブラウザベースのCapSolver MCPツールは独自のPlaywrightセッションを開始します。rtrvrの現在のタブ、クッキー、ローカルストレージ、ページ内の状態を受け取らないため、solve_on_pageは独立した、承認されたページチェックに役立ちますが、既存のrtrvrセッションの透明な継続ではありません。

また、意図的に名前衝突を処理する必要があります。rtrvrはsolve_captchaをその組み込みpageActionツールの1つとしてドキュメント化しています。CapSolver MCPは同じ短い名前のツールを公開します。外部サーバーを接続した後、ツールリストを確認し、通常capsolver.solve_captchaなどの完全なインポートされた名前を呼び出してください。プランナーが意図したものを推測しないでください。

アーキテクチャと責任の境界

この統合を4つのレイヤーで保持してください：

この分離により、3つの一般的なミスを防ぎます。第一に、モデルはタスクフィールドを発明しません。第二に、トークン応答は完了したビジネスアクションとして記録されません。第三に、アクセス拒否、ログインウォール、MFAプロンプト、またはサポートされていないチャレンジは、解決者に繰り返し送信されません。

このパターンは、所有またはテスト/自動化の許可を得たシステムでのみ使用してください。支払い、アイデンティティ検証、アカウント作成、プライベートデータアクセスなどの他の機密ワークフローは、明示的な人間の承認と適用可能なサービスルールの後で保持してください。

ステップ1: Streamable HTTPでCapSolver MCPを起動する

rtrvrはURLで外部MCPサーバーに接続しますが、CapSolver MCPはデフォルトでローカルstdioを使用します。rtrvr拡張機能がアクセスできるように、同じサーバーをStreamable HTTPで起動してください。

python -m venv .venv
source .venv/bin/activate
pip install capsolver-core
pip install capsolver-mcp

export CAPSOLVER_API_KEY="YOUR_CAPSOLVER_API_KEY"
capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000

公式のMCP Python SDKは/mcpをデフォルトのStreamable HTTPパスとして使用するため、ローカルエンドポイントは次の通りです：

http://127.0.0.1:8000/mcp

127.0.0.1にバインドすることで、サービスをローカルに保ちます。--api-keyオプションまたはCAPSOLVER_API_KEY環境変数は、サーバーをCapSolverに認証しますが、MCPポートにアクセスできる誰かのクライアント認証レイヤーではありません。このコマンドを公開インターフェースに直接バインドしないでください。リモートrtrvr環境がアクセスする必要がある場合、認証されたHTTPSの後ろにデプロイし、許可されたネットワークを制限し、APIキーをシークレットストアに保護し、MCPサーバーのオリジンとトランスポート設定を確認してください。

トークンモードツールはPlaywrightを必要としません。detect_captchasまたはsolve_on_pageの別個の承認された使用がある場合にのみ、ブラウザエクストラをインストールしてください：

pip install "capsolver-mcp[browser]"
playwright install chromium

ステップ2: rtrvrでMCPサーバーを接続し、検証する

rtrvrのツールセクションを開き、ローカルMCP URLを追加し、ワークフローで必要なツールのみを有効にしてください。rtrvrはStreamable HTTP、SSE、OAuth保護されたMCPサーバーのサポートをドキュメント化しています。このローカル設定では、前のステップのStreamable HTTP URLを使用してください。

最初に2つのブラウザなしの呼び出しを試してください：

@capsolver.get_supported_captchas
@capsolver.get_balance

正確な接頭辞はサーバーが接続されたときにrtrvrによって割り当てられます。もし異なれば、ツールパネルに表示されている名前を使用してください。カスタムサブルーチンはawait rtrvr.listTools()を呼び出し、利用可能なすべてのツールの名前、説明、パラメータスキーマ、ソースを検査することもできます。

これらのチェックは異なる質問に答えます。get_supported_captchasはrtrvrが外部ツールを発見したことを証明し、get_balanceはMCPプロセスが動作するアカウント資格情報を受信したことを証明します。どちらのチェックも実際のチャレンジが完了することを証明するものではありませんが、どちらもワークフローのデバッグに時間を費やす前に構成エラーとタスクエラーを分離します。

rtrvrのプロンプト、ページ記録、スクリーンショット、リポジトリに実際のAPIキーを置かないでください。MCPプロセスの環境に保持してください。プロセスがツール引数をログに記録する場合、トークン、キー、機密クエリパラメータを含むURL、およびターゲット固有の識別子をログに記録する前にマスキングしてください。

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

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

ステップ3: 確定的なrtrvrサブルーチンを追加する

rtrvrカスタムJavaScriptツールはrtrvr.callToolを通じて接続されたMCPツールを呼び出すことができます。以下のサブルーチンは、トークンを返す前に4つのことを行います：URLの検証、サポートされるチャレンジタイプのホワイトリスト、修飾された外部ツールの発見、および失敗状態の正規化。

const allowedTypes = new Set(["reCaptchaV2", "reCaptchaV3", "cloudflare"]);

function fail(state, message, details = {}) {
  return { ok: false, state, message, ...details };
}

if (!allowedTypes.has(captchaType)) {
  return fail("unsupported_challenge", `Unsupported type: ${captchaType}`);
}

const parsed = new URL(websiteUrl);
if (parsed.protocol !== "https:") {
  return fail("policy_block", "Only approved HTTPS targets are allowed");
}

const tools = await rtrvr.listTools();
const solver = tools.find((tool) =>
  tool.source === "mcp" &&
  (tool.name === "capsolver.solve_captcha" || tool.name.endsWith(".solve_captcha"))
);

if (!solver) {
  return fail("configuration_error", "CapSolver MCP solve_captcha was not found");
}

const result = await rtrvr.callTool(solver.name, {
  captcha_type: captchaType,
  website_url: websiteUrl,
  website_key: websiteKey,
  version: version || null,
  page_action: pageAction || null,
  min_score: minScore || null,
  invisible: invisible ?? null,
  enterprise: enterprise ?? null,
  cdata: cdata || null,
  timeout: 90,
  polling_interval: 5,
});

if (!result?.success || !result?.solution?.token) {
  return fail("solve_failed", result?.error || "No token returned", {
    errorCode: result?.error_code || null,
    httpStatus: result?.http_status || null,
  });
}

return {
  ok: true,
  state: "token_ready",
  captchaType: result.solution.captcha_type,
  token: result.solution.token,
  expiresAt: result.solution.expire_time || null,
};

captchaType、websiteUrl、websiteKey、およびオプションのフィールドをrtrvrのツールパラメータとして定義してください。この例は意図的に任意のページからサイトキーをスクレイピングしたり、未知のアプリケーションにトークンをインジェクトしたりしません。制御しているテストアプリケーションの場合、アプリケーション契約から正確なチャレンジパラメータを読み込み、サポートされたフォームまたはサーバーエンドポイントを通じて結果を送信する別のアダプターを追加してください。

含まれるローカルテストは、モックされたrtrvrツールランタイムでオーケストレーションの分岐ロジックをカバーしています。ライブハンドシェイクには、rtrvrアカウント、アクティブなブラウザデバイスまたはクラウドコンテキスト、CapSolver APIキー、および承認されたテストページが必要です。

ステップ4: トークンを元のブラウザ状態にバインドする

CAPTCHAソリューションはコンテキストに依存します。チャレンジタイプ、公開サイトキー、ページURL、アクション名、セッション状態、および場合によってはプロキシまたはユーザーエージェントデータが、ターゲットアプリケーションが結果を受け入れるかどうかに影響を与える可能性があります。したがって、ブラウザワークフローは元のタブを保持し、アプリケーションが期待する方法で返されたトークンを送信する必要があります。

ジェネリックなリトライループではなく、タイプ付きワークフローステートを使用してください：

1. page_ready: 意図されたページがロードされ、そのアイデンティティが確認されます。
2. challenge_detected: サポートされたチャレンジが存在し、信頼できるページエビデンスからパラメータが取得されます。
3. solve_requested: そのチャレンジインスタンスにバインドされた1つのMCPコールが作成されます。
4. token_ready: サービスがトークンを返しましたが、まだアプリケーションの成功は主張されていません。
5. submitted: アプリケーション固有のアダプターが同じ承認されたセッションでトークンを送信しました。
6. accepted: 意図されたルート、API応答、またはページ状態が成功を確認します。
7. reviewまたはstopped: 状態が曖昧、サポートされていない、機密性が高く、または予算を超えたものです。

このセッションバインドフローのショートカットとしてsolve_on_pageを呼び出さないでください。現在のCapSolver MCP実装では、そのツールは新しいヘッドレスChromiumページを開き、そこで検出と入力を実行し、その後ブラウザを閉じます。これは有効なスタンドアロン操作ですが、rtrvrの拡張機能またはクラウドブラウザとは別のセッションです。別個のセッションが許可され、明示的に承認されている場合にのみ使用してください。

ステップ5: アプリケーションの結果を検証する

成功したMCP応答は、ツールが解決オブジェクトを返したことを意味します。ログイン、フォーム送信、抽出ジョブ、またはブラウザタスクが完了したことを意味するものではありません。検証は、元のタブでrtrvrで行われなければなりません。

少なくとも3つのチェックを実施してください：

• タブの継続性: タブID、ホスト、および意図されたワークフローステップが、チャレンジを生成したリクエストと一致しているか。
• アプリケーションの受け入れ: 文書化されたルート、DOM状態、またはサーバー応答がアプリケーションが結果を受け入れたことを確認する。
• ビジネス結果: 意図された認証タスクが、ページ、アカウント、またはレコードのスイッチなしに完了したか。

ページが同じチャレンジを再度表示する場合、設定された試行予算後に停止してください。繰り返されるチャレンジループは、有効期限切れのトークン、パラメータの不一致、プロキシまたはユーザーエージェントの不一致、サポートされていないチャレンジの変種、またはより広範なアクセスポリシーの決定を示す可能性があります。より多くの呼び出しは進展を証明しません。

状態とエラーコードを記録し、シークレットを記録しないでください。役立つイベントには、相関ID、タイムスタンプ、ツール名、チャレンジタイプ、ターゲットホスト、試行回数、状態遷移、レイテンシー、および最終的なアプリケーション結果が含まれます。解決トークンやAPIキーを通常のログに保持しないでください。

rtrvr MCP統合のトラブルシューティング

プロダクションチェックリスト

テストページを越える前に、以下のすべてを確認してください。

• ターゲットおよびブラウザワークフローが承認されていること;
• CapSolverツールがその資格のあるMCP名で選択されていること;
• チャレンジパラメータが信頼できるランタイム証拠から取得されており、モデルの推測ではないこと;
• APIキーは環境またはシークレットストアに保持されていること;
• MCPエンドポイントがローカルまたは認証済みHTTPSおよびネットワーク制御で保護されていること;
• トークン処理がアプリケーション固有の提出とは分離されていること;
• 各チャレンジインスタンスおよびワークフローごとの再試行回数は制限されていること;
• ログにはAPIキー、解決トークン、機密URL、プライベートページデータが含まれていないこと;
• rtrvrが元のタブでの最終状態を検証していること;
• センシティブなアカウント、支払い、アイデンティティ、プライベートデータの操作は明示的なレビューを必要とする;
• 未サポートまたは曖昧な状態は安全に停止する。

このチェックリストは、別のプランナーのプロンプトを追加することよりも重要です。ほとんどの統合エラーは、ブラウザ状態、ツール入力、サービス出力、アプリケーションの受け入れの境界で発生します。これらは言語モデルの推論問題ではなく、ランタイム契約です。

結論

rtrvrはCapSolver MCPを呼び出すために必要な外部ツールの表面を提供しますが、信頼性のある統合は単にツールを有効にすることよりも狭い範囲です。Streamable HTTPを介してCapSolver MCPを開始し、rtrvrのエンドポイントに接続し、非ブラウザツールで発見を検証し、資格のある名前で外部ソルバーを呼び出してください。アクティブなrtrvrセッションでは、トークンモードを使用し、ページ提出と結果検証を元のブラウザワークフロー内に保つ必要があります。別ブラウザツールは別セッションとして扱い、タイプされた証拠を保持し、未サポートまたは曖昧な状態で停止してください。承認されたブラウザエージェントワークフローでは、CapSolverが文書化されたチャレンジツールを提供し、rtrvrはブラウザコンテキストと最終的なアプリケーションの成功を担当します。

承認されたrtrvrワークフローにCAPTCHA処理を追加する

CapSolver MCPドキュメンテーションに掲載されている5つの公開ツールを確認し、rtrvrのツールパネルからローカルまたは適切に保護されたエンドポイントに接続してください。CapSolverダッシュボードを使用して、統合を拡大する前に1つの承認されたワークフローをテストしてください。

FAQ

Q: rtrvrにはネイティブなCapSolver統合がありますか？

レビューされたドキュメンテーションは、ネイティブな提携や組み込みのCapSolverプロバイダーを主張していません。このガイドでの統合は、rtrvrの一般的なMCPツール接続とCapSolverの公開MCPサーバーを使用しています。

Q: なぜ短い名前solve_captchaではなく呼び出さないのですか？

rtrvrはその名前の組み込みブラウザアクションをドキュメント化しており、CapSolver MCPは同じ短い名前を公開しています。曖昧さを避けるために、ツールパネルに表示されている資格のあるインポート名、例えばcapsolver.solve_captchaを使用してください。

Q: rtrvrで開いているブラウザタブをCapSolver MCPで使用できますか？

文書化されたMCPツールを通じてはできません。トークンモードは明示的なチャレンジパラメータを必要とし、トークンを返しますが、ブラウザモードツールは別途のPlaywrightブラウザを起動します。

Q: ローカルMCPポートをインターネットに公開すべきですか？

いいえ。ローカルホストで使用してください。共有デプロイメントには認証済みHTTPS、ネットワーク制限、シークレット管理、オリジン制御、および明示的なセキュリティレビューが必要です。

Q: ブラウザタスクが成功したかどうかどうやって確認できますか？

期待されるルート、DOM状態、API応答、ビジネス結果を使用して、元のrtrvrタブで結果を確認してください。単なるトークンの返却は成功の証拠ではありません。