Zyntos MCP:在 Codex 中用自然语言管理云手机与 RPA

连接 Zyntos 与 Codex,在当前账号和租户权限范围内查询云手机、素材、账号资源和 RPA 任务,并完成经过授权的创建、绑定、启停和任务编排操作。

文档版本 1.0 · 更新于 2026-07-24 · 当前提供 27 个工具

什么是 Zyntos MCP

Zyntos MCP 是 Zyntos 面向智能客户端提供的安全连接服务。完成授权后,你可以直接在 Codex 中用自然语言查询 Zyntos 业务数据,或让 Codex 协助完成已获得授权的业务操作。例如:

查询我的云机列表,并按运行状态汇总。
查找当前租户中可用于 TikTok 发布的视频素材,先列出候选项。
查询最近的 RPA 任务和执行结果,并列出需要关注的失败任务。

Zyntos MCP 不会赋予账号新的业务权限。Codex 能看到和执行的内容,始终取决于:当前登录的 Zyntos 账号、授权时选择的租户、该账号在所选租户中的角色与业务权限,以及目标资源是否属于所选租户且仍然有效。

核心能力

当前支持的 RPA 模板

使用前准备

接入前请确认:

• 已拥有状态正常的 Zyntos 账号
• 账号已获得 MCP 访问权限
• 账号至少拥有一个有效的租户角色
• 目标租户已开启 MCP 接入
• 使用支持远程 MCP 和 OAuth 的 Codex 版本

当前官方接入指引以 Codex 为主。使用命令行接入时,最低支持版本为 codex-cli 0.144.5。检查版本:

codex --version

平台身份和服务商身份目前不支持使用 Zyntos MCP。

安装与连接

Zyntos MCP 有「插件安装」和「手动连接」两种方式,连接的是同一个生产 MCP 服务,业务能力和权限范围一致。

手动连接(命令行)

生产接入信息:

OAuth 应用 ID 是公开客户端标识,不是密码。

在终端执行:

codex mcp add zyntos \
  --url https://saas.zyntos.net/mcp \
  --oauth-client-id 7gvz6yvp04xxt6waydjwb \
  --oauth-resource https://saas.zyntos.net/mcp

检查连接:

codex mcp list

列表中应出现名称为 zyntos、地址为 https://saas.zyntos.net/mcp 的连接。添加后 Codex 通常会自动打开浏览器授权;如果没有自动开始,可执行:

codex mcp login \
  -c mcp_oauth_callback_port=8765 \
  --scopes offline_access,mcp:tools \
  zyntos

从 Codex 插件目录安装(上架后)

插件公开上架后,在 Codex 插件目录搜索「Zyntos」,打开由「深圳市燚笙科技有限公司」发布的插件并点击安装,按提示登录并确认授权、选择租户即可。插件会自动配置 MCP 地址和业务规则,无需手工填写。插件本身不包含访问令牌、密码或服务端密钥,安装后仍需完成 OAuth 授权。

登录、授权与租户选择

浏览器打开授权页面后,登录 Zyntos 账号、查看并确认权限、选择本次连接使用的租户,授权完成后返回 Codex。账号只有一个有效租户时会自动选择;有多个租户时需要手动选择一个。

一次 MCP 连接只绑定一个租户。连接建立后,新建任务或重启 Codex 都不会改变租户范围,客户端也不能通过对话、请求头或工具参数切换租户。需要更换租户时,退出并重新授权:

codex mcp logout zyntos
codex mcp login \
  -c mcp_oauth_callback_port=8765 \
  --scopes offline_access,mcp:tools \
  zyntos

验证连接

完成安装或手动连接后,完全退出并重新打开 Codex,新建任务,先发起一次只读查询:

使用 Zyntos 查询我的云机列表,并按状态汇总。

能返回当前租户的云机结果,说明连接、登录和基础权限已生效。若返回 0 条,通常表示连接已成功,只是当前角色可见范围内暂时没有对应数据。

推荐使用方式

查询我的云机列表,按运行状态汇总,并列出需要关注的异常状态。

请使用 Zyntos 创建一台用于社媒运营的云手机。提交前先向我确认用途、机房、规格、数量和使用时长。只创建一台,不要重复创建。

请为我指定的云手机绑定用于 TikTok 的日本东京 SOCKS5 代理。绑定前先确认使用自有代理还是平台代理,成功后再启动云手机,并告诉我代理状态和开机状态。

查找当前租户中可用于 TikTok 发布的视频素材,先列出名称、时长和可用状态。等我选择后,再预览选中的素材。

使用我选择的运营单元和视频素材创建一个 TikTok 视频发布任务。提交前先向我确认发布时间、时区、标题、描述和话题标签。

为我指定的运营单元创建一个 60 分钟后执行的 TikTok 养号单次任务。执行 15 分钟,内容主题为 Food,点赞比例 10%,关注、收藏和评论比例均为 2%。提交前先确认目标、时间和时区。

查询最近的 RPA 任务和执行记录,按成功、失败和待执行分类,并列出失败任务需要关注的原因。

通过工具参数直接接入养号任务时,参数放在每个目标的 nurture 字段:

{
  "operation_unit_id": "运营单元ID",
  "scheduled_at": "2026-07-24T04:12:21.537Z",
  "time_zone": "Asia/Shanghai",
  "nurture": {
    "duration_minutes": 15,
    "subject_class": "Food",
    "hash_tags": ["mcp-uat"],
    "speech_template": "",
    "like_ratio_percent": 10,
    "follow_ratio_percent": 2,
    "favorite_ratio_percent": 2,
    "comment_ratio_percent": 2
  }
}

app_name 和 strategy_description 由服务端生成,不需要作为养号创建参数提交。

权限与操作确认

工具会根据当前租户角色的业务权限动态开放:没有权限的工具不会出现在可用列表中,即使直接调用服务端也会再次校验并拒绝;资源 ID 会按当前授权租户重新校验,不能通过提供其他租户 ID 扩大访问范围。

只读查询通常可直接执行。以下操作会改变业务状态或可能产生费用,执行前应核对关键内容:

• 创建云手机
• 启动、停止或重启云手机
• 创建或绑定代理
• 创建运营单元分组或运营账号
• 绑定运营单元与云手机
• 创建或编辑 RPA 任务
• 暂停、恢复、取消或重试 RPA 任务
• 刷新并保存外部执行结果

无论客户端界面是否出现单独确认按钮,都应在提交前检查业务对象、目标数量、时间、规格、费用风险和可能影响。

数据与安全

• 使用 OAuth 2.0 Authorization Code + PKCE 完成用户授权
• 每个连接固定绑定一个账号、一个租户身份和对应角色
• 每次调用都会重新检查用户状态、角色状态、租户开关和业务权限
• 客户端不能自行指定或切换租户边界
• 服务端不返回访问令牌、登录密码、代理密码或第三方原始响应
• 停止云手机不会释放云手机;重启不会执行「一键新机」,不会主动清除代理绑定

连接管理

退出当前设备 / 移除连接

# 退出当前设备(保留连接配置)
codex mcp logout zyntos

# 从当前设备移除连接
codex mcp remove zyntos

撤销授权

在 Zyntos 个人中心的「MCP 授权」可查看并撤销当前账号的连接;租户管理员可在租户后台「MCP 接入」页面查看接入状态、调用记录,撤销连接,或开启 / 关闭本租户的 MCP 接入。关闭后已有连接失效,重新开启需重新授权。

常见问题

使用限制

• 目前仅支持租户身份,平台和服务商身份不支持
• 当前不提供云手机释放、删除、充值、退款或审批
• 当前不提供 RPA 任务删除;一次性 RPA 任务不支持暂停或恢复
• 插件和 MCP 不会绕过现有业务权限;工具是否可用以当前租户角色权限为准
• 不应使用停止、重启等操作代替未提供的释放或删除能力

获取支持

技术支持邮箱:service@zyntos.net,服务时间 7×12 小时咨询服务。相关页面:

• 隐私政策:https://saas.zyntos.net/privacy
• 服务协议:https://saas.zyntos.net/terms

提交问题时建议提供 Codex 版本、操作系统、MCP 连接名称、发生时间、期望使用的租户名称,以及不含敏感信息的错误文本。请勿提交密码、验证码、访问令牌、代理密码或完整 OAuth 回调参数。

工具目录

Zyntos MCP 当前提供 27 个工具。普通用户无需记住工具名称,直接用自然语言描述需求即可;下表供技术参考。