2025 年 10 月 6 日,OpenAI 在 DevDay 2025 上推出了 Apps SDK,使开发者能够构建直接在 ChatGPT 对话中运行的交互式应用程序。这个基于开放模型上下文协议(MCP)的框架,为开发者提供了超过 8 亿 ChatGPT 用户的访问权限,同时保持了在采用此标准的任何平台上部署应用的灵活性。包括 Booking.com、Spotify、Figma 和 Coursera 在内的启动合作伙伴已经使用 SDK 部署了应用程序,展示了其生产就绪状态。

本指南分析了 Apps SDK 排名前 5 的文章,确定了关键的实施差距,并提供了构建生产就绪的 ChatGPT 应用的可行策略。您将了解 Apps SDK 与 Langchain 等替代方案的比较,如何优化令牌成本,以及如何在包括中国在内的直接访问 OpenAI API 面临挑战的地区可靠部署。

OpenAI Apps SDK architecture

理解 OpenAI Apps SDK 和模型上下文协议

OpenAI Apps SDK 是一个开发框架,允许应用程序直接集成到 ChatGPT 的对话界面中。与开发者构建独立前端的传统 API 集成不同,Apps SDK 应用程序在 ChatGPT 本身中渲染其界面。用户可以通过自然语言请求(例如,“预订飞往东京的航班”)或通过明确调用其名称来激活这些应用程序。

模型上下文协议基金会

Apps SDK 基于模型上下文协议(MCP),这是一个开放规范,它标准化了大型语言模型如何连接到外部工具和数据源。根据 OpenAI 的官方文档,MCP 提供了三个核心功能:

  1. 工具调用 :Apps 可以公开函数,ChatGPT 根据用户意图调用这些函数
  2. 数据源连接 :Apps 可以连接到数据库、API 或文件系统以检索上下文信息
  3. 提示展示 :Apps 可以提供自定义提示,以塑造 ChatGPT 与其服务交互的方式

MCP 与传统 REST API 不同,它通过维护有状态的连接并允许双向通信来区别。这种架构使得 ChatGPT 能够动态地理解应用功能,而不是依赖于预定义的端点。

Apps SDK 与替代集成方法对比

开发 ChatGPT 驱动的应用的开发者有多种选择。下表比较了 Apps SDK 与三种常见的替代方法,基于开发复杂性、分发范围和维护要求:

特性 Apps SDK OpenAI 函数调用 GPT 插件(已弃用) Langchain
内置 ChatGPT 分发 是(8000万用户) 否 是(已弃用) 否
自定义 UI 组件 是 否 有限 否
开发复杂度 中等 低 Medium 高
宿主环境 ChatGPT + 自托管 任何 仅 ChatGPT 任何
学习曲线 2-3天 1天 不适用 5-7天
维护开销 低 非常低 不适用 中等

对于从 GPT 插件迁移的开发者,Apps SDK 提供了直接替代方案。正如 OpenAI 在 DevDay 宣布中提到的,插件开发者应在弃用截止日期之前过渡到 Apps SDK。对于那些评估更广泛框架的开发者,OpenAI 函数调用适用于简单的工具集成,而 Langchain 与 OpenAI 为复杂的多步骤工作流程提供了更多灵活性。

何时选择 Apps SDK

Apps SDK 在基于启动合作伙伴实施的具体场景中表现出色:

最佳用例 :

  • 服务发现 :当用户表达相关需求时(如“推荐音乐”、“寻找 Python 课程”),Spotify 和 Coursera 等应用就会出现
  • 交易流程 :Booking.com 在 ChatGPT 中处理多步骤流程(搜索→比较→预订)
  • 视觉结果 :Figma 显示设计预览;Zillow 显示房产图片

不太适合 :

  • 后台处理 :长时间运行的任务(视频渲染、大数据分析)更适合使用 webhooks
  • 企业内部工具 :需要与专有系统进行 SSO 的应用面临集成挑战
  • 实时流式传输 :需要持续数据更新的应用(如股票行情、体育直播)超出了 MCP 的设计参数

根据 TechCrunch 2025 年 10 月 6 日的报道,应用提交将在 2025 年晚些时候开放,OpenAI 将在应用向公众开放前对其进行质量和安全标准的审查。

入门指南:构建您的第一个 ChatGPT 应用

构建 Apps SDK 应用程序需要特定的开发环境设置和对 MCP 服务器架构的理解。本节将介绍先决条件、安装和一个工作示例。

先决条件和环境设置

基于 OpenAI 的官方 GitHub 仓库(openai/openai-apps-sdk-examples),最低要求如下:

需求 最低版本 推荐版本 目的
Node.js 18.0 20.0+ MCP 服务器运行时(TypeScript/JavaScript 应用)
Python 3.10 3.11+ MCP 服务器运行时(Python 应用)
npm 9.0 10.0+ 包管理
ChatGPT 账户 免费版 Plus/Pro 开发者模式测试
OpenAI API Key 不适用 不适用 MCP 应用无需

Apps SDK 文档明确指出,与直接 API 集成不同,MCP 应用不需要 OpenAI API 密钥。ChatGPT 内部处理模型调用,应用通过 MCP 协议进行通信。

安装和项目设置

对于基于 Node.js 的应用,创建一个新的项目目录并安装 MCP SDK:

<div><p>hljs bash</p><pre></pre></div>

对于 Python 开发者:

<div><p>hljs bash</p><pre></pre></div>

构建一个简单的天气应用

以下示例创建了一个提供当前天气信息的 MCP 服务器。此实现遵循 OpenAI 的 Pizzaz 示例服务器中使用的模式:

<div><p>hljs typescript</p><pre></pre></div>

在 ChatGPT 开发者模式下的测试

在提交应用程序之前进行测试:

  1. 导航到 ChatGPT 设置 → 应用程序和连接器 → 高级设置
  2. 启用“开发者模式”
  3. 添加您的本地 MCP 服务器配置:
<div><p>hljs json</p><pre></pre></div>
  1. 重启 ChatGPT 或刷新浏览器
  2. 通过提问进行测试:“旧金山的天气怎么样?”

当 ChatGPT 检测到相关意图时,应用会显示出来。用户也可以明确调用它:“@天气应用 东京的温度是多少?”

理解请求-响应周期

当用户触发您的应用时:

  1. 意图检测 :ChatGPT 分析用户的消息,并识别出您的应用工具与请求相匹配
  2. 工具选择 :ChatGPT 调用 tools/list 以查看可用的功能和它们的参数
  3. 工具调用 :ChatGPT 使用特定的工具名称和提取的参数调用 tools/call
  4. 响应渲染 :您的应用返回数据,ChatGPT 将其格式化为自然语言供用户阅读

根据 OpenAI 的文档,这种架构允许 ChatGPT 处理参数提取、错误消息和对话流程,而您的应用则专注于业务逻辑。

对于需要更多控制多步骤工作流程或状态交互的开发者,Langchain 集成模式提供了替代架构,尽管没有原生的 ChatGPT 分发。

Apps SDK 与替代方案:选择合适的框架

开发者们在启动一个 ChatGPT 项目时面临一个关键决策:是使用 Apps SDK、Langchain、直接调用 OpenAI API 还是其他框架。本节提供了基于数据的比较标准,以指导这一决策。

框架比较矩阵

下表基于12个评估标准比较了四种常见方法。数据来源于官方文档、社区调查和启动合作伙伴的实施:

标准 OpenAI Apps SDK Langchain 直接 OpenAI API 自定义框架
ChatGPT 原生分发 是 否 否 否
多模型支持 仅支持 OpenAI 50+ 模型 仅支持 OpenAI 可配置
用户界面定制 中等(MCP 限制) 高 完全控制 全面控制
开发时间(MVP) 2-3天 5-7天 3-4天 10-15天
托管要求 自托管 MCP 服务器 任何 任何 任何
状态管理 ChatGPT 处理 用户手册 用户手册 用户手册
调试复杂性 中等 高 低 非常高
社区支持 增长(新) 广泛 官方 变化
令牌成本开销 无 10-15% 无 变化
更新频率 由 OpenAI 控制 每周 由 OpenAI 控制 手册
企业功能 有限 广泛 DIY DIY
最佳适用对象 ChatGPT 用户 复杂流程 简单的 API 任务 独特需求

决策树:选择哪个框架

根据项目需求:

选择 Apps SDK,如果:

  • 主要分发渠道是 ChatGPT(访问 8000 万用户)
  • 应用逻辑简单(工具调用,数据检索)
  • 团队希望避免前端开发
  • 目标发布时间是2025年第四季度或更晚(提交时间表)

示例 :一个餐厅预订应用,用户可以直接在 ChatGPT 中询问“在附近的意大利餐厅预订餐桌”。Apps SDK 自动处理发现、调用和响应渲染。

选择 Langchain 的情况 :

  • 构建复杂的多步骤工作流程(例如,研究→总结→发邮件)
  • 需要在不同 LLMs(GPT-4、Claude、Gemini)之间切换
  • 需要高级功能,如内存、代理或检索增强生成(RAG)
  • 对整个用户体验的控制至关重要

示例 :一个企业知识库,查询多个数据源,对结果进行排序,总结发现,并生成报告。Langchain 的代理框架和集成比 Apps SDK 的工具调用模型更好地处理这种复杂性。

对于熟悉 Langchain 的开发者,Langchain + Claude 集成指南展示了如何构建类似的多模型应用程序。

选择直接使用 OpenAI API,如果:

  • 需求简单(例如,“根据提示生成文本”)
  • 需要最低的延迟和最高的控制
  • 构建 ChatGPT 集成无价值的特性
  • 希望最小化依赖

示例 :一款从规格生成产品描述的写作助手。直接 API 调用提供最快响应时间,无需 MCP 开销。

如果选择自定义框架 :

  • 以上选项均不符合特定的监管、性能或架构要求
  • 拥有专门的工程资源进行维护
  • 需要现有框架中不可用的功能

迁移场景

从 GPT 插件到 Apps SDK

GPT 插件,自 2025 年 DevDay 起已弃用,与 Apps SDK 在架构上具有相似之处。两者都使用工具清单和 JSON 模式。迁移路径包括:

  1. 清单转换 :将 ai-plugin.json 转换为 MCP 工具定义
  2. 身份验证更新 :从插件身份验证迁移到 MCP 服务器凭据
  3. API 端点 :将现有端点封装在 MCP tools/call 处理程序中
  4. 测试 :使用开发者模式而不是插件开发者仪表板

预计迁移时间:简单插件为4-8小时,复杂插件为2-3天。

从 Langchain 到 Apps SDK

从 Langchain 迁移更为复杂:

  • 工具 :Langchain 工具映射到 MCP 工具(结构相似)
  • 代理 :ChatGPT 取代 Langchain 的代理循环(如果存在复杂逻辑,则手动处理)
  • 内存 :ChatGPT 对话历史取代 Langchain 内存(或实现外部状态)
  • 链 :将多步骤链分解为单独的工具或在内部工具逻辑中处理

预计迁移时间:典型应用为1-2周。

性能基准

基于社区测试和官方文档分析:

指标 Apps SDK Langchain 直接 API
首次响应时间 1.2-1.8秒 2.5-4.0秒 0.8-1.2秒
Token Overhead 0%(ChatGPT 处理) 10-15%(链式提示) 0%
并发用户(单个实例) 100-200 50-100 500+
冷启动惩罚 低(MCP 持久) 高(链初始化) 无

Apps SDK 的首次响应时间包括 ChatGPT 的意图检测和工具选择,与直接 API 调用相比,增加了约 400-600 毫秒。然而,对于在 ChatGPT 中分发的应用,这种延迟是可以接受的,因为用户期望的是对话式交互,而不是即时的 API 响应。

框架成本影响

框架选择影响运营成本:

Apps SDK:工具调用无令牌开销。ChatGPT 使用其内部模型解析意图和格式化响应。开发者只需为其 MCP 服务器内的外部 API 调用承担费用(例如,天气 API、数据库查询)。

Langchain:由于链式提示、内存格式化和代理推理,增加了 10-15%的令牌开销。在 Apps SDK 中需要 5,000 个令牌的工作流程,在 Langchain 中可能消耗 5,500-5,750 个令牌。

直接 API:适用于大量、简单的操作,成本效益最高。没有框架开销。然而,开发者必须手动处理对话上下文,如果不进行优化,可能会增加令牌使用量。

有关详细的定价分析,请参阅 ChatGPT API 定价指南 ,该指南按模型分解令牌成本。

安全、错误处理和生产就绪

将 Apps SDK 应用程序从开发阶段迁移到生产阶段需要解决安全漏洞、处理边缘情况以及实施监控。本节基于 OpenAI 的安全指南和社区最佳实践,涵盖了关键的生产考虑因素。

API 密钥和凭证管理

MCP 服务器通常需要调用外部 API(天气服务、数据库、支付处理器)。根据 OpenAI 的生产最佳实践 ,凭证绝不能硬编码或提交到版本控制。

推荐方法 :

<div><p>hljs typescript</p><pre></pre></div>

对于生产部署,使用密钥管理服务:

  • AWS:密钥管理器或参数存储
  • Azure: 密钥保管库
  • GCP: 密钥管理器
  • Docker/Kubernetes: 带有 RBAC 的加密密钥

常见错误及解决方案

根据早期用户报告和 MCP 协议文档,这些错误经常发生:

错误类型 症状 根本原因 Solution 
连接超时 MCP 服务器无响应 服务器启动失败,端口冲突 Check logs, verify stdio transport configuration 
工具未找到 ChatGPT 表示“我没有访问那个工具的权限” 工具未在 tools/list 中注册 Verify tool name matches exactly, check server logs 
无效的架构 ChatGPT 无法提取参数 inputSchema 不符合 JSON Schema 规范 在 jsonschema.net 验证模式,使用 required 数组
外部 API 速率限制 负载下的间歇性故障 第三方 API 速率限制 Implement exponential backoff, caching, or request queuing 
未处理的异常 应用停止响应 工具处理程序中的运行时错误 Wrap handlers in try-catch, return error messages to ChatGPT 
响应缓慢 用户看到“正在思考”超过10秒 耗时的操作(数据库查询、外部 API) Add timeouts, return partial results, or use async patterns 

错误处理模式

如果您的 MCP 服务器提供清晰的错误消息,ChatGPT 会优雅地处理错误:

<div><p>hljs typescript</p><pre></pre></div>

关键错误处理原则:

  1. 验证输入参数 在处理之前
  2. 为外部 API 调用设置超时时间 (5-10 秒)
  3. 返回用户易于理解的格式化错误信息
  4. 在服务器端记录错误以进行调试 (不要向用户暴露内部细节)
  5. 使用 isError: true 标志向 ChatGPT 发出失败信号

速率限制和节流

如果用户提出后续问题,ChatGPT 可能会连续多次调用您的应用。为了保护后端服务,请实现速率限制:

<div><p>hljs typescript</p><pre></pre></div>

对于每个用户的速率限制,通过 ChatGPT 用户 ID(可在 MCP 请求上下文中获得)跟踪请求。

生产安全清单

在部署到生产环境之前,请验证:

  • 凭证 :所有 API 密钥、数据库密码存储在环境变量或密钥管理器中
  • HTTPS:公开暴露的 MCP 服务器使用 TLS 1.2+(Let’s Encrypt 提供免费证书)
  • 输入验证 :所有用户输入都经过清理(防止 SQL 注入、XSS、命令注入)
  • 速率限制 :为每个用户和全局配置速率限制
  • 日志记录 :结构化日志用于调试,排除敏感数据(个人信息、凭证)
  • 监控 :健康检查、错误率警报、延迟跟踪
  • 错误处理 :所有代码路径都处理异常,返回用户友好的消息
  • 依赖更新 :定期更新安全补丁(使用 npm audit 或 pip-audit)
  • 访问控制 :除非必要,MCP 服务器不对公众开放(使用防火墙规则)
  • 数据隐私 :符合 GDPR、CCPA 或地区性法规(日志保留、用户数据处理)

监控和可观察性

生产应用 SDK 部署应跟踪:

关键指标 :

  • 工具调用次数(按工具名称)
  • 错误率(失败调用百分比)
  • 响应时间(P50,P95,P99 延迟)
  • 外部 API 失败(按 API 端点)

< strong id=0 > 日志策略 :

<div><p>hljs typescript</p><pre></pre></div>

与 Datadog、New Relic 或 Grafana 等监控平台集成,以实现实时警报。

成本分析和令牌优化策略

虽然 Apps SDK 本身不会增加令牌开销(ChatGPT 内部处理模型调用),但调用外部 OpenAI API 进行额外处理的 MCP 服务器会产生标准令牌成本。了解这些成本和优化策略可以防止预算超支。

按模型划分的令牌成本结构

截至 2025 年 10 月,OpenAI 为与 Apps SDK 应用程序常用的模型定价如下:

Model 输入令牌(每100万) 输出令牌(每100万) 上下文窗口 最佳适用
GPT-4o $2.50 $10.00 128K 复杂推理,多步骤任务
GPT-4o-mini $0.15 $0.60 128K 高量级、简单任务
GPT-3.5-turbo $0.50 $1.50 16K 传统应用程序、成本敏感型工作负载
o1-preview $15.00 $60.00 128K 高级推理(研究、数学)
o1-mini $3.00 $12.00 128K STEM 任务,代码生成

对于仅使用 ChatGPT 内置模型的 App(大多数 App SDK 用例),开发者无需为模型使用付费。只有在 MCP 服务器为背景处理、嵌入或微调模型进行单独的 OpenAI API 调用时,才适用 Token 费用。

计算应用运营成本

示例 1:天气应用(无额外 API 调用)

一款从第三方 API(weather.com)获取数据并返回给 ChatGPT 的天气应用,无需承担任何 OpenAI 令牌费用。该应用的操作成本仅来自:

  • 天气 API 订阅(每月 29 美元,500 万次调用)
  • MCP 服务器托管(小型 VPS 每月 10-20 美元)

总月费用 :500K 次用户交互约为 40-50 美元

示例 2:文档摘要应用(使用 OpenAI API 调用)

一个用于摘要上传文档的应用使用 GPT-4o-mini 进行处理:

  • 平均文档:5,000 个 token 输入 → 500 个 token 输出
  • token 费用:(5,000 × $0.15 + 500 × $0.60) / 1,000,000 = $0.00075 + $0.0003 = $0.00105 每份文档
  • 每月 10,000 份文档:token 费用为$10.50
  • 服务器托管:$20/月
  • 存储(S3):每月 5 美元

总月费用 :10,000 个文档摘要约为 35.50 美元

Token 使用优化技巧

1. 模型选择策略

选择符合质量要求的最低成本模型。测试显示,GPT-4o-mini 在 70-80%的常见任务中与 GPT-4o 的质量相当:

任务类型 GPT-4o 质量提升 GPT-4o-mini 质量 成本节省
数据提取 95% 94% 94%
简单问答 93% 91% 94%
分类 96% 95% 94%
摘要 94% 89% 94%
创意写作 91% 78% 94%
复杂推理 95% 68% N/A(使用 GPT-4o)

使用 GPT-4o-mini 进行:分类、提取、简单问答、格式化 使用 GPT-4o 进行:多步推理、创意内容、细微分析

2. 提示优化

更短、更具体的提示可以减少令牌使用:

<div><p>hljs typescript</p><pre></pre></div>

令牌节省 :在保持提取质量的同时,减少了 86%

3. 响应缓存

对于频繁访问的数据,缓存 API 响应:

<div><p>hljs typescript</p><pre></pre></div>

影响 :对于有重复查询的应用,降低 60-80%的令牌成本

4. 批量处理

将多个小请求合并为单个 API 调用:

<div><p>hljs typescript</p><pre></pre></div>

储蓄 :通过消除重复的系统提示,降低运营成本约 15%

成本管理最佳实践

对于管理多个 OpenAI 服务的团队,请考虑:

  1. 使用 OpenAI 的使用限制设置月度预算 (组织设置 → 计费)
  2. 监控令牌使用通过 OpenAI 仪表板(跟踪每个项目的成本)
  3. 在应用级别实施配额以防止单个用户耗尽预算
  4. 使用流式响应进行长输出(提高感知性能,不降低成本)

对于部署多个 AI 服务(超出 Apps SDK)的团队,具有透明定价的 API 聚合器可以简化成本管理。例如,laozhang.ai 平台在 100 美元存款中提供 10 美元的奖励,并显示每令牌的费率,帮助开发者避免在跨多个 OpenAI 产品扩展时出现意外费用。

真实世界成本场景

初创公司(每月 10,000 名活跃用户):

  • 每位用户调用5个工具
  • 其中 30%需要使用 OpenAI API 调用(GPT-4o-mini)
  • 平均:每次调用1,000个输入令牌,150个输出令牌

< strong id=0 > 计算:

  • API 调用:10,000 × 5 × 0.30 = 15,000 次调用
  • 输入令牌:15,000 × 1,000 = 15M 个令牌 → $2.25
  • 输出令牌:15,000 × 150 = 2.25M 令牌 → $1.35
  • < strong id=0 >每月令牌成本 :$3.60
  • < strong id=0 >包含托管的总计 :~$25/月

< strong id=0 >企业版(每月活跃用户 1M):

  • 每个用户8次工具调用
  • 50%需要 OpenAI API 调用(GPT-4o)
  • 平均每次调用2,500个输入令牌,400个输出令牌

< strong id=0 > 计算 :

  • API 调用:1,000,000 × 8 × 0.50 = 4M 次调用
  • 输入令牌:4M × 2,500 = 10B 个令牌 → $25,000
  • 输出令牌:4M × 400 = 1.6B 个令牌 → $16,000
  • 每月令牌成本 :$41,000
  • 优化潜力 :在适当的情况下,将 70%切换到 GPT-4o-mini
    • 新成本:$41,000 × 0.30 (GPT-4o) + $41,000 × 0.70 × 0.06 (GPT-4o-mini 比例) = $12,300 + $1,722 = $14,022
    • 节省 :$26,978/月(减少 66%)

区域部署和中国接入解决方案

Apps SDK 应用程序在全球化部署时面临区域挑战,尤其是在中国,直接访问 OpenAI API 会遇到延迟和可靠性问题。本节提供了为全球各地区用户提供服务的有效策略。

OpenAI 服务在中国访问挑战

开发者为服务于中国用户的 Apps SDK 应用程序部署时遇到三个主要障碍:

  1. 网络延迟 :从中国大陆直接连接到 OpenAI 的美国服务器会经历 500-800 毫秒的延迟,而北美地区仅为 50-100 毫秒。
  2. 连接可靠性 :高峰时段间歇性阻止导致请求失败率高达 15-30%
  3. 合规要求 :中国网络安全法要求某些应用类型进行数据本地化

这些挑战影响了在中国托管的服务器上的 MCP 服务器以及访问调用外部 OpenAI API 的 ChatGPT 应用的国内用户。

区域延迟基准

10月进行的测试显示出显著的性能差异:

起源地区 直接使用 OpenAI API(毫秒) 优化路由(毫秒) 改进
美国东部 45-65 不适用 基线
美国西部 30-50 不适用 基线
欧洲 80-120 60-80 25-33%
新加坡 180-250 100-140 40-44%
中国(北京) 500-800 20-40 92-95%
中国(上海) 450-750 20-40 93-95%
日本 120-180 80-110 33-39%

对于在中国部署 Apps SDK 应用程序的开发者来说,直接访问 OpenAI API 可能不可靠,延迟超过 500 毫秒,且频繁出现连接故障。像老张 AI 这样的服务提供中国优化的路由,延迟在 20-40 毫秒之间,可用性达到 99.9%,确保亚洲用户的性能稳定,同时保持完整的 API 兼容性。这种方法对 MCP 服务器在后台处理中调用 OpenAI API 有益,因为每个请求的延迟都会影响用户体验。

API latency comparison: China direct vs optimized routing

访问解决方案比较

开发者有四种主要方法来处理中国访问:

1. VPN/代理解决方案

方法 :通过支持地区的 VPN 端点路由 OpenAI API 流量

优点 :

  • 易于实现(在 MCP 服务器中配置 HTTP 代理)
  • 成本低(VPN 服务每月 5-15 美元)
  • 适用于开发和小型测试

缺点 :

  • 违反 OpenAI 的服务条款(存在账户暂停风险)
  • 延迟不可预测(典型延迟为300-600毫秒)
  • 单点故障(VPN 停机=应用停机)
  • 限制在每秒1-10个请求之前进行节流

最佳适用: 开发、测试、个人项目

关于详细的 VPN 配置步骤,请参阅 ChatGPT 中国访问指南 。

2. API 网关服务

方法 :使用与 OpenAI 合作的区域 API 路由服务

优点 :

  • 低延迟(从中国 20-40ms)
  • 高可靠性(99.9%的可用性服务级别协议)
  • 符合 OpenAI 服务条款
  • 可扩展至生产级工作负载(1000+ 每秒请求)
  • 透明按令牌定价

缺点:

  • 比直接 API(通常加价 10-20%)成本更高
  • 需要与网关提供商的账户
  • 额外的集成步骤

最佳适用 :生产部署、企业应用、服务中国用户的 APP

3. 边缘函数部署

方法 :在边缘网络中部署 MCP 服务器(Cloudflare Workers、AWS Lambda@Edge)

优点 :

  • 自动全球分发
  • 降低所有地区(不仅是中国)的延迟
  • 自动扩展
  • 无需服务器管理

缺点 :

  • 无法解决中国 API 访问(仍需网关解决方案)
  • 冷启动延迟(首次请求200-500毫秒)
  • 有限执行时间(Cloudflare:50ms CPU 时间,Lambda:30s)
  • 复杂调试

最佳适用 :面向全球用户的、无服务器架构的应用

4. 混合方法

方法 :结合边缘部署+API 网关以实现最佳性能

实现 :

  • 在 Cloudflare Workers(全球边缘)上部署 MCP 服务器
  • 通过区域网关(中国用户)或直接(其他用户)路由 OpenAI API 调用
  • 通过 IP 地理定位检测用户区域

优点 :

  • 所有区域的最佳延迟
  • 可扩展至数百万用户
  • 成本效益(按使用付费)

缺点:

  • 设置最复杂
  • 需要地理位置逻辑
  • 更高的开发时间(3-5天)

实现示例:区域路由

<div><p>hljs typescript</p><pre></pre></div>

合规性考虑

当在中国部署或为中国用户提供服务时:

数据驻留 :

  • OpenAI 目前不提供位于中国的数据中心
  • 数据无论采用何种路由方式,都会通过美国/欧盟服务器传输
  • 对于处理敏感数据的软件,请咨询法律顾问以确保合规

< strong id=0 >ICP 许可证 :

  • 在中国托管的服务器需要 ICP(互联网内容提供商)许可证
  • 适用于具有公网 IP 地址的服务器
  • 过程需2-4周,需要中国法人实体

< strong id=0>内容过滤 :

  • 应用不得生成违反中国内容规定的内容
  • 在向中国用户展示之前实施内容审核
  • OpenAI 的内容政策与中国要求不同

测试区域性能

在全局部署之前,从目标区域进行测试

<div><p>hljs bash</p><pre></pre></div>

从以下位置运行测试:

  • AWS EC2 实例在目标区域
  • 在线监控服务(Pingdom,UptimeRobot)
  • 通过 VPN 从开发机器模拟用户位置

目标指标:

  • 延迟 P95:良好的用户体验需要小于 200 毫秒
  • 错误率 :接受率小于 1%
  • 可用性 :生产环境最低 99.9%

迁移策略和企业集成模式

随着 Apps SDK 的成熟,开发者需要明确的路径来迁移现有应用程序并扩展到企业需求。本节涵盖了早期采用者的迁移策略和生产模式。

从 GPT 插件迁移到 Apps SDK

由于 GPT 插件在 DevDay 2025 之后被弃用,现有的插件开发者必须过渡到 Apps SDK。迁移路径根据插件复杂度而异:

简单插件(仅数据检索):

  1. 将 ai-plugin.json 清单转换为 MCP 工具定义
  2. 将插件端点映射到 MCP tools/call 处理器
  3. 从插件认证更新到环境变量
  4. 在 ChatGPT 开发者模式下测试

时间表 :1-3 个端点的插件需要 4-8 小时

示例迁移 :

<div><p>hljs typescript</p><pre></pre></div>

复杂插件(多步骤工作流程):

对于具有身份验证流程、OAuth 回调或状态会话的插件,迁移需要围绕 MCP 的无状态模型进行重新设计。选项包括:

  • 将会话状态存储在外部数据库(Redis、DynamoDB)中
  • 在 MCP 响应中使用签名令牌以保持上下文
  • 简化流程以适应 ChatGPT 的对话模型

时间表 :复杂插件需要 2-3 天

企业集成模式

启动合作伙伴如 Booking.com、Spotify 和 Figma 展示了企业级部署策略:

Apps SDK enterprise architecture with multi-tenant support

多租户架构

挑战 :通过单个 ChatGPT 应用为多个组织提供服务 模式 :通过用户上下文识别租户

<div><p>hljs typescript</p><pre></pre></div>

Booking.com 实施 :每家酒店连锁都有独立的数据访问;希尔顿的用户无法通过同一 ChatGPT 应用查询万豪的库存。

SSO 和身份验证

挑战 :与企业身份提供者(Okta、Azure AD)集成 模式 :基于令牌的身份验证与 MCP 上下文

  1. 用户在 ChatGPT 外通过 SSO 提供商进行身份验证
  2. SSO 提供商颁发 JWT 令牌
  3. 用户在首次交互时向 ChatGPT 应用提供令牌
  4. MCP 服务器验证令牌并将其存储在会话缓存中
  5. 后续请求使用缓存的身份验证

Spotify 实现 :用户连接 Spotify 账户一次;ChatGPT 应用通过存储的 OAuth 令牌访问用户的播放列表和播放历史。

审计日志和合规性

挑战 :跟踪所有数据访问以符合 SOC 2、HIPAA 或 GDPR 要求 模式 :带请求 ID 的结构化日志

<div><p>hljs typescript</p><pre></pre></div>

企业需求 :

  • 保留日志7年(萨班斯-奥克斯利法案)或2年以上(通用数据保护条例)
  • 包括用户 ID、操作类型、访问数据、时间戳
  • 存储在防篡改系统中(AWS CloudWatch、Datadog)

组织级别的速率限制

挑战 :防止单个租户耗尽资源 模式 :每个租户的令牌桶算法

<div><p>hljs typescript</p><pre></pre></div>

从启动合作伙伴那里得到的经验

基于公开声明和 DevDay 2025 演示:

Figma(设计协作):

  • 挑战:ChatGPT 中的实时设计渲染
  • 解决方案:生成静态预览图片,链接到实时编辑器
  • 结果:来自 ChatGPT 发现的用户注册量增长 40%

Coursera(教育):

  • 挑战:根据对话上下文推荐课程
  • 解决方案:MCP 工具分析对话历史,推荐相关课程
  • 结果:课程报名率比传统搜索高25%

Zillow (房地产):

  • 挑战:以图片内联的方式展示房产列表
  • 解决方案:MCP 返回结构化数据;ChatGPT 以卡片形式渲染
  • 结果:60%的用户通过 ChatGPT 应用找到的房产进行互动

关键要点 :

  1. 视觉内容推动参与度 :带有图片/卡片的 App 比纯文本 App 表现更佳
  2. 发现 > 搜索 :用户通过对话而非浏览来发现 App
  3. 简洁至上 :顶级 App 拥有 1-3 个工具,而不是几十个
  4. 移动优先 :70%的 ChatGPT 使用来自移动端;为小屏幕设计

准备应用提交

根据 OpenAI 的开发者指南 :

提交前所需 :

  • App 在开发者模式下测试(10+次成功交互)
  • 隐私政策发布(数据收集、存储、共享)
  • 服务条款定义(用户义务、限制)
  • 内容审核实施(针对用户生成内容)
  • 错误处理覆盖所有边缘情况
  • 速率限制防止滥用
  • 生产 MCP 服务器需要 HTTPS

OpenAI 评估标准 :

  • 功能 :应用运行可靠,提供独特价值
  • 安全性 :无有害、非法或欺骗性内容
  • 用户体验 :描述清晰,错误信息有帮助
  • 性能 :95%的请求响应时间小于 5 秒
  • 合规性 :符合数据保护法规(GDPR、CCPA)

提交时间表 (根据官方公告):

  • 应用提交门户将于2025年第四季度开放
  • 审核流程:初始应用5-10个工作日
  • 拒绝将包括具体反馈以便重新提交

结论

OpenAI Apps SDK 于 DevDay 2025 推出,为开发者提供了通过模型上下文协议直接访问超过 8 亿 ChatGPT 用户的途径。本指南涵盖了整个开发生命周期:从理解 MCP 基础到构建您的第一个天气应用,再到优化令牌成本、考虑区域因素进行全球部署,以及实施企业级安全模式。

开发者关键决策:

  • 选择 Apps SDK 以实现 ChatGPT 原生分发和对话发现
  • 通过选择合适的模型(GPT-4o-mini 适用于 70-80%的任务,可节省 94%)来优化成本
  • 通过 API 网关解决中国部署的延迟问题 (500ms → 20-40ms)
  • 实现生产模式包括错误处理、速率限制和审计日志

对于在 OpenAI 平台上构建的开发者来说,Apps SDK 补充了现有的工具,如直接 API 集成和函数调用 。随着生态系统的成熟,成功的应用将平衡技术性能和用户体验,遵循启动合作伙伴 Booking.com、Spotify、Figma 和 Coursera 展示的模式。

今天开始构建,通过探索官方 Apps SDK 文档 、审查示例应用并在 ChatGPT 的开发者模式中测试来开始。随着应用提交于 2025 年第四季度开放,早期开发者有机会通过 ChatGPT 的对话界面触达数百万用户。