Claude Desktop に solvethree MCP を追加する

Claude Desktopを実行するマシンにNode.js 22をインストールしてください。ワークスペースのAPIキーと、HTTPまたはHTTPSのプロキシURLを用意します。MCPサーバーはSOLVETHREE_PROXYで指定された1つのプロキシを使用します。reCAPTCHAツールはプロキシ引数を受け付けません。

reCAPTCHAでは、まずサイトプロファイルでアクティブなプロファイルを作成してください。必要なターゲットのホスト名、キャプチャアクション、reCAPTCHAタイプを設定します。Claudeにホスト名とアクションを渡しても、そのプロファイルは作成されません。まだアクティブでない場合は、サイトプロファイルの設定を参照してください。

1. 1.

   ローカルの設定ファイルを開く

   macOSでは~/Library/Application Support/Claude/claude_desktop_config.jsonを使用します。Windowsでは%APPDATA%/Claude/claude_desktop_config.jsonを使用します。

2. 2.

   solvethreeサーバーを追加する

   以下の設定を使用してください。ファイルにすでにmcpServersがある場合は、他のサーバーを置き換えず、その中にsolvethreeエントリを追加してください。両方の環境変数のプレースホルダーは、外部に公開せずに置き換えてください。

3. 3.

   Claude Desktopを再起動する

   保存後に再起動し、ホストが新しい設定でサーバーを起動するようにしてください。

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
      }
    }
  }
}

argsは公式SDKアーカイブをダウンロードし、そのsolvethree-mcp実行ファイルをローカルのstdioサーバーとして起動します。入力するホスト型MCPエンドポイントはありません。

まずsolvethree_capabilitiesを使用してください。既存のタスクを取得するにはsolvethree_get_taskを使用します。どちらの操作も、新しい解決を作成するリクエストではありません。

• solvethree_create_recaptchaは、ホスト名としてのsite、action、requestIdを受け取り、任意でrecaptchaTypeとwaitMsも指定できます。デフォルトのタイプはenterprise-v3で、v3も使用できます。
• solvethree_create_kasadaはKasadaタスクを作成します。スタンドアロンのKasadaが現在サポートするのはwww.ticketmaster.com上のHTTPSターゲットで、任意のウェブサイトには対応していません。
• solvethree_create_tmptはTMPTタスクを作成します。EventタスクにはイベントURLを、LoginタスクにはサインインのエントリーURLを使用します。

合意したターゲットとアクションに対して1つのタスクを作成する権限を、Claudeに明示的に与えてください。失敗やターゲットによる拒否後の代替タスクも含め、別の有料タスクを開始する前には、新たな承認を必須にしてください。タスクの確認やポーリングの許可を、別のタスクを作成する許可として扱わないでください。

すべての作成ツールはrequestIdを必須とし、作成するタスクは最大1つです。そのIDを元の入力とともに保持してください。作成がタイムアウトした場合は、同じIDで同じリクエストを繰り返してタスクを復旧するか、タスクIDがすでにある場合はそのタスクを取得してください。タイムアウトは、作成が失敗した証拠にはなりません。同じIDを再利用しながら入力を変更すると競合します。新しいIDを使用すると、別のタスクが作成される可能性があります。

pending または solving の場合は、既存のタスクの取得を続けてください。使用可能なソリューションが含まれるのは ready の場合のみです。failed の場合はポーリングを停止し、errorCode と error を確認してください。失敗した解決処理の料金は返金されます。同じ無効な入力を自動的に再送信しないでください。

Claude は MCP ホストを通じて非公開のソリューションデータを受け取ります。アプリケーションでは、成功時のプロキシと返された userAgent および secChUa を使い、本来の送信先に対して結果を使用してください。設定されたプロキシで解決した後に、別の IP や無関係なブラウザー識別情報で送信しないでください。

タスクが ready であることは、ソリューションが生成されたことを意味し、その後のリクエストがウェブサイトに受け入れられたことを意味するものではありません。送信先に拒否された場合は、次の解決処理を許可する前に、送信するトークン、Cookie またはヘッダー、プロキシ、ブラウザー識別情報、送信先 URL を確認してください。