借助 Web Model Context Protocol (WebMCP),开发者可构建结构化工具并公开给浏览器中运行的 AI 智能体。智能体依托大模型、规则、记忆和工具代表用户执行操作。然而,由于大模型将文本、指令和用户数据视为单一 token 序列,极易受到间接提示注入攻击(即攻击者植入恶意指令)。尽管部分模型具备防护层,但基于概率性的本质无法完全保证内部安全,且针对先进大模型智能体系统的可重复提示注入攻击正日益普遍。
为保障开发者网站及用户安全,以下是针对使用 WebMCP 构建工具的安全指南。
使用注解提示增强安全性
在构建工具时,建议添加以下关键提示以明确数据属性和操作风险:
- 标记不可信内容:若工具返回用户生成内容 (UGC) 或外部来源数据,请添加
untrustedContentHint。此举将数据明确标记为不可信,既保护网站完整性,也向智能体发出需严格审查的信号。 - 高风险操作确认:对于会导致重大后果或不可逆的操作(如预订行程、转账),请设置
consequentialHint: true,促使智能体或浏览器在执行前请求用户确认。 - 只读操作标识:对于不更改状态的工具,使用
readOnlyHint,帮助智能体更准确地判断何时无需请求用户确认。
谨慎开放工具访问权限
WebMCP 的 document.modelContext.registerTool API 默认仅向智能体开放工具能力,其他网站或跨源 iframe 无法观察或交互。开发者可通过 exposedTo 选项,向特定的安全来源授予访问权限。
// https://partner.org
await document.modelContext.registerTool({
name: 'my_shared_tool',
description: 'Shared across origins',
// ...
}, {
exposedTo: ['https://trusted.com', 'https://example.com']
});
安全建议:仅向您信任的来源开放工具,特别是涉及用户数据管理时。
- 只读工具:如
getFavoriteProducts可能泄露用户信息,应仅向原本就直接共享用户数据的可信站点开放。 - 读写工具:此类工具代表用户执行操作(如
postComment),应严格限制仅向认定的可信来源开放,避免向恶意站点暴露权限。
注意:Chrome 扩展程序可使用内容脚本查询和执行 WebMCP 工具。借助
host_permission,这些扩展程序即使没有 WebMCP,也可通过运行自定义 JavaScript 操作网页。
设置字符数上限以优化性能
为避免触发智能体防护机制并提升处理效率,建议编写简洁的工具描述和输出。参考以下字符数限制:
- 单个工具描述:不超过 500 个字符
- 单个参数描述:最多 150 个字符
- 单个工具名称和参数名称:最多 30 个字符
- 单个工具输出:上限为 1,500 个字符
不同智能体可能存在差异,建议根据实际用户反馈灵活配置。未来 API 规范可能会添加具体的字符数限制。
后续步骤与展望
业界正持续致力于构建安全的智能体 Web 基础设施。目前,各方正针对跨主体的授权同意管理展开探讨,标准规范草案中也包含了 requestUserInteraction(),以便在工具执行过程中异步请求用户输入。
如果您正在构建智能体,建议进一步阅读 WebMCP 智能体安全注意事项以获取更深入的技术指导。

