MCP App 资源与显示

调节 HTML 大小和读取期限，核对 WebShell 显示、转录留存与失败退路。

MCP Apps 可以把工具结果关联到 HTML 界面。资源读取上限与工具执行超时、客户端是否支持显示，是三个不同问题。

按服务设置

在原来声明服务的同一配置来源增加字段：

{
  "mcpServers": {
    "internal-app": {
      "httpUrl": "https://tools.example.com/mcp",
      "appResourceMaxBytes": 4194304,
      "appResourceTimeoutMs": 120000
    }
  }
}

此例只是需要替换服务地址的完整条目。同名服务器跨来源替换整个对象，不会把这两个字段合并进另一文件的身份或地址配置。

限制如何计算

字段	默认与范围
appResourceMaxBytes	解码后 HTML 的 UTF-8 字节数，默认 1,048,576，限制在 1–4,194,304
appResourceTimeoutMs	显式设置时限制在 100–120,000 毫秒；未设时取一般 timeout 与 10,000 的较小值

有限数字向下取整后夹到范围内；非数字或非有限值回默认。显式资源期限独立于工具执行超时，取消仍在任何限额下生效。

超限不会抹掉成功工具结果

限制失败保留已经成功的工具结果，并给出对应配置键的警告。增加 HTML 上限不会把它送入模型上下文，但会增加保留转录与回放数据量。

大小检查在 SDK 读取响应之后进行，不能限制网络下载量或峰值内存。调大这两个字段也不改变 sandbox、CSP 或 App bridge 能力，不保证所有 App 兼容。

哪里能看到界面

HTML 仅在 daemon-backed WebShell 会话和已记录转录回放中挂载。终端与无头模式显示 fallback 文本；在这些表面调上限只改变资源读取代价、延迟、警告和转录体积，不会让终端显示 HTML App。

服务仍需原来的认证。遇到空白界面先区分 OAuth、工具失败、资源限制和显示表面，不要仅靠提高字节上限处理所有问题。