用户正在解决什么问题

OpenAI 的开发文档和面向用户的产品文档关注点不同。如果把 Skill 当作界面、把 App 当成插件的同义词，安装、授权、开发和排障都会失去准确路径。

适合哪些用户

适用于首次对接 OpenAI 生态时需要统一技术口径的用户，尤其是实施、PM、支持及技术负责人团队。

核心结论

开发者视角里，Plugin 更接近“可发现与安装的分发单元”；用户侧文档常看到 Connector、App 这类产品入口；底层通常由 MCP server 提供工具与能力。三者不应直接堆成单一构成树，而应按产品入口、管理控制和实现层分开理解。

判断流程与操作步骤

  1. 先判断正在阅读的是用户产品说明、管理员控制说明，还是开发者打包文档
  2. 需要复用任务方法、指令和资源时看 Skill；需要实时数据、认证或受控工具时看 MCP server
  3. 看到 App 或 Connector 时，继续核对它连接的外部服务、可用动作、MCP 支撑与源系统授权
  4. 只在用户确实需要查看、比较、编辑或确认结构化信息时考虑可选 UI
  5. 最后分别验证插件已安装、连接已建立、源系统对象有权限、目标动作确实可执行
开发者分发层：Plugin（可被发现、安装并纳入分发目录的发行单元）
Skill：可复用的指令与资源定义
  • 包含 SKILL.md
  • 可附带脚本、参考资料、模板或资源
  • 可独立交付，也可与 MCP server 协作
MCP / MCP server：按协议提供结构化能力的服务端
  • 可提供工具、资源、提示和指令
  • 负责实时数据、认证或受控动作等能力
  • 可选提供 UI，并非默认必需
产品体验层：App / Connector（连接外部服务的数据、动作与可选界面）

同一个产品能力可以从用户界面被称为 App / Connector，同时在开发实现上由 MCP server 支撑；两种说法描述的是不同视角。

开发者补充：.app.json 是指向已注册 MCP server 连接的兼容映射；.mcp.json 用于 MCP server 配置。它们不是普通用户判断“能不能用”的第一步。

权限、限制和容易踩坑的地方

不要把产品名称、管理员控制名词和开发打包构件强行放在同一层比较。Plugin 包含什么、当前入口显示什么、源系统允许什么是三件事；产品术语还会随版本更新。

如何验证最终结果

拿一个真实条目分别写出：插件包中的 Skill / MCP 组成、用户看到的 App / Connector 入口、连接身份、源系统可见对象、允许动作和是否有 UI。六项都能落到具体官方页面或实际控制面，才算概念对齐。

参考来源

最后核验日期：2026-07-30