当您准备好公开发布插件时，请使用插件提交门户将插件提交审查。
如果您正在迁移现有的 Claude Code 插件或连接器，请先阅读 将您的 Claude Code 插件提交到 OpenAI， 了解在开始提交之前需要进行哪些更改。
如果门户返回错误代码，请查阅 提交错误参考资料， 找到对应的要求。
插件可以包含技能、MCP 服务器，或同时包含两者。您可以提交：
- 仅包含技能的插件，用于封装可复用的工作流。
- 仅包含远程 MCP 的插件。自定义 UI 为可选项。
- 将远程 MCP 服务器与上传或通过 MCP 导入的技能相结合的插件。
请通过 包含 MCP 选项提交 MCP 服务器，并提供稳定的公共 HTTPS 端点。 如果您的 MCP 服务器在本地运行，请将其部署到公共 HTTPS URL。如果无法这样做， 请联系您的 OpenAI 联系人，寻求本地 MCP 支持。
门户会收集展示信息、MCP 服务器或软件包详情、技能、入门提示、测试用例、可用国家和政策合规声明。需要填写哪些字段，取决于插件包含技能、远程 MCP 服务器，还是同时包含两者。
有关本地开发、打包和市场设置，请参阅 构建插件。
有关由服务器支持的能力，请参阅 构建 MCP 服务器。
提交前的准备
提交远程 MCP 服务器，而非对现有集成的引用
您不能提交引用现有已发布集成的插件。如果您的插件包含已在 ChatGPT 或 Codex 中存在的 MCP 服务器，请通过门户从头提交该服务器，创建新的 MCP 插件提交申请。门户会扫描该 MCP 服务器，验证工具元数据，并在审查过程中使用所提交的服务器详情。
获取插件提交权限
您需要拥有具备插件提交写入权限的组织角色， 才能创建或提交插件草稿。平台目前将此权限 标记为 应用管理。
- 打开 OpenAI 平台角色设置。
- 选择拥有该插件的组织。
- 打开分配给提交者的角色，或创建新角色。
- 在角色权限中，将 应用管理 设为 写入。
- 保存该角色，并将其分配给每位需要创建、编辑或提交插件草稿的人员。
- 重新加载插件提交门户。
组织所有者已拥有这些权限。非所有者的提交者需要写入权限才能创建或提交草稿，需要读取权限才能查看草稿和审查状态。
验证您的开发者或企业身份
每项公开发布申请都必须使用已在 OpenAI 平台验证的开发者或企业身份。审查人员会使用此身份，确认提交内容与您公开展示的名称、网站、支持联系方式、隐私政策和条款一致。
验证身份的步骤如下：
- 登录 OpenAI 平台。
- 选择将发布该插件的组织。
- 打开组织设置。
- 如果您将以个人名义发布，请完成 个人验证 ； 如果您将以公司名义发布，请完成 企业验证 。
- 返回插件提交表单，在 开发者身份 字段中选择已验证的身份。
如果发布者身份未经验证或不匹配， 审查人员可能会拒绝提交申请。请参阅 组织验证要求， 了解所依据的审查规则。
如果平台显示开发者或企业身份已验证， 但插件提交表单未能识别，请检查您是否 从完成身份验证的同一组织和项目中提交。 提交者还需要拥有该组织的 应用管理 写入权限。 请让组织所有者或管理员更新分配给提交者的角色， 然后重新加载插件提交门户。
准备所需材料
打开表单之前，请收集以下材料：
| 材料 | 需要准备的内容 |
|---|---|
| 展示详情 | 插件名称、简短描述、详细描述、标志、类别、网站、支持 URL、隐私政策 URL 和条款 URL。 |
| 开发者身份 | 已在 OpenAI 平台验证的个人或企业身份。 |
| 远程 MCP 服务器 | 公共 MCP 服务器 URL、域名验证所需的访问权限、身份验证详情、演示凭据（如有需要）、内容安全策略，以及准确的工具元数据。 |
| 工具注解 | 对于包含远程 MCP 的插件：每个 MCP 工具的 readOnlyHint、openWorldHint 和 destructiveHint 值。 |
| 技能 | 对于技能插件：最终版技能包，或提供静态技能以供 扫描工具 功能导入的远程 MCP 服务器。 |
| 提示 | 展示实用且贴近实际的工作流的入门提示。 |
| 测试用例 | 五个正向测试用例和三个负向测试用例，均需明确预期行为。 |
| 可用范围 | 计划提供该插件的国家或地区。 |
| 发行说明 | 简要概述您提交的内容，以及相较于先前版本的更改（如有）。 |
创建插件提交申请
- 打开插件提交门户。
- 选择 创建插件。
- 选择提交类型：
- 对于仅包含技能的插件，选择仅技能 。
- 对于仅包含远程 MCP 的插件，选择包含 MCP 。
- 如果插件将远程 MCP 服务器与上传的 或从 MCP 导入的技能相结合，请选择包含 MCP 。
在您填写表单时，门户会将提交内容保存为草稿。
填写表单
信息
填写公开展示信息和发布者字段：
- 插件名称： 使用面向客户的产品或工作流程名称。
- 描述： 说明插件能帮助用户完成什么。简短描述应保持简洁， 详细描述则用于介绍工作流程的具体内容。
- 开发者身份： 选择发布者 已验证的个人或企业身份。
- 徽标和类别： 使用可正式使用的品牌素材。
- 网站、支持、隐私政策和条款 URL： 使用与发布者相符的公开 URL， 并披露相关数据处理方式。
提交前，请对照您的隐私政策检查 MCP 响应。从工具响应中移除不必要的个人数据、身份验证机密、调试载荷、内部标识符以及未披露的用户相关字段。
MCP
对于包含远程 MCP 服务器的提交：
- 选择 MCP 服务器 URL 类型：
- 如果一个固定的 MCP 服务器 URL 适用于所有用户和组织， 请选择 通用 。
- 只有在 OpenAI 已批准使用工作空间专属 URL 时，才选择 模板 ， 例如每个客户都有独立的租户、工作空间 或托管 MCP 端点。
- 输入所需的 URL：
- 对于 通用类型，请输入生产环境的 MCP 服务器 URL。
- 对于 模板类型，请同时输入 示例 MCP 服务器 URL 和 模板 MCP 服务器 URL。示例必须是一个具体且可用的端点， 与模板匹配，并且能使用提交的测试凭据访问。
- 配置身份验证；如果服务器要求登录，请提供可供审查人员使用的演示凭据。
- 定义内容安全策略，准确允许您的 UI 获取内容时访问的域名。
- 如果门户显示 域名未验证质询，请完成域名验证。
使用 MCP 主机名或其父级主机名对应的 HTTPS 源，
并在
/.well-known/openai-apps-challenge处托管原样的 Token。 - 选择 扫描工具。
- 检查发现的工具、导入的技能、域名、验证输出和工具元数据。
- 修复服务器、技能或元数据问题，部署修复后再次扫描。
要让使用 OAuth 的插件支持工作空间域名限制，
请配置授权服务器，使其公布一个 UserInfo 端点，
该端点需返回用户的 email 声明和 email_verified: true。提交前，
请确认提供商也公布并启用了 openid 和 email
作用域。您也可以在 ID Token 中返回这些声明，
但工作空间域名限制必须使用 UserInfo 端点。如果提供商
不支持这些要求，请与其协作添加支持。请参阅
支持工作空间域名限制。
模板 MCP 服务器 URL
大多数插件应使用 通用类型。模板 MCP 服务器 URL 仅适用于少数情况，即不同用户群体或数据组需要使用不同的 MCP 服务器 URL。OpenAI 仅为已与我们建立关系的 可信开发者提供模板 URL 支持。如果 OpenAI 尚未批准您 使用模板 URL，请提交通用 URL。
在 模板 MCP 服务器 URL 中，对由工作空间管理员配置的部分
使用 {name} 占位符。占位符名称必须以字母开头，
只能包含字母、数字或下划线，并且在 URL 中必须唯一。
示例 MCP 服务器 URL 必须将每个占位符替换为真实值。
例如：
Example MCP Server URL: https://acme.example.com/mcp
Template MCP Server URL: https://{workspace}.example.com/mcp示例 URL 必须在审查期间可公开访问。请勿在 示例 MCP 服务器 URL 字段中输入占位 URL。有关完整的 MCP 审查要求，请参阅 模板 MCP 服务器 URL。
请勿输入现有集成的 ID，也不要尝试让门户指向现有的已发布集成。提交时必须直接提供 MCP 服务器 URL 和审查材料，即使该服务器已为 ChatGPT 或 Codex 中发布的集成提供支持。
域名验证
包含 MCP 的插件必须验证对服务器所在域名的控制权。当门户显示域名验证质询时，请将验证 Token 原样放置在生成的 well-known URL 处：
https://<challenge-base-host>/.well-known/openai-apps-challenge质询端点必须仅返回该插件的验证 Token。请勿通过同一个 URL 返回 JSON、Token 列表或多个 Token。
质询基础 URL 是一个可选的 HTTPS 源，用于告知门户
在哪里检查 Token。其主机名必须是 MCP 主机名或其父级主机名。
路径会被忽略。例如，如果 MCP 服务器 URL 为
https://api.example.com/mcp，默认质询 URL 则为
https://api.example.com/.well-known/openai-apps-challenge；
如果您能在 https://example.com 托管 Token，
就可以将其用作基于父级源的质询基础 URL。
如果两个包含 MCP 的插件共用同一个主机名，只是路径不同，它们也会共用同一个默认质询 URL。您无法通过在质询基础 URL 中填写不同的租户路径来分别验证它们，因为路径会被忽略。请使用能够托管新 Token 的父级源，或为 MCP 服务器分配独立的主机名；如果这两种托管方式都不可行，请联系 OpenAI 支持。
如果另一个包含 MCP 的插件已使用同一个主机名，请勿替换其现有的质询 Token，除非该插件已不再需要它。请为新的提交使用允许的父级源作为质询基础 URL，或使用独立的 MCP 主机名。
每个工具都应具有清晰的名称、描述、模式和输出结构。如果输出模式有助于审查人员和模型理解工具的返回内容，请添加输出模式。
根据每个工具的实际行为设置工具注解：
| 注解 | 适用情况 |
|---|---|
readOnlyHint | 仅当工具获取、查找、列出、检索、预览或计算信息，且不做任何更改时，才设为 true。如果工具能够创建、更新、删除、发送、加入队列、运行作业、启动工作流程、写入日志或以其他方式更改状态，请设为 false。 |
openWorldHint | 当工具访问公共互联网或范围不受限定的外部实体时，请设为 true。这包括网页搜索等只读工具，以及发帖、发送消息、发布内容、推送代码或提交表单的写入工具。当工具仅限于边界明确的私有账户或工作空间时，即使该服务托管在外部，也应设为 false。 |
destructiveHint | 对于写入工具，如果工具能够删除、覆盖、撤销访问权限、发送无法撤回的消息或交易，或产生其他不可逆的副作用，请设为 true。否则，请设为 false。 |
有关实现细节，请参阅 工具注解和引导式提取。 有关审查要求，请参阅 工具提示字段相关的拒绝指南。
技能
通过以下任一种方式向草稿添加技能：
- 对于仅包含技能或同时包含技能与 MCP 的提交，请上传最终技能包。
- 对于远程 MCP 提交，请从 MCP 服务器导入静态技能。 当您选择 扫描工具时，OpenAI 会将这些技能导入草稿。
使用与本地测试时相同的文件树和指令。要从 MCP 导入技能， 请遵循 技能扩展草案和静态资源清单。
每项技能都应包含：
- 清晰的
SKILL.md，其中包含触发条件和任务指令。 - 所有引用的脚本、模板或资源。
- 符合插件用途、精简且范围明确的指令。
OpenAI 会扫描上传的技能和从 MCP 导入的技能，检查其是否符合政策以及是否存在安全风险，包括敏感信息、不必要的访问请求，以及可能不符合安全要求或插件预期行为的指令。技能必须遵循与插件其余部分相同的标准；如果未通过自动扫描，可能会阻止提交或要求整改。
OpenAI 从 MCP 导入的技能是提交时的快照。 已发布的插件不会实时更新这些技能。在服务器上更改技能后，请再次选择 扫描工具 ，并在提交新插件版本前 审查更新后的技能。
要移除所有从 MCP 导入的技能，请保持技能扩展启用，返回
{ "skills": [] } 且不包含 nextCursor，然后再次扫描。
移除扩展或返回未通过验证的响应，都会保留
之前的快照。
提示
添加入门提示，展示插件最有价值的工作流程。好的提示应足够具体，让用户知道何时使用插件，同时又有足够的通用性，便于用户按需调整。
示例：
- “调查上次发布后的结账错误，并总结可能的根本原因。”
- “根据最新的支持工单及相关部署，编写一份 P1 事件简报。”
- “审查部署失败的日志，并建议下一步调试操作。”
测试
提交至少五个正向测试用例和三个负向测试用例。
每个正向测试用例应包含：
- 用户提示。
- 预期的工具、技能或工作流程行为。
- 预期的结果结构。
- 复现该用例所需的测试账户或测试夹具数据。
每个负向测试用例应包含：
- 用户提示或场景。
- 预期的拒绝、澄清或安全回退行为。
- 插件不应完成所请求操作的原因。
请使用审查人员无需了解内部背景即可运行的测试用例。如果您的插件需要身份验证，请确保使用所提供的演示凭据即可完成每项测试，无需 MFA、短信、电子邮件确认或私有网络访问。
全球
选择应提供插件的国家或地区。仅选择发布者、产品、支持流程和法律条款均已准备好为用户提供服务的地区。
提交
提交前请审查完整草稿。
在发布说明中概述：
- 插件的功能。
- 本次是首次提交还是更新。
- 与上次提交的版本相比有哪些变化（如有）。
- 审查人员需要了解的有关测试凭据、预期数据或设置的任何信息。
请先确认上架信息、服务器、 技能、提示、测试和可用范围均准确无误，再完成政策合规声明。然后选择 提交审查。
公开发布流程
提交插件会启动审查流程，不会立即发布插件。公开发布的流程如下：
- 通过插件提交门户提交插件。
- OpenAI 审查提交内容。随着 OpenAI 建立审查流程并扩大审查规模，审查所需时间可能会有所不同。
- OpenAI 批准插件后，开发者可自行选择发布时间，并通过门户发布插件。
- 发布后，插件会出现在 ChatGPT 和 Codex 共享的统一插件目录中。
仅包含 MCP、仅包含技能以及同时包含技能和 MCP 的插件都会出现在插件目录中。
已发布 MCP 元数据的版本机制
发布后，OpenAI 会定期获取您的 MCP 工具。已删除的工具 一经扫描检测到就会被移除。新增或修改后的工具定义 通过自动检查后即可使用；若更新被暂缓，则继续使用先前的 定义。请参阅 持续审查与工具更新。
对已提交的插件信息或已导入的技能进行更改，仍需创建新版本、 进行审查并发布。
最终检查清单
提交前，请确认：
- 提交者拥有 应用管理 的写入权限。
- 发布者拥有已验证的开发者或企业身份。
- 带有 UI 的插件已针对组件获取数据的确切域名定义内容安全策略。
- 工具名称、描述、模式和注解与实际行为一致。
- 每个工具的
readOnlyHint、openWorldHint和destructiveHint值均准确无误。 - 工具响应不包含不必要的个人数据、身份验证机密、调试载荷、内部标识符或未披露的用户相关字段。
- 您已使用最终文件树在本地测试技能。
- 入门提示展示了切合实际的用户工作流程。
- 提交内容包含五个正向测试用例和三个负向测试用例。
对于远程 MCP 提交，还请确认：
- MCP 服务器使用公开的生产环境 URL。
- 审查人员可使用所提供的凭据完成验证，无需 MFA、电子邮件确认、短信确认或私有网络访问。
- 从 MCP 导入的技能与最近一次 扫描工具 生成的快照一致。
- 隐私政策、条款、支持和网站 URL 均可公开访问，且与发布者身份一致。