MCP CAPTCHA ソルバーをカーソルに追加する方法

TL;DR

• サーバーが狭くスコープされた、文書化されたツールを公開している場合、カーソルはMCPサーバーを通じてCAPTCHAソルバーを使用できます。
• CapSolverの資格情報をMCPサーバーの環境に保持し、カーソルチャット、プロジェクトファイル、または生成されたコードに保持しないでください。
• テストを行う前にツールレジストリを検証し、認可されたreCAPTCHAまたはCloudflare Turnstileワークフローのみを許可してください。
• サイトパラメータが欠如している、繰り返されるトークン拒否、または機密ブラウザアクションが発生した場合、エージェントに停止を要求してください。
• 返されたトークンを中間値として扱い、アプリケーションの応答を確認してから続行してください。

Cursor MCP統合が可能にする機能

Cursor MCP CAPTCHAソルバーにより、コードエージェントは認可されたブラウザオートメーションまたはQAタスク中に構造化されたCAPTCHAツールを呼び出すことができます。Cursorは計画とコード変更を処理し、MCPサーバーはCapSolverを通じて制御されたインターフェースを提供します。

このパターンは、テストランナーまたはブラウザエージェントがreCAPTCHAまたはCloudflare Turnstileに遭遇し、必要なページパラメータを持っている場合に役立ちます。任意のサイトを自動化する権限ではありません。ツールを公開する前に許可されたドメイン、アクション、および再試行制限を定義してください。

前提条件

CursorにMCPサポートが必要です。CapSolverアカウント、MCPサーバーの構成、および認可されたブラウザワークフローが必要です。名前や引数を構成する前に、公式CapSolver MCPサービスドキュメントとエージェントツールリファレンスを確認してください。

MCPサーバーを起動する際に使用する環境にCAPSOLVER_API_KEYを保存してください。.cursorルール、プロンプト、例のコード、リポジトリファイルに貼り付けないでください。

スコープ付きMCPサーバーの構成

Cursor MCP構成の構文はリリースによって異なりますが、セキュリティ境界は同じである必要があります。次の例のJSONは意図された分離を示しています：

{
  "mcpServers": {
    "capsolver": {
      "command": "YOUR_MCP_LAUNCH_COMMAND",
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      }
    }
  }
}

現在のCapSolverドキュメントから正確な起動コマンドを使用してください。Cursorを再起動した後、利用可能なMCPツールを確認し、期待されるサーバーが接続されていることを確認してください。ツールが見つからない場合は、構成エラーであり、エージェントがフォールバックAPIを発明する理由ではありません。

明確なツールポリシーをカーソルに提供する

プロジェクトの指示はツールが許可されるタイミングを定義する必要があります：

CapSolver MCPツールは、認可されたQAおよびブラウザオートメーションでのみ使用してください。
サポートされる範囲：reCAPTCHA v2/v3およびCloudflare Turnstile。
呼び出す前に、ページURL、サイトキー、チャレンジタイプ、およびオプションのアクションを確認してください。
最大試行回数：2回。
APIキー、クッキー、トークン、またはプライベートページの内容を公開しないでください。
ログイン送信、支払い、アカウント変更、または不明な認証の前に停止してください。

このポリシーにより、カーソルに決定的な停止条件が提供されます。また、ツール呼び出しを明確な契約に基づいて評価できるため、コードレビューが容易になります。

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

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

MCPハンドシェイクをテストする

ライブチャレンジではなく、発見から始めましょう。カーソルにCapSolverツールの一覧を表示させ、それらを呼び出さずに各入力スキーマを要約してください。ツール名とパラメータが公式ドキュメントと一致していることを確認してください。

次に、認可されたテストページを使用し、カーソルに以下を指示してください：

1. チャレンジタイプを特定する；
2. 現在のページからページURLとサイトキーを収集する；
3. MCPを通じて1つの解決を要求する；
4. 返されたトークンを同じブラウザコンテキストに適用する；
5. ページの結果を確認する；および
6. 確認に失敗した場合、診断情報をもって停止する。

このシーケンスはツールの可用性、解決の作成、ブラウザへの適用、結果の検証を分離します。成功したMCP応答は、サイトがトークンを承認していることを保証するものではありません。

カーソルMCPの一般的な問題のトラブルシューティング

サーバーは表示されるがツールが一覧に表示されない

MCP構成を変更した後、カーソルを再起動し、サーバーログを確認し、構成されたコマンドと環境を検証してください。秘密情報をトラブルシューティングプロンプトに直接配置しないでください。

ツールはトークンを返すがページは拒否する

ページURL、サイトキー、チャレンジタイプ、オプションのアクションまたはメタデータ、トークンの年齢、ブラウザコンテキストを確認してください。繰り返される拒否はワークフローを停止させるべきであり、無制限のループをトリガーしてはなりません。

カーソルがツールを早すぎるタイミングで呼び出す

確認されたチャレンジパラメータと可視チェックポイントを呼び出し前に要求する指示を追加してください。トークンは有効期限があるため、アプリケーションが準備ができる前に解決すると、回避可能な失敗を引き起こす可能性があります。

エージェントが機密フォームを送信したい

人間の承認を要求してください。MCPツールアクセスはログイン、支払い、アップロード、アカウント、または他の重要なアクションに対するオペレーターのコントロールを削除してはなりません。

結論

カーソルは、発見、資格情報、権限、ブラウザ検証を別々に保つことで、CAPTCHA MCPツールと上手く動作します。公式ドキュメントからサーバーを構成し、エージェントに狭いポリシーを提供し、曖昧または繰り返される失敗で停止してください。CapSolverはCAPTCHA機能を提供し、カーソルはオーケストレーターの役割を果たします。

FAQ

Q: CursorはネイティブにCAPTCHAを解決できますか？

いいえ。CursorはMCPを通じて外部の機能を呼び出せますが、CAPTCHAの作業は構成されたサービスが提供します。

Q: CapSolver APIキーをどこに保存すべきですか？

MCPサーバーの保護された環境またはシークレットマネージャーに保存してください。カーソルチャットやリポジトリファイルには保存しないでください。

Q: CursorはMCPをreCAPTCHAおよびTurnstileに使用できますか？

はい。現在のCapSolver MCPツールがチャレンジをサポートし、ワークフローが文書化されたパラメータを提供している場合に限ります。

Q: 拒否されたトークンを自動的に再試行すべきですか？

小さな固定限界内でのみ再試行してください。繰り返される拒否は通常、パラメータの再確認または人間の介入を必要とします。