将 solvethree MCP 添加到 Claude Desktop

在运行 Claude Desktop 的计算机上安装 Node.js 22。准备好工作区 API 密钥和 HTTP 或 HTTPS 代理 URL。MCP 服务器使用通过 SOLVETHREE_PROXY 提供的单个代理；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 任务。活动任务使用活动 URL；登录任务使用登录入口 URL。

明确授权 Claude 为约定的目标和操作创建一个任务。在它开始另一个付费任务之前，必须重新获得批准，包括在失败或被目标网站拒绝后创建替代任务。查看或轮询任务的权限不应被视为创建另一个任务的权限。

每个创建工具都要求提供 requestId，且最多创建一个任务。请将该 ID 与原始输入一并保存。如果创建超时，请使用相同 ID 重复相同请求以恢复任务；如果已有任务 ID，也可以直接检索。超时并不能证明创建失败。沿用 ID 却更改输入会发生冲突；使用新 ID 则可能创建另一个任务。

对于 pending 或 solving，继续获取现有任务。只有 ready 状态才包含可用的解答。遇到 failed 时，停止轮询并检查 errorCode 和 error；解答失败会退款。不要自动再次提交相同的无效输入。

Claude 通过 MCP 宿主接收私密解答数据。让应用程序将结果用于预期目标，并使用求解成功时的代理以及返回的 userAgent 和 secChUa。不要通过配置的代理求解后，又使用不同的 IP 或不相关的浏览器身份提交。

任务处于 ready 状态表示已生成解答，并不表示网站已接受你随后发送的请求。如果目标拒绝请求，请先检查发出的令牌、Cookie 或请求头、代理、浏览器身份以及目标 URL，再批准另一次求解。