先做三项检查
- URL 是否正好是
https://mcp.fs-url.com/mcp，末尾没有斜杠。 - 三项 Header 是否齐全，环境是否固定为
sandbox。 - 完全重启客户端并新建会话后，是否恰好出现 5 个点签工具。
已经能看到 5 个工具时，再用“看看最近 5 份合同。只查，不要修改。”做一次安全查询。
常见错误怎么理解
| 现象 | 先检查什么 |
|---|---|
401 UNAUTHORIZED | APP_ID、APP_SECRET、sandbox Header 是否缺失或不匹配 |
/mcp/ 返回 404 | 把地址改成末尾不带斜杠的 /mcp |
| 显示已连接，但没有工具 | 刷新工具列表、关闭同名旧连接、重启并新建会话 |
| 工具存在，但 SaaS 请求失败 | 记录错误时间和 request_id；自行部署时再核对服务器出口 IP 白名单 |
| 有签署链接但没短信 | 核对测试环境通知策略、手机收件和点签后台发送记录 |
| PDF 无法直接上传 | 让 Agent 返回一次性浏览器上传链接，不要反复拖同一文件 |
报障时提供这些信息
- 客户端名称、版本和操作系统。
- 发生时间，精确到分钟，并注明时区。
- 当时在做什么：连接、查合同、上传、创建、签署后查询或撤销。
- 错误码、脱敏后的错误信息和
request_id。 - 服务是否显示已连接，5 个工具是否全部出现。
- 可以复现的最短步骤，以及脱敏截图。
request_id 是最有用的排障线索
它可以帮助技术人员在不需要 APP_SECRET 的情况下定位同一次请求。
这些信息不要发进工单或群聊
- APP_SECRET 或包含真实 Secret 的完整配置文件。
- 完整手机号、身份证号、合同正文和未打码的业务编号。
- 可以直接打开的签署链接或一次性上传链接。
- 包含敏感 Header、Cookie 或令牌的网络抓包。
联系企业的点签项目对接人员
当前文档没有公开邮箱、工单地址或服务时限承诺。请把脱敏后的报障信息交给你所在企业的点签项目对接人员或技术支持人员，由其按项目渠道升级处理。