将 solvethree MCP 添加到 Codex

1. 1.

   确保 Node.js 22 和 npx 可用

   运行 Codex 的进程必须能够访问它们。如果将它们安装在 Codex 无法访问的独立环境中，Codex 仍然无法启动服务器。

2. 2.

   设置宿主环境变量

   将 SOLVETHREE_API_KEY 设为工作区 API 密钥，将 SOLVETHREE_PROXY 设为代理 URL。启动 Codex 时，确保这些变量可用。对于 IDE 集成，还要确保 IDE 进程继承这些变量。不要将 API 密钥放入提示词或版本控制中。

3. 3.

   激活 reCAPTCHA 站点配置

   在站点配置中添加 HTTPS 页面 URL，选择 reCAPTCHA 类型，并提供采集操作。等待配置激活。请配置所需的主机名、采集操作和类型；任务中的站点和操作不会创建配置。如果这是你的首个目标，请参阅站点配置设置。

Codex CLI 和 IDE 共用 ~/.codex/config.toml。你也可以使用受信任项目的 .codex/config.toml。添加以下服务器配置项：

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

该配置项通过 npx 运行官方 SDK 的 solvethree-mcp 可执行程序。env_vars 会转发已有的宿主变量，而不会为其赋值。这个本地服务器无需填写托管的 MCP 端点，也无需 OAuth 登录。

startup_timeout_sec 允许服务器用 60 秒启动。tool_timeout_sec 允许一次工具调用用时 100 秒。这两项设置都不表示目标网站已接受解答。

运行 codex mcp list，或在 Codex TUI 中打开 /mcp，检查已配置的服务器。如果服务器无法启动，请检查 Codex 是否能找到 npx，以及是否继承了这两个环境变量。

1. 1.

   查看功能

   让 Codex 在选择求解工具之前调用 solvethree_capabilities。对于 reCAPTCHA，使用 solvethree_create_recaptcha。

2. 2.

   提供 reCAPTCHA 输入参数

   将主机名作为 site，并提供 action 和 requestId。该工具还接受可选参数 recaptchaType 和 waitMs；默认类型为 enterprise-v3。它从 SOLVETHREE_PROXY 读取唯一的代理配置，因此不要将其视为可在每次调用时单独设置的代理。不要向 reCAPTCHA 请求添加 type 或 url 字段。

3. 3.

   保存任务 ID 并检查状态

   每次创建调用最多创建一个任务。使用返回的任务 ID 调用 solvethree_get_task 来获取该任务。当状态为 pending 或 solving 时，继续查询。只有 ready 状态才包含可用的解决方案。如果状态变为 failed，请停止轮询，并检查 errorCode 和 error，然后再决定如何调整。

MCP 服务器不会操控浏览器、检查浏览器的当前会话或填写表单。应用程序必须获取已就绪的 reCAPTCHA 结果，并将 solution.token 提交到预期目标。

使用返回的 userAgent 和 secChUa 浏览器身份信息，并使用求解时所用的同一代理。如果浏览器或 HTTP 客户端使用了不同的代理或不匹配的浏览器身份信息，请在提交前纠正。添加 MCP 服务器不会自动为你配置这些设置。

Codex 会通过工具响应接收私密的解决方案数据，因此请勿将其写入共享报告和日志。任务状态为 ready 表示已生成解决方案；请另行检查目标的响应，以确定其是否接受了应用程序请求。