工具总览
dianqian_find_signers
dianqian_create_contract
dianqian_list_contracts
dianqian_get_contract
dianqian_revoke_contract正常连接后应该不多不少正好 5 个。少了说明没加载完整，多了通常是旧连接还开着；这两种情况都先别发合同。
dianqian_find_signers查找保存签署人
先从当前企业保存过的人里找签署人，例如按姓名或手机号尾号找“王*”。 返回结果会隐藏手机号中间几位，而且只能看本企业的数据。
dianqian_create_contract创建并发起合同
这是主要工具：一次调用完成“把文件准备好”和“正式发起签署”。它支持聊天附件、 一次性浏览器上传链接，以及复用同企业、同环境的旧合同原 PDF。网络抖动或重复点击时， 系统会识别同一次请求，避免重复创建合同。
dianqian_list_contracts列出已索引合同
查看当前企业通过本 MCP 记录的合同。它不是点签 SaaS 的完整历史库， 所以“列表为空”只代表这里还没有记录，不代表 SaaS 后台一定没有合同。
dianqian_get_contract查询详情与正文
向点签 SaaS 核对最新状态。默认只返回合同信息，不把整份正文塞进聊天； 用户明确要求时，才分页读取签署前原文件（original）或签后文件（signed）的文字。
dianqian_revoke_contract撤销合同
撤销还允许撤销的合同。Agent 应先把合同标题、当前状态和原因给你看，得到明确确认后再执行。 已完成或状态不允许的合同不会被强行改掉。
顺序签署和无序签署，怎么说才不会配错？
这两种方式都由 dianqian_create_contract 完成，不会增加新工具。 日常使用时直接说“按顺序签”或“大家可以同时签”即可；下面的参数规则主要给连接器和开发人员核对。
顺序签署（sequential）
第一位完成后，第二位才会收到可用签署入口，依次往后。每位签署人都要有唯一的order，通常按 1、2、3 排列；如果前一位拒签，后面的人不会再进入签署。
这份合同按顺序签：<第一位> → <第二位> → <第三位>。发起前先给我确认。无序 / 并行签署（parallel）
所有人可以同时签。技术参数里每位签署人都必须完全省略 order， 不是填 0，也不是继续填 1、2、3；只要有人仍带 order，请求就会被拒绝。
这份合同让<第一位>、<第二位>、<第三位>同时签。发起前先给我确认。同一个创建工具，也能区分签署文件和普通附件
需要签字或盖章的 PDF 使用 upload_target: "signing"；不写这个参数时也默认按签署文件处理。 只随合同展示、不参与签署的文件使用 upload_target: "attachment"。 普通用户不用手填参数，只要明确告诉 Agent 哪些要签、哪些只是附件。
普通附件上传仍放在现有创建工具里，没有增加第六个 MCP 工具。测试服务器已经验证upload_target: "attachment" 会进入等待上传阶段，而且不会提前创建合同或调用外部 SaaS。 这项状态不代表生产环境已经发布。
遇到这些结果，先看它在说什么
| 现象 | 含义 |
|---|---|
UNAUTHORIZED | 企业凭据没填全、填错、环境不匹配或已经失效 |
RESOURCE_NOT_FOUND | 文件或合同不存在，也可能是不属于当前企业；系统不会借错误信息泄露其他企业数据 |
CONFLICT | 当前状态不允许这次操作，例如合同已经结束，或同一文件正在被另一请求处理 |
RATE_LIMITED | 操作太快，按返回提示等一会再试 |
| 未知结果 / 待核对 | 网络中断后先查结果，不要马上再创建一次，以免发出重复合同 |
报障时提供时间、工具名、request_id 和脱敏后的现象，不要提供 APP_SECRET、完整手机号、上传链接、签署链接或合同正文。