AI 工程从零到一（中文）
给定一个可能需要交互式视图的 MCP 工具，产出一份与框架无关的契约。
所需输入
- 工具名称、参数、普通文本结果和结构化结果。
- 视图必须支持的用户交互。
- 数据敏感性，以及响应是否随授权上下文变化。
- 视图所需的浏览器权限和外部源。
- 未支持 Apps 的宿主的纯文本行为。
产出
- 当前核心信封。展示
2026-07-28、每个请求的protocolVersion、clientCapabilities、建议的clientInfo、匹配的Mcp-Method和Mcp-Name请求头，以及resultType响应。 - 发现条目。在
server/discover中声明io.modelcontextprotocol/ui，并使用保守的ttlMs和cacheScope。 - 工具声明。将嵌套的
_meta.ui.resourceUri放在tools/list返回的工具上。不要等到tools/call才暴露 UI。 - 资源契约。在
resources/read前包含确定性的resources/list元数据。给出一个规范ui://URI、稳定名称和说明、text/html;profile=mcp-app、缓存提示、CSP 域名列表（connectDomains、resourceDomains、frameDomains、baseUriDomains）以及最小权限对象。 - 结果契约。无论宿主是否渲染 App，都返回有用的文本和结构化数据。
- 桥接契约。列出每个 Apps
ui/*或被代理的方法、精确消息源、参数 schema、结果 schema 和宿主侧同意检查。 - 回退。描述 client 省略 Apps 扩展能力时的工具和结果。
- 验证表。覆盖路由前 HTTP 400
-32020请求头不匹配、HTTP 400-32022及精确的受支持与请求版本数据、HTTP 400-32021及data.requiredCapabilities、HTTP 404-32601、202 空 body 通知、CSP 违反、不可信内容、未授权桥接调用和文本回退。 - 传输边界。如果实现接收已解析的请求和请求头，应标明它是进程内协议模型，并连接到第 09 课的完整 Streamable HTTP adapter。真实 adapter 必须要求 JSON Content-Type 和一个同时包含 JSON 与 SSE 的 Accept 值。
硬性拒绝
- 将核心
initialize、notifications/initialized或Mcp-Session-Id路径称作当前 MCP。 - 使用通配符
postMessage目标源，或接收方跳过event.origin验证。 - 只在工具运行后才暴露 UI 绑定。
- 通配符 CSP 域名列表、无界网络源，或没有可见功能的权限。
- 插入用户控制的 HTML，却未定义净化边界。
- 将 iframe 点击视为宿主授权的后果性 UI 操作。
- server 声明资源却省略
resources/list。 - 为没有
id的通知发送任何 JSON-RPC 响应 body。
兼容性边界
可将旧版扁平 UI 元数据作为回退读取，但新输出使用嵌套的 _meta.ui.resourceUri。只有明确作为 Apps postMessage 握手时，才允许 ui/initialize。它绝不替代已移除的 MCP 核心初始化。
输出格式
返回一份紧凑设计，使用这些标题：Core Wire、Discovery、Tool、Resource、Result、Bridge、Security、Fallback、Verification。最后写出风险最高的单项源、权限或同意假设。