Claude Code 验证码破解工具: CapSolver MCP 设置指南

简要说明

• 将Claude Code连接到官方的capsolver-mcp包，以暴露支持的验证码解决工具。
• 首先列出支持的验证码类型；成功连接工具并不意味着付费解决请求一定会成功。
• 当您已经拥有支持的挑战类型、页面URL和站点密钥时，使用solve_captcha。
• 页面工具会打开自己的浏览器会话；它们不会自动继续现有的Claude浏览器标签页。
• 返回的令牌或填写的控件仍需要目标应用程序的最终确认检查。

Claude Code可以帮助编写或调试浏览器任务，但当支持的验证码中断批准的操作时，它需要实际的解决工具。要求模型“尝试更努力”不会提供挑战所需的站点参数、API连接或结果处理。

CapSolver通过其MCP服务公开这些功能。本指南涵盖安装包、将其连接到Claude Code、检查可用工具和选择解决调用。示例涉及您自己的页面或允许的自动化任务。它们不会自动化账户创建、购买或对受限数据的访问。

Claude Code如何与CapSolver MCP配合使用？

配置并批准服务器后，Claude Code可以发现并调用CapSolver的MCP工具。

官方MCP服务公开了五个工具：

工具名称描述了不同的操作。余额查询不会识别页面，检测小部件也不会解决它。从您实际需要的操作开始。

本指南检查的已安装版本capsolver-mcp 0.1.3通过其支持类型工具列出了reCaptchaV2、reCaptchaV3和cloudflare。在此接口中，Cloudflare处理程序涉及Turnstile。不要将名称解释为对每个Cloudflare响应或全页挑战的通用支持。

REST API提供了其他任务类型，但这些不会自动添加到此MCP工具集中。特别是，不要因为CapSolver的独立API支持图像识别而将ImageToText任务传递给solve_captcha。

安装官方包

在Claude Code将启动的Python环境中安装CapSolver核心、MCP服务器和浏览器依赖项。

以下命令指定了此处使用的核心和MCP版本：

python -m pip install capsolver-core==0.1.1 "capsolver-mcp[browser]==0.1.3"
python -m playwright install chromium

安装遵循CapSolver的官方包说明。浏览器附加组件和Chromium是页面工具所需的。Playwright浏览器安装指南解释了浏览器二进制文件是与Python包分开的依赖项。

在下一步中使用此环境的Python可执行文件。如果您安装到虚拟环境中并配置了不同的Python，客户端可能会报告无法导入capsolver_mcp，尽管其他地方安装成功。

您还需要Claude Code和CapSolver账户密钥进行实际解决。将该密钥存储在启动Claude Code的环境中作为CAPSOLVER_API_KEY。不要将其粘贴到聊天提示中或提交到共享项目文件中。

包连接和本地检测路径可以与付费识别分开检查。本指南不演示实时付费解决；该步骤需要您的账户和批准目标的当前参数。

将CapSolver添加到项目MCP配置

在项目的.mcp.json中添加一个capsolver条目，指向您安装包的Python环境。

以下配置使用CapSolver的文档化Python模块启动模式和Claude Code的环境变量扩展。将Python路径替换为您的实际绝对路径：

{
  "mcpServers": {
    "capsolver": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "${CAPSOLVER_API_KEY}"
      }
    }
  }
}

如果.mcp.json中已包含其他服务器，请将此条目添加到现有的mcpServers对象中，而不是替换文件。参考将密钥值保留在JSON文件外部，但变量在Claude Code启动时仍需可用。

Claude Code的MCP配置文档涵盖了项目范围、环境扩展和服务器批准。从目标项目启动Claude Code，查看项目服务器批准提示，并在确认命令和包是您安装的之后批准此服务器。

从该项目目录检查配置：

claude mcp list

在交互式Claude Code会话中，使用/mcp检查服务器状态和可用控件。待批准状态意味着项目服务器仍需您的审查。这与缺失的可执行文件或失败的连接不同。

在请求解决前检查工具

在要求Claude Code花费账户积分之前，先让它列出支持的验证码类型。

一个合适的初始请求是：

使用CapSolver的get_supported_captchas工具，并告诉我此服务器当前支持哪些验证码类型。不要提交解决任务。

这确认了客户端可以访问真实工具，并提供了安装服务器的实际覆盖范围。MCP的连接生命周期将初始化与后续操作分开；建立连接只是可用集成的开始。

对于账户检查，您可以要求get_balance。如果响应包含账户信息，请保持私密。此处的失败指向账户访问或服务通信问题，应在尝试付费解决前解决。

不要仅凭模型声明它“了解CapSolver”来判断准备情况。检查实际工具结果。发现的工具、成功的账户查询和完成的验证码解决建立了不同的事实。

使用您的CapSolver优惠码

立即提升您的自动化预算！
在充值CapSolver账户时使用优惠码 CAP26，每次充值可获得 5% 的额外奖励——无限制。
立即在您的 CapSolver仪表板 中兑换

使用令牌模式处理已知挑战参数

当您批准的浏览器或应用程序流程已提供所需类型、页面URL和站点密钥时，使用solve_captcha。

例如，给Claude Code一个有限指令：

使用CapSolver的solve_captcha一次解决我批准的测试页面上的reCAPTCHA v2。使用我提供的精确页面URL和站点密钥。如果任一参数缺失，请报告缺失输入而不是猜测。在摘要中返回工具状态，不要打印完整令牌。

该工具的模式使用captcha_type、website_url和website_key。检查发现的模式以获取您处理的挑战所需的其他参数。不要将REST任务名称复制到MCP类型字段：reCaptchaV2是MCP值，而REST API有其自己的文档任务名称。

然后您的应用程序需要通过目标的预期流程使用返回的令牌。MCP调用本身不会提交每个表单或验证业务结果。对于特定页面的reCAPTCHA输入，请参考reCAPTCHA v2任务文档。

如果参数未知，请使用适当的浏览器工具检查当前批准的页面。从其他页面记住的站点密钥不是当前小部件的证据。将解决连接到正在调试的实际操作。

使用页面工具时注意其浏览器边界

页面工具接受URL并在MCP服务创建的浏览器会话中运行。

对于检测，一个有用的请求是：

对此批准的页面URL调用CapSolver的detect_captchas并报告检测到的类型。不要立即解决它。

当解决该页面是预期操作时，solve_on_page可以执行其文档记录的检测、解决和回填序列。在请求该调用前，检查观察到的挑战和支持的覆盖范围。

重要的边界在官方MCP实现中可见：这些工具为调用打开浏览器并在之后关闭它。它们不会附加到由其他浏览器MCP持有的标签页，也不会自动继承其登录状态。

这使得直接可访问的测试页面比仅在多个私有会话步骤后可用的页面更清晰的起点。如果您的任务需要留在您已控制的浏览器页面上，请使用支持该现有页面的集成。CapSolver Core SDK记录了该不同集成需求的浏览器适配器功能。

现有的Claude Computer Use指南讨论了相邻的浏览器代理表面。Claude Computer Use和此Claude Code MCP设置不应被视为可互换的配置。

在重复验证码调用前修复设置错误

大多数设置失败可以缩小到可执行路径、环境、浏览器安装或任务输入。

如果找不到服务器命令，请使用上述绝对Python路径。如果无法导入包，请验证同一Python环境中是否包含capsolver-mcp和capsolver-core。

如果页面检测报告缺少浏览器可执行文件，请在启动MCP服务器的环境中运行Chromium安装命令。令牌模式只需调用解决服务，因此区分浏览器启动失败与求解API失败。

如果服务器连接但API调用失败，请保留返回的错误代码和脱敏摘要。在另一次尝试前检查账户密钥、支持类型、所需输入和当前页面状态。

如果解决返回令牌但原始应用程序未更改，请检查结果消耗。确认结果被预期工作流使用，并且您没有假设两个独立的浏览器会话共享状态。

保持重复尝试的小限制。当同一错误未解决时，请返回证据供审查，而不是指示代理无限重试。

使用CapSolver构建可靠的自动化工作流

从真实MCP连接开始，检查安装的工具集，并请求与您批准任务中的挑战匹配的操作。

CapSolver为Claude Code提供了经过记录的验证码解决能力。正确的输入和清晰的浏览器边界使该能力有用；最终的应用程序响应会告诉您是否实际完成了预期任务。

常见问题

问：我需要为每个MCP工具安装浏览器依赖吗？

不需要。页面工具需要浏览器附加组件和Chromium。令牌解决和账户或覆盖查询不需要打开浏览器来调用其对应服务或本地功能。

问：CapSolver MCP可以继续我的现有浏览器标签页吗？

在检查的版本中，页面工具会打开并关闭自己的浏览器会话。不要假设它们控制由其他浏览器工具拥有的标签页。

问：MCP服务器支持每个CapSolver REST任务吗？

不。检查get_supported_captchas和发现的工具模式。独立的REST功能不会自动通过此MCP包公开。

问：为什么Claude Code显示待批准？

项目MCP服务器可能在使用前需要批准。在Claude Code中审查它并确认配置的命令，而不是将批准状态视为API密钥错误。

问：成功的解决是否意味着代理完成了其任务？

不。确认结果被预期应用程序使用，并且请求的页面操作已完成。令牌或填写的控件是中间结果。