OpenAI Apps SDK
使用 MCP 工具和可选 UI 组件构建可在 ChatGPT 中运行的应用框架与交付模型。
#type / resource
#status / growing
#tech / ai
#resource / openai
#interface / api
OpenAI Apps SDK
产品定位
Apps SDK 用于构建能在 ChatGPT 会话中被发现和调用的应用。应用通常以 MCP server 暴露工具,并可返回结构化内容或配套 UI 组件。ChatGPT 负责对话、工具选择和展示,开发者服务负责权限、业务逻辑与数据访问。
三层结构
- 工具层:定义名称、描述、输入 schema、注解与结构化输出。
- 资源/UI 层:按需要提供组件资源,让结果不局限于纯文本。
- 宿主桥接层:ChatGPT 把工具结果、组件状态和用户交互连接起来。
与 ChatGPT 自定义 App 的关系
Apps SDK 是开发框架;ChatGPT 工作区中的自定义 App 是部署和治理入口。一个 App 能否被成员使用,还取决于工作区套餐、管理员策略、发布状态、OAuth/认证配置以及工具审批设置。
chatgpt-apps-skills-and-workspace-agents 中的 App、Skill、Workspace Agent 分工依然成立:App 提供能力,Skill 提供工作方法,Agent 把两者组装成面向用户的执行入口。
安全与交付检查
- 工具名称与描述应让模型能正确选择,不能用提示词掩盖危险副作用。
- 对写入、删除、发送、支付等动作设置明确确认和服务端授权。
- 不把敏感凭据放入组件参数、模型上下文或客户端 bundle。
- 返回最少必要数据,对第三方内容视为不可信输入。
- 在发布前测试工具发现、认证失败、超时、重复调用和用户取消。
何时使用本地 Tunnel
开发或个人本地服务可通过 openai-secure-mcp-tunnel 连接 ChatGPT,而无需把 MCP server 公开部署。它解决网络可达性与授权关联,不替代应用本身的审批、路径限制和审计。
相关笔记
- chatgpt-apps-skills-and-workspace-agents
- openai-api-tools-mcp-and-hosted-tools
- mcp
- connect-local-mcp-to-chatgpt-with-secure-tunnel