将 solvethree MCP 添加到 Cursor

1. 1.

   设置环境变量

   将 SOLVETHREE_API_KEY 设为工作区 API 密钥，将 SOLVETHREE_PROXY 设为求解和提交时使用的代理。确保启动 Cursor 的进程可以访问这两个变量。不要将凭据明文写入项目配置。

2. 2.

   选择配置文件

   使用 .cursor/mcp.json 进行项目级配置，或使用 ~/.cursor/mcp.json 进行用户级配置。名为 solvethree 的项目配置项会覆盖同名的全局配置项。

3. 3.

   添加服务器配置项

   使用以下配置。如果文件中已有其他服务器，请将 solvethree 添加到现有的 mcpServers 对象中，而不是替换整个文件。

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

这会使用 npx 从官方 SDK 下载内容中启动 solvethree-mcp。该配置继承 Cursor 的环境，不依赖 JSON 中的环境变量插值。

完全退出 Cursor，然后从包含这两个变量的环境中重新启动。在终端中导出变量不会更新已经运行的 GUI。

检查 Cursor 的 MCP 工具和 MCP 日志输出。服务器提供 solvethree_capabilities、solvethree_create_recaptcha、solvethree_create_kasada、solvethree_create_tmpt 和 solvethree_get_task。先调用 solvethree_capabilities，查看可用操作。

服务器无法启动。

查看 MCP 日志中的启动错误。

试试这样做： 如果 Cursor 找不到 npx，请确保 Cursor 的 PATH 中包含它，然后重启 Cursor。

服务器提示缺少环境变量。

检查实际启动 Cursor 的环境，而不只是当前终端。

试试这样做： 在该环境中设置这两个变量，完全退出 Cursor，然后重新启动。

Cursor 使用了非预期的配置。

检查两个配置文件中是否都有 solvethree 配置项。

试试这样做： 如果你原本想使用全局配置项，请更新或删除项目配置项。

有关 Cursor 的配置界面，请参阅其官方 MCP 文档。

1. 1.

   确认站点配置已激活

   在站点配置中配置预期的主机名、采集操作和 reCAPTCHA 类型。请求求解前，请确认该配置已激活。向工具传递主机名和操作不会创建配置。有关采集流程，请参阅站点配置设置。

2. 2.

   调用 reCAPTCHA 工具

   让 Cursor 调用 solvethree_create_recaptcha，并提供 site、action 和唯一的 requestId。site 是主机名，而不是页面 URL。recaptchaType 默认为 enterprise-v3；waitMs 为可选参数。工具从 SOLVETHREE_PROXY 读取其唯一使用的代理，因此不要添加代理参数、type 或 url。

3. 3.

   跟踪任务直至终态

   如果任务处于 pending 或 solving 状态，请使用 solvethree_get_task 再次检查。只有 ready 状态才包含可用的解答。如果状态为 failed，请停止轮询，并检查 errorCode 和 error，然后再决定需要修改什么。

如果创建超时，请保留 requestId。每次创建调用最多生成一个任务，使用相同请求 ID 和相同输入重复调用可找回现有任务。复用该 ID 时更改输入会产生冲突。不要仅因首次响应丢失就生成新 ID。

任务就绪后，MCP 服务器的工作即告结束。应用程序必须将返回的 reCAPTCHA 令牌提交给预期目标。使用返回的 userAgent 和 secChUa 身份信息，并使用求解时配置的同一代理。切换代理或混用不相关的浏览器身份可能导致请求失败。

使用其他工具时，请分清解答类型：Kasada 返回需一同应用的请求头对象，而 TMPT 返回原始 tmpt Cookie 值。两者都不是 reCAPTCHA 令牌。

Cursor 通过工具响应接收私密解答数据。ready 结果表示已生成解答，并不表示目标已接受应用程序的请求。如果提交失败，请先检查发出的令牌或 Cookie、身份信息和代理，再付费进行另一次求解。