MCP 接入

Sanctris 提供基于 Streamable HTTP 的远程 MCP 服务，不是本地 stdio 服务，也不是旧式 SSE 地址。

服务端点

用途	主站地址
MCP	https://app.sanctris.com/mcp
受保护资源发现	https://app.sanctris.com/.well-known/oauth-protected-resource/mcp
授权服务器元数据	https://app.sanctris.com/.well-known/oauth-authorization-server
动态客户端注册	https://app.sanctris.com/oauth/register
浏览器授权	https://app.sanctris.com/oauth/authorize
令牌交换与刷新	https://app.sanctris.com/oauth/token

租户地址采用同样路径，域名为 https://工作区.t.sanctris.com。优先使用 OAuth 元数据发现，不要硬编码全部端点。

认证

已实现 OAuth 授权码、PKCE S256 和动态客户端注册。公共客户端令牌认证方式为 none，支持 authorization_code 和 refresh_token。连接使用被授权工作区用户的身份。

客户端发现元数据、注册准确的回调地址、生成 PKCE 与客户端 state、打开浏览器授权，再用 verifier 换取令牌。resource 必须匹配 MCP 地址。不要通过 AI 工具传递用户密码。

刷新令牌由客户端安全存储，不能写入共享 JSON。可在产品“AI 协作”中撤销连接，停止后续访问。

权限与工具集

sanctris：读写权限，仍受角色和用途约束。
sanctris:read、sanctris:write：访问限制。
sanctris:design、sanctris:analytics、sanctris:admin：用途选择，本身不授予读写能力。
未指定用途标记时默认日常工具集。

认证后通过 tools/list 发现工具，不要假设每个连接都有固定数量的工具。

协议兼容

服务端采用 MCP TypeScript SDK v2 的 2026-07-28 协议入口，并保留面向 2025 客户端的无状态协商。实际协议版本由客户端决定，不代表已认证全部客户端或所有可选协议特性。

MCP Apps 可视化界面是可选能力。不支持渲染时使用工具返回的浏览器链接。

写操作

遵循人工确认流程。批准后自动执行已审核参数，使用 execute_approved_operation({ "operation_id": "首次返回的ID" }) 查询结果。不要复制长确认令牌、重试时修改参数，或仅凭 HTTP 200 判定成功。检查 MCP 的 isError 和工具内容。