国内应用接入
腾讯电子签 MCP 接入:批量查询合同流程状态
使用腾讯云 API 密钥和企业内员工 UserId,让机器人按 FlowId 批量读取合同名称、状态、创建日期等上游摘要字段。当前不会发起、签署、催办或撤销合同。
腾讯电子签连接适合哪些任务?
法务、销售或运营经常需要核对一批合同是否待签、已完成或已终止。当前连接调用 DescribeFlowBriefs,把 1–100 个 FlowId 的官方流程摘要返回给机器人进行状态分组和异常清单整理。
调用身份由腾讯云 SecretId、SecretKey 和腾讯电子签企业内员工 UserId 共同确定。结果只包含该员工及密钥权限可以访问的流程;机器人不会绕过企业权限,也不会执行任何合同写操作。
接入后可以做什么?
- 批量查询流程摘要:一次提交 1–100 个 FlowId,获取腾讯电子签返回的合同流程基础信息。
- 按状态整理合同:让机器人根据官方结果汇总待处理、进行中、已完成或异常项目。
- 核对缺失流程:把输入 FlowId 与返回结果对照,列出不存在、无权限或需要人工检查的项目。
SecretId、SecretKey 与员工 UserId 怎么配置?
建议创建专用腾讯云 CAM 子用户,只授予腾讯电子签查询所需权限,再使用该子用户的 SecretId、SecretKey,以及调用方企业内已实名且有数据权限的员工 UserId。
- 确认企业版电子签环境 — 登录腾讯电子签企业版,确认合同流程和调用员工属于正确企业。
- 创建最小权限 CAM 子用户 — 在腾讯云访问管理中创建专用子用户,只授予电子签 DescribeFlowBriefs 等查询权限。
- 生成 API 密钥 — 为子用户创建 SecretId 与 SecretKey,并按腾讯云安全建议妥善保存。
- 获取电子签员工 UserId — 使用企业内已实名且拥有目标合同数据权限的员工 UserId,不要填写手机号或昵称代替。
- 连接并查询测试合同 — 在国内应用列表填写三个字段,再用 1–2 个已知 FlowId 核对名称和状态。
连接后可以直接这样问
- “查询这 10 个腾讯电子签 FlowId 的状态,并按状态分组”
- “把没有返回摘要的合同 ID 单独列出,不要猜测原因”
- “核对这些合同是否全部完成,只依据腾讯电子签官方返回结果”
使用前必须知道的限制
当前只有 flow_briefs 一个只读动作,每次接受 1–100 个 FlowId。它不创建合同、发起签署、下载文件、催办、撤销、盖章或修改流程;输入顺序与返回顺序可能不同,应按 FlowId 对齐。官方默认频控、字段和权限以腾讯云文档为准。
合同名称、参与方和状态可能属于商业机密或个人信息。使用专用 CAM 子用户与最小权限策略,不要使用主账号永久密钥;机器人摘要不能替代合同原文、签署证据或法律意见。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接腾讯电子签的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行维护 CAM 策略、SecretId/SecretKey 轮换、员工权限、TC3-HMAC-SHA256 签名、FlowId 对齐、频控、审计与法律合规。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
腾讯电子签接入常见问题
可以让机器人代替员工签合同吗?
不可以。当前连接只查询合同流程摘要,不提供签署、盖章、发起、催办或撤销动作。
一次最多查询多少个合同?
当前每次可以提交 1–100 个 FlowId;更大的清单需要拆批并按 FlowId 合并结果。
为什么有些 FlowId 没有权限?
结果受腾讯云 CAM 权限、电子签企业归属和员工 UserId 的数据权限共同控制,请在官方控制台核对。
可以使用腾讯云主账号密钥吗?
技术上可能可用,但不建议。应创建专用 CAM 子用户并只授予电子签查询权限,降低密钥泄露影响。