VS Code に solvethree MCP を追加する

以下の設定で .vscode/mcp.json を作成または更新してください。ファイルに他のサーバーや入力がすでに含まれている場合は、置き換えずにこれらのエントリを統合してください。VS Code がローカルで npx を実行できる必要があります。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

このコマンドは、公式 SDK のダウンロードから solvethree-mcp を実行します。2 つのパスワード入力プロンプトから、そのプロセスに SOLVETHREE_API_KEY と SOLVETHREE_PROXY を渡します。ワークスペースの API キーと HTTP(S) プロキシ URL は、チャットやコミットする設定ファイルではなく、これらのプロンプトに入力してください。プロキシ URL にパス、クエリ、フラグメントを含めることはできません。

設定の構造は、VS Code MCP 設定リファレンスに記載されています。これはローカルプロセスであり、ホスト型 MCP エンドポイントではありません。

VS Code がサーバーを起動したら、解決をリクエストする前に solvethree_capabilities を呼び出すようエージェントに依頼してください。サーバーは以下のツールを公開します。

• solvethree_capabilities — サービスの機能を確認します。
• solvethree_create_recaptcha — reCAPTCHA タスクを作成します。
• solvethree_create_kasada — 単独の Kasada タスクを作成します。現在の対応範囲は www.ticketmaster.com の HTTPS ターゲットに限られます。
• solvethree_create_tmpt — Event または Login 用の Ticketmaster TMPT タスクを作成します。
• solvethree_get_task — タスクの状態と結果を取得します。

これらのツールを使用できない場合は、まずローカルプロセスが起動し、両方の環境変数を受け取っていることを確認してください。対象サイトを変更したり、別のタスクを作成したりしても、サーバーの起動の問題は解決しません。

1. 1.

   サイトプロファイルを有効にする

   サイトプロファイルで、正しいホスト名、キャプチャアクション、reCAPTCHA の種類を指定して対象を設定してください。解決処理の前に、ワークスペースで有効なプロファイルを利用できる必要があります。ツールにホスト名とアクションを渡しても、プロファイルは作成されません。新しい対象の場合は、サイトプロファイルの設定を参照してください。

2. 2.

   タスクを 1 つ作成する

   site にホスト名、必要な action、今回の論理的な解決処理に一意の requestId を指定し、solvethree_create_recaptcha を使用するようエージェントに依頼してください。このツールは、省略可能な recaptchaType と waitMs も受け付けます。種類のデフォルトは enterprise-v3 です。単一のプロキシを SOLVETHREE_PROXY から読み取るため、このツール呼び出しにプロキシ候補リスト、type、url を追加しないでください。

3. 3.

   タスクが終了状態になるまで確認する

   各作成呼び出しが作成するタスクは最大 1 つです。状態が pending または solving の場合は、solvethree_get_task を使用して再取得してください。使用可能なソリューションが含まれるのは ready の場合のみです。failed の場合はポーリングを停止し、errorCode と error を確認してください。失敗した解決処理の料金は返金されます。無効な入力を変更せずに再試行しないでください。

作成がタイムアウトした場合は、requestId を保持してください。これは ASCII の英字、数字、アンダースコア、ハイフンで構成される 1–64 文字である必要があります。同じ ID で同じタスクリクエストを繰り返すと、既存のタスクが返されます。同じ ID を再利用しながら入力を変更すると競合します。新しい論理的な解決処理を依頼する前に、既存のタスクを取得してください。

reCAPTCHA では、タスク ID ではなく solution.token を本来の送信先に送信してください。返された userAgent と secChUa を、解決処理に使用したものと同じプロキシで使用してください。IP を切り替えたり、無関係なブラウザーヘッダーを混在させたりすると、送信が失敗する可能性があります。

他のツールは異なるデータを返します。Kasada は一緒に適用するヘッダーオブジェクトを返し、TMPT はそのまま使う tmpt Cookie の値を返します。各結果は、対応するブラウザー識別情報、プロキシ、送信先とセットで扱ってください。

MCP ホストは非公開のソリューションデータを受け取りますが、代わりに送信することはありません。タスクが ready であることは、ソリューションが生成されたことを意味し、アプリケーションのリクエストがウェブサイトに受け入れられたことを意味するものではありません。送信先に拒否された場合は、次の解決処理に料金を支払う前に、その送信リクエストを確認してください。