# 常见问题排查

先做只读查询，保留准确错误。不要在支持消息里粘贴密码或令牌。

## 无法连接

- 核对 HTTPS 与完整 /mcp 路径。宣传网站不是 MCP 服务端。
- OAuth 和调用使用同一 app 或租户来源。
- 确认客户端支持 Streamable HTTP 和 OAuth PKCE。
- 云端客户端不能直接访问 localhost，除非另行配置了安全传输。
- 浏览器阻止原生客户端回调时，保留错误和版本号，不要关闭浏览器安全机制。

## 工具缺失

刷新工具发现并开启新对话，必要时重新授权对应用途。管理工具还要求业务角色。旧兼容别名已移除。

## 批准了但没有提交

批准后系统自动执行，无需回到 AI 对话通知。先刷新操作详情，核对排队、执行中、成功、失败或结果未知状态；AI 可查询原始 operation_id。派发中断仅在尚未消费操作时自动重试，最多三次且受原确认期限限制。结果未知时先核对业务记录，不要重建请求。

## 文本字段收到了数字

按 Schema 提供 JSON 字符串。电话号码内容不要带额外引号字符。无效收集表输入会在申请审批前被拒绝；应先修正数据再发起新操作。

## 过期或已使用

不要自动生成替代请求。先核对业务结果是否存在，再询问用户是否申请新的确认。

## 没有显示表单

MCP Apps UI 是可选能力，可打开返回的浏览器链接，或在对话里提供类型正确的字段。

## 联系支持时提供什么

向 service@sanctris.com 提供客户端及版本、时间与时区、工作区 ID、操作 ID 和脱敏错误。不要发送密码、令牌或不必要的表单个人信息。