
Emma Foster
Machine Learning Engineer
已发表 Sep 29, 2026
已更新 Sep 29, 2026 · 最小阅读量

solve_captcha实现接受proxy参数,但每个CAPTCHA任务规则仍然适用。detect_captchas和solve_on_page工具签名未暴露浏览器代理参数。一个AI代理团队可能已经有一个批准的出站代理,但仍不确定在何处配置它以处理CAPTCHA。一个设置将AI客户端连接到服务,另一个控制浏览器的导航,第三个是支持的CAPTCHA任务的一部分。将这三者统称为“MCP代理”会使故障排除变得不必要的困难。
CapSolver通过MCP暴露求解工具,但该协议不会将代理、浏览器和远程求解器变成一个网络连接。本指南比较了连接路径和当前记录的工具边界。这是一份配置决策指南,而不是声称特定的企业代理、浏览器会话或凭证求解工作流已端到端测试。
CAPTCHA MCP代理支持意味着特定组件暴露了通过代理路由其连接的方式。组件和连接都需要被命名。
一个代理是网络通信的中介。这个广义的定义无法告诉你哪个进程使用它,或者工具参数是否被转发到浏览器、API客户端或远程求解任务。
MCP传输规范区分了本地标准输入/输出通信与可流式传输的HTTP。本地stdio连接是与进程的通信;它不是对远程MCP端点的HTTP请求。启动的进程在执行其工作时仍可以进行单独的网络请求。
对于远程MCP,客户端到服务器的HTTP连接是另一个需要检查的路径。企业网关可以在不改变服务器的浏览器访问网页方式的情况下影响该路径。成功的MCP工具发现证明了发现工作正常;它不证明目标页面访问或成功的求解。
正确的代理设置属于负责您需要控制的连接的进程。使用此比较来识别该所有者。
| 连接 | 什么通过它传输 | 在哪里检查配置 |
|---|---|---|
| AI客户端到远程MCP服务 | 协议消息和工具请求 | 客户端传输和批准的网络配置 |
| 浏览器到允许的目标页面 | 导航和页面资源 | 实际的浏览器运行时或托管服务 |
| 使用支持代理的求解任务 | 任务特定的求解流量 | 选定的求解工具和CAPTCHA任务合同 |
还有服务的出站API连接到CapSolver。其HTTP客户端行为是部署问题,与传递任务级代理值无关。不要假设一种网络库支持的环境变量会被堆栈中的每个组件遵守。
一个有用的团队备注为每条路径命名进程和端点。例如:本地客户端启动MCP进程;该进程连接到求解API;一个单独的浏览器运行应用程序的QA会话。这些陈述立即揭示了为什么浏览器代理设置可能对API调用没有影响。
保持备注描述性。它不应包含代理密码、账户凭证或可用的CAPTCHA令牌。团队需要足够的信息来识别失败的路径,而不将架构文档变成一个秘密存储库。
当前的官方实现暴露了solve_captcha上的proxy,而浏览器工具暴露了不同的参数集。这种区别在本指南审查的官方MCP服务器实现中可见。
solve_captcha接受CAPTCHA类型、页面URL、站点密钥和额外的可选参数,包括proxy。该实现将该值传递给核心求解器使用的CAPTCHA信息。
这是工具参数的证据,而不是每个底层任务都使用所提供代理的承诺。遵循所选任务的当前要求。还要区分MCP工具的参数命名和接受格式与原始API负载;将直接API示例复制到MCP工具调用中而不检查其模式可能会产生与您意图不同的请求。
CapSolver MCP服务指南是支持服务和可用工具的适当起点。检查您安装的服务所宣传的模式,因为安装的包可能与存储库修订版或旧文章不同。
在审查的实现中,detect_captchas接受页面URL。solve_on_page接受页面URL和自动填充和等待的选项。这两个工具签名未暴露浏览器代理参数。
浏览器助手启动浏览器,打开提供的URL,并在操作后关闭该会话。因此,这些工具不应被描述为自动附加到代理已打开的浏览器标签。在该独立浏览器中的成功求解不会建立代理原始表单是否收到令牌。
如果您的任务依赖于现有的浏览器上下文或配置的浏览器网络路径,请在选择工具前明确解决该需求。向提示中添加一个虚构的browser_proxy字段不是集成方法。自定义浏览器集成需要其自己的支持接口和验证。
CAPTCHA任务参考应决定提供的代理是否需要、支持或不必要。任务名称本身是一个有用的线索,但当前的参数合同是决定性证据。
CapSolver的代理使用参考解释了任务级代理配置。例如,reCAPTCHA v2任务参考区分了无代理选项和需要调用者代理的企业任务。
Turnstile有不同合同。Turnstile任务参考指定AntiTurnstileTaskProxyLess并说明调用者不需要提供代理。MCP包装器中的通用代理参数不会覆盖该任务特定的文档。
对于选择路线的团队,询问支持任务的要求和组织需要的网络控制。不要仅仅因为工作流包含CAPTCHA就选择代理。不必要的设置可能增加另一个变量而没有解决原始失败。
较旧的代理设置文章提供了直接API使用的背景。对于当前的任务名称和字段,请使用实时任务文档,而不是未更改地复制旧示例。
领取您的CapSolver优惠码
立即提升您的自动化预算!
在充值CapSolver账户时使用优惠码 CAP26,每次充值可获得额外 5% 的奖励 —— 没有上限。
现在在您的 CapSolver仪表板 中领取
企业代理为相关进程引入了网络要求,而不是通用求解器选项。考虑一个假设的QA团队,其AI客户端在受管理的笔记本电脑上运行,而其测试浏览器在单独的工作器上运行。
笔记本电脑的远程MCP连接可能成功,而工作器无法加载批准的测试页面。相反,工作器可以正常导航,而MCP服务无法到达求解API。这些是不同的事件,即使代理将两者都总结为“CAPTCHA工具失败”。
团队应首先确定哪个进程产生了错误。然后检查相应的目标和适用的网络策略。如果响应是HTTP 407,则HTTP代理认证参考将其标识为代理认证要求。该响应不是CAPTCHA解决方案,不应触发新的求解请求。
对于本地stdio服务,分别调查进程启动与出站连接。缺失的可执行文件、不可用的运行时和远程网络故障不是可互换的原因。保持客户端启动日志和工具执行错误分开,以便调查人员不会更改任务参数以修复进程启动问题。
验证应一次建立一个边界,最终以实际允许的应用程序结果结束。工具列表或返回的令牌对于其自身阶段是有用的证据,但都不能证明整个工作流。
首先确认客户端实际加载的服务。确认其包版本或部署修订版并检查其宣传的工具。MCP工具规范描述了工具发现和输入模式;使用该合同而不是假设自然语言指令添加了支持的参数。
接下来,验证目标浏览器是否可以在其配置的网络条件下访问批准的页面。除非这是工作流设计使用的浏览器,否则不要用MCP助手打开的单独浏览器代替。
然后检查所选CAPTCHA任务及其接收的输入。检查页面URL、站点密钥、任务类型和任务特定的代理要求。将此配置审查与实时求解器测试分开:一个看起来有效的负载并不能证明凭证、目的地或求解结果有效。
对于允许的实时测试,保留实际任务结果和后续应用程序结果。如果无法进行真实运行,请记录该限制而不是将文档审查描述为成功的连接。本指南提供选择标准;它不提供伪造的执行输出。
记录服务版本、工具名称、失败连接阶段、相关脱敏错误和预期页面操作。注意失败是在任务提交前、求解期间还是结果返回后发生。
从未到达求解器的请求不应计为求解器质量失败。返回到单独浏览器的令牌不应计为对代理自身表单的成功更新。这些区别让团队改进工作流的正确部分,而不会添加重复调用或推测性配置。
通过连接所有权选择代理设置:客户端传输、浏览器导航和受支持的求解任务。在在这些层之间传递参数之前,请确认当前工具模式和所选任务参考。
使用CapSolver进行记录的CAPTCHA求解步骤,并保持代理的浏览器和网络配置明确。结果是团队可以按阶段诊断的工作流,而不是将每个连接错误视为另一个未解决的挑战。
Q: CapSolver MCP是否支持代理参数?
审查的官方solve_captcha实现暴露了proxy参数。其效果仍取决于底层CAPTCHA任务。请检查安装的服务模式和该任务的当前文档。
Q: 该参数是否也配置浏览器代理?
不。求解任务参数不会配置独立浏览器的网络路径。审查的浏览器工具在其签名中未暴露浏览器代理参数。
Q: MCP浏览器工具是否使用我的代理的现有标签?
审查的实现从提供的页面URL打开一个单独的浏览器会话并在之后关闭它。不要假设结果会更改已打开的代理标签或保留该标签的应用程序状态。
Q: Turnstile是否需要调用者提供的代理?
当前CapSolver的Turnstile参考文档说明AntiTurnstileTaskProxyLess且不需要代理。即使通用包装器暴露了其他可选参数,也应遵循该任务特定的合同。
Q: 当连接返回HTTP 407时应该检查什么?
检查失败连接的代理认证。在更改配置之前确定哪个客户端或进程收到响应;请求另一个CAPTCHA解决方案不会解决代理认证。

Emma Foster
Machine Learning Engineer
Where machine learning meets practical AI tooling.
关于作者