MCP App 资源与显示

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

This page has not been translated into English yet. The original Chinese version is shown below.

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、工具失败、资源限制和显示表面，不要仅靠提高字节上限处理所有问题。