为 Cherry Studio Agent 配置网页访问工具

通过经过检查的 HTTP MCP 工具连接穿云公共 API。分别验证服务器连接、Agent 工具绑定与目标响应,不把模型供应商配置当作网页请求入口。

Cherry Studiocloudbypass-project
任务对话

在 Cherry Studio 中接入穿云 API;用安全配置保存密钥,先生成一个只读请求。

Cherry Studio

保留工具审批;密钥不进入对话或网页。

配置密钥和目标地址后,在你的运行环境中发起请求。
request.sh
curl --include --request GET \
  "https://api.cloudbypass.com/" \
  --header "x-cb-host: example.com" \
  --header "x-cb-apikey: ${CLOUDBYPASS_APIKEY:?}" \
  --max-time 90

请求后检查 x-cb-status、HTTP 状态与实际业务内容。

接入任务
Cherry Studio · 接入配置预览
  • 先检查 MCP 服务,再绑定给所需 Agent
  • 请求工具必须支持 API 请求头与凭据隔离
  • 只保留必要工具和访问权限

选择适合项目的接入方式

已有项目可直接调用 API;需要复用任务或连接工具时,再选择 Skill 或 MCP。

直接调用公共 API

沿用项目的 HTTP 客户端,自己控制请求、会话和结果处理。现在即可验证。

API 文档

使用 Skill 组织任务

让 AI 读取接入规则,再按任务准备参数、检查状态和处理失败。

Cloudbypass Skill

在 OpenCode 中接入穿云 API

在 OpenCode 的项目终端中准备网页请求,把访问规则写入 AGENTS.md,并在运行环境安全配置 API Key。先检查目标响应,再继续修改代码或整理数据。

OpenCode

请求配置

Method
GET
URL
https://api.cloudbypass.com/
x-cb-host
example.com
x-cb-apikey
<CLOUDBYPASS_APIKEY>

通过安全配置注入凭据,不要将真实密钥写入节点说明。

从准备到验证,完成首次接入

先获取一个目标页面,确认返回内容,再增加代理、会话和后续处理。

  1. 验证公共 API 与工具能力

    先在可信环境验证一个授权目标。选择支持自定义请求头、超时与安全凭据的 HTTP MCP 工具,不把 API 地址当作模型服务。

  2. 添加并检查 MCP 服务

    在设置中的 MCP 入口添加经过检查的本地命令或远程服务,核对工具列表、输入参数与权限。不要填写未发布的穿云托管 MCP 地址。

  3. 绑定 Agent 并检查结果

    将运行正常的服务器绑定到需要的 Agent,再测试一次只读请求。检查 x-cb-status、目标状态与实际内容,工具不可见时先查绑定、启用状态和审批。

先验证 API,再连接客户端工具

先在可信后端或终端运行 cURL,确认 API 可用;再让客户端通过支持请求头和安全凭据配置的 HTTP MCP 工具发起访问。

从最小请求开始HTTP API
curl --include --request GET \
  "https://api.cloudbypass.com/" \
  --header "x-cb-host: example.com" \
  --header "x-cb-apikey: ${CLOUDBYPASS_APIKEY:?}" \
  --max-time 90

# POSIX shell 示例;密钥先在安全环境中配置。
# 同时检查 x-cb-status、目标状态与实际内容。
# V2 / V2s 按文档添加版本和稳定代理参数。
在运行环境中保存密钥,执行请求后检查状态与正文。

检查响应

请求后检查 x-cb-status、HTTP 状态与实际业务内容。

保留工具审批;密钥不进入对话或网页。

  1. 触发任务
  2. HTTP 请求
  3. 响应检查
  4. 保存内容

Cherry Studio 的服务器连接与 Agent 绑定

MCP 服务已连接不等于当前 Agent 已绑定工具。不同版本的入口可能不同,以实际客户端为准。网页数据不是可信指令;密钥不应写进对话、技能或共享配置。

运行配置、任务配方与验证记录示意
检查项应核对的内容下一步
密钥与权限凭据、余额与授权范围是否正确修复配置后再请求,不盲目换 IP
版本与会话V2 / V2s 的稳定代理与会话是否匹配代理改变后重建对应验证会话
两层响应x-cb-status 与目标 HTTP 状态是否均符合预期200 也要确认不是登录页或验证页
输出与重试内容类型、实际字段和尝试预算配置错误停止;临时故障才有限重试

从工具接入走向实际使用场景

按任务选择原有方案,继续查看访问策略、实施步骤与排查建议。

选型与排障

开发与工具集成

业务应用场景

常见问题

现在应该使用哪种接入方式?

先使用现有公共 HTTP API 完成最小验证。OpenClaw 可使用已发布 Skill;已有 HTTP MCP 工具需要支持请求头与安全凭据注入。官方托管 MCP 仍在规划中。

如何确认我的目标网站可以访问?

先对目标发起一次请求,检查状态与正文是否符合预期。相关访问场景包括 Cloudflare JavaScript Challenge、Turnstile、DataDome 与 Imperva / Incapsula,兼容性需按目标测试。reCAPTCHA、hCaptcha 不包含在当前接入能力内;受限内容仍需要相应账号权限。

密钥和代理密码应该放在哪里?

保存在实际运行环境或可信服务端的安全配置中。不要放进网页前端、共享仓库、提示词、截图或公开日志。远程服务的环境与本机独立。

MCP 或 Skill 会自动完成分页和提取吗?

不默认承担。访问层负责请求与响应;分页、字段提取、去重、登录态与业务签名由任务工作流或站点配方负责。验证失败时先定位原因,不无限重试。

API 接入问题、响应检查与技术支持示意

开始你的第一次网页请求

配置密钥和目标地址,确认响应内容后,再接入现有项目。