关于 MCPlet 的常见问题

什么是 MCPlet？

MCPlet 是构建在 Model Context Protocol 和 MCP Apps 之上的代码优先约定配置文件。它把业务逻辑封装为受约束、单一意图的能力单元，并为 AI 操作提供明确的可见性、认证和安全边界。

MCPlet 与 MCP 和 MCP Apps 有什么不同？

MCP 定义工具与资源的协议。MCP Apps 定义宿主如何渲染和协同 UI。MCPlet 位于两者之上，作为约定配置文件增加了意图建模、工具分类、可见性规则、认证要求以及由宿主管理的安全边界。

MCPlet 的三种类型是什么？

MCPlet 将工具分为 read、prepare 和 action。read 无副作用，适合自主调用。prepare 用于提交前的信息收集或校验。action 会产生不可逆副作用，因此需要更强的确认与强制机制。

MCPlet 是代码优先还是基于 YAML？

主配置文件是代码优先的。MCPlet 元数据在工具注册时声明，例如 _meta.mcpletType、_meta.visibility、_meta.auth 和 _meta.ui。

mcplet.yaml 仍可用于向后兼容默认值，但当代码元数据存在时，它不再是唯一事实来源。

MCPlet 如何使用 Passkey 认证？

受保护的 MCPlet 会在 _meta.auth 中声明认证要求。对于模型可见的 action 工具，宿主会拦截调用，在浏览器上下文中获取 Passkey 断言，在业务参数之外注入验证材料，并由 MCPlet 后端在执行动作前完成校验。

MCPlet 支持哪些宿主配置？

MCPlet 当前定义两种宿主实现配置。WebUI Profile 面向渲染 MCP Apps 的 MCP 客户端或代理外壳。Agent Profile 面向由专用代理和外部配置 LLM 组成的编排系统，不要求通用 UI 层。

如何开始使用 MCPlet？

先选择宿主配置，再把每个工具分类为 read、prepare 或 action，在 _meta 中注册代码优先元数据，公开结果 schema，并为受保护的模型可见 action 添加 Passkey 强制。

如果想走最短路径，先阅读 快速开始指南，然后再对照完整规范核实细节。

规范性草案在哪里？

可被索引的 HTML 概览位于 /spec/，但规范性草案原文是位于 /files/MCPlet-spec-v202603-03.md 的 markdown 文件。专利与许可声明则单独发布在 /patent-notice.html。

谁在维护 MCPlet 草案？

本站公开草案目前由 MCPlet Working Group 维护。就审阅和归档而言，规范性正本仍然是站点发布的原始 markdown 草案。