文档目录
点签 MCP/常见问题
FAQ当前文档:测试环境

常见问题

遇到问题先别反复重试。下面按连接、文件和合同流程分别说明怎么判断;报障时可以提供 request_id,但不要发送企业凭据和合同敏感信息。

本页目录

连接问题

为什么显示 401 或 UNAUTHORIZED?

这句话的意思是“企业应用凭据没有通过验证”。先回到 Agent 的 MCP 设置,检查 APP_ID、APP_SECRET 和环境值是否填全、是否属于同一个企业应用。 环境值应为 sandbox。只在设置页修改,不要把凭据发到聊天里。

为什么个人账号看不到开发者控制台?

注册完成后默认是个人身份。先创建企业或申请加入企业,再在点签页面切换到企业身份, 才能继续找开发者控制台和企业应用。

已经加入企业,为什么仍看不到开发者控制台?

先确认页面当前显示的是企业身份。如果已经切换仍看不到,请让企业管理员核对你的菜单权限; 不同成员能看到的功能可能不同。

个人用户能直接连接点签 MCP 吗?

当前不能。点签 MCP 使用企业应用的 APP_ID 和 APP_SECRET。个人用户可以作为签署人打开签署链接, 但暂时不能用个人账号在 Agent 里发起或管理合同。

把 MCP 地址贴到浏览器里出现 404,是不是服务坏了?

请确认地址精确写成 https://mcp.fs-url.com/mcp。 末尾不要再加 /。浏览器地址栏不会按 MCP 协议发请求,所以直接打开不能判断服务是否接通。 请回到支持 Streamable HTTP 的 Agent 中检查 5 个工具,再做一次只读合同列表查询。

界面显示“已连接”,为什么还是没有五个工具?

先确认连接已启用,再刷新工具列表或新建会话;如果有同名旧连接,先关闭旧连接。 正常情况应恰好看到文档列出的 5 个工具。TRAE Work 国内版还要使用 Work + 云端模式。

支持 WorkBuddy、Kimi 或其他 Agent 吗?

点签使用标准 Streamable HTTP。当前官网已实测 CodeBuddy、QoderWork、Kimi Code 和 OpenClaw;TRAE Work 国内版已验证云端连接、精确五工具和合同列表只读查询。 Claude Code 只核对了 VS Code 项目级配置格式与本机版本记录,尚未证明桌面 Code 页签或真实连接; Codex 只核对了 Windows 桌面配置入口与 config.toml 路径,尚未证明五工具发现; AutoClaw 仍是高级兼容路径,尚未完成真实连接。Kimi Work 与 Kimi Code 不是同一客户端, 本轮没有验证 Kimi Work,应以其当前界面与官方说明为准。其他兼容客户端可以尝试接入, 但未列出不等于已经实测。

文件问题

为什么不能直接拖 PDF 到聊天框?

先直接拖入 PDF。部分 Agent 能看到附件,却不能把原文件交给点签服务。 遇到这种情况,Agent 会自动给你一次性浏览器上传链接,不用重复拖文件。

浏览器上传还要再次输入 APP_ID / APP_SECRET 吗?

不需要。打开链接后直接选择 PDF 即可。链接只对当前合同有效,有效期为 30 分钟, 不要转发、截图或公开发布。上传完成后回到原对话,发起前再核对合同标题、PDF 和签署人。

签署文件和普通附件有什么区别?

签署文件会进入签字或盖章流程;普通附件作为合同附件保存,不参与签署, 也不会出现在签后文件列表里。不同签署端是否展示附件、从哪里打开,以实际页面为准。 技术上分别对应 upload_target: "signing"upload_target: "attachment";普通用户只要告诉 Agent “哪些要签、哪些只供查看”即可。签署 PDF 和普通附件的一次性上传都已经在测试环境上线; 直接拖入聊天是否可用仍取决于 Agent 客户端,生产环境尚未发布。

旧合同的 PDF 为什么有的能复用、有的不能?

只有同一家企业、同一环境中,成功合同的签署前原 PDF(系统标记为 ORIGINAL)可以复用。 签署完成后的 PDF、合同附件、其他企业的文件、损坏文件和已删除文件都不能当作新的签署原件。

支持扫描件 OCR 吗?

暂不支持。文字型 PDF 可以分页读取;扫描件或没有可提取文字的文件会提示no_text,不会自动猜测正文。

合同问题

为什么合同列表里看不到点签 SaaS 的全部历史合同?

当前 dianqian_list_contracts 只覆盖通过本 MCP 建立索引的合同。 这是现阶段 SaaS 接口能力边界,不是全量历史搜索。

创建成功是否表示短信一定送达?

不能只根据 Agent 的自然语言回复判断。是否真实发送和送达,以点签测试环境的通知配置、 后台发送记录和签署人实际接收情况为准。

签后 PDF 能读到文字,是否等于签名验证通过?

不是。读到正文只说明 PDF 里的文字可以提取,不代表电子签名、证书或合同法律效力已经验证。 如需判断签名有效性,应使用正式的电子签名验证能力。

撤销合同前为什么要再次确认?

撤销会产生真实业务结果。Agent 应先展示合同标题、当前状态与撤销原因, 获得明确确认后再调用撤销工具。

顺序签署和无序签署应该怎么选?

需要按先后顺序流转就选顺序签署(sequential):上一位完成后才轮到下一位。 大家可以同时处理就选无序签署(parallel)。对开发人员来说,顺序签署要求每个人都有唯一order;无序签署则必须让所有签署人都完全省略 order,不能填 0。

当前测试范围

测试环境也会产生真实结果

不要上传正式合同或未获准的敏感材料。测试环境仍可能生成真实合同状态、签署链接或通知, 只能使用获准的测试手机号和测试数据。

点签 SaaS 页面支持手动切换个人和企业身份;点签 MCP 当前不替用户登录,也不在 Agent 内切换身份。 普通点签账号 OAuth 和用户管理后台不在当前 MVP。 当前文档也不代表生产高可用、正式 KMS/C2 或生产发布已经完成。