基本原则
插件工具可以访问用户数据、调用第三方 API 并执行写入操作。请按生产软件的标准对待每个 MCP 服务器和 UI 组件。
- 最小权限: 仅申请必要的授权范围、存储访问权限和网络权限。
- 用户明确同意: 关联账户或授予写入权限时,确保用户清楚自己正在执行的操作。对于破坏性操作,请使用主机提供的确认提示。
- 纵深防御: 假设您的服务器会遇到提示词注入攻击,也会收到恶意输入。检查每一项输入,并保留审计日志。
数据处理
- 结构化内容: 仅包含当前提示词所需的数据。避免在组件属性中嵌入密钥或令牌。
- 存储: 确定用户数据的保留期限,并公布数据保留政策。按用户请求删除数据。
- 日志记录: 写入日志前,先对个人身份信息(PII)进行脱敏。保留关联 ID 以便调试。除非确有必要,否则请避免存储提示词原文。
输入模式与任务上下文
-
设计输入模式时,应默认限制数据收集范围,避免通过可选字段收集额外的上下文。
-
输入字段必须与工具声明的用途直接相关。
-
请勿以“以备不时之需”为由请求完整的对话历史、原始聊天记录或涵盖范围过广的上下文字段。工具可以请求用户通过一个简短的字段说明其针对当前任务的意图,但必须同时满足两个条件:该字段能切实改善任务执行效果,且收集的数据不超出响应用户请求和实现隐私政策所述目的所合理需要的范围。
-
请勿请求累积的对话上下文,也不要请求包含先前对话轮次的数组。
响应载荷
工具响应只能返回与用户请求和工具声明的用途都直接相关的数据。除非满足用户查询确实需要,否则请勿包含诊断信息、遥测数据或内部标识符,例如会话 ID、追踪 ID、请求 ID、时间戳或日志元数据。
聊天上下文的边界
MCP 服务器不得从客户端或其他来源拉取完整的聊天记录,也不得利用这些来源的数据重建或推断完整记录。仅处理客户端或模型明确选择发送的片段和资源。划清这一边界有助于防止暗中扩大数据收集范围,并将分析限制在主动共享的内容之内。
位置信息
如需位置信息,请使用系统共享的大致地理位置。请勿请求用户的精确位置数据,例如 GPS 坐标或地址。
避免在输入模式中请求城市、坐标等原始位置字段。需要位置信息时,请通过客户端控制的独立渠道获取,例如环境元数据或引用的资源,以便应用相应的策略和用户同意机制。这样可以减少意外收集个人身份信息的情况,落实最小权限原则,并确保位置信息的处理过程可审计、访问权限可撤销。
提示词注入与写入操作
自定义 MCP 服务器提供完整的 MCP 访问权限,包括使用写入工具的权限。请采取以下措施降低风险:
- 定期审查工具描述,明确使用限制以减少误用,例如“请勿使用此工具删除记录”。
- 在服务器端验证所有输入,即使输入由模型提供也要验证。
- 对于不可逆操作,要求人工确认。
将测试提示词注入时最有效的提示词分享给质量保证团队,以便他们尽早发现薄弱环节。
网络访问
小组件在隔离的 iframe 中运行,并受严格的内容安全策略(CSP)约束。小组件无法访问 window.alert、window.prompt、window.confirm 或 navigator.clipboard 等特权浏览器 API。CSP 控制标准 fetch 请求。默认情况下,无法使用嵌套框架。要启用嵌套框架,请在资源的 CSP 元数据(如 _meta.ui.csp.frameDomains)中指定允许的源。插件可以嵌入其 MCP 服务器所属可注册域名下的页面,包括现有的编辑器和管理界面。有关域名所有权、需要说明的理由和审核要求,请参阅 iframe 要求。
小组件的 CSP 限制 iframe 可以加载哪些目标页面。嵌入页面使用自身的 CSP,小组件的 connectDomains 和 resourceDomains 允许列表不会限制该页面内部发起的网络请求。请明确指定允许的 iframe 源,并将嵌入页面及其功能纳入安全审查。
服务器端代码仅受托管环境施加的网络限制。对于出站请求,请遵循常规最佳实践,包括执行 TLS 验证、配置重试和设置超时。
身份验证与授权
- 集成外部账户时,请使用 OAuth 2.1 授权码流程。如果您的授权服务器支持客户端 ID 元数据文档(CIMD),且插件开发者选择了 CIMD,请优先使用这种方式。公共客户端交换令牌时,请使用
none。如果您的授权服务器要求验证客户端身份,请使用private_key_jwt。如果插件开发者选择动态客户端注册(DCR),或 CIMD 不可用,请支持 DCR。 - 每次调用工具时,都要核验授权范围并执行相应的访问限制。对于已过期或格式错误的令牌,返回
401响应。 - 使用内置身份机制时,请使用系统提供的身份验证上下文,避免存储长期有效的密钥。
上线与运维准备
- 上线前进行安全审查,尤其是在您处理受监管数据的情况下。
- 监控异常流量模式,并针对反复出现的错误或失败的身份验证尝试设置告警。
- 及时为第三方依赖项、库和构建工具安装补丁,以降低供应链风险。
安全与隐私是用户信任的基础。请从规划阶段就考虑这两方面,并将相关措施贯穿实现和部署流程,避免事后才补救。