如果您已经发布了 Claude Code 插件或连接器,请根据其中是否包含技能、MCP 服务器或两者,选择相应的提交方式。
| 您已有的内容 | 提交方式 |
|---|---|
| 仅包含技能,没有 MCP 服务器 | 上传仅包含技能的插件。 |
| 公开的 HTTPS MCP 端点 | 提交包含远程 MCP 服务器的插件。如果有技能,请将其添加到同一份草稿中。 |
| 本地 MCP 服务器 | 请参阅提交仅适用于桌面端的插件,了解提交条件和步骤。 |
Claude Code 插件和 MCP 连接器在 Claude 上有各自的提交流程。OpenAI 使用统一的插件包,可以包含技能、MCP 服务器或两者。Claude 市场的上架信息和审批结果不会转移到 OpenAI。
如果您的插件包含技能,无论采用哪种提交方式,都请先按照指令遵循指南检查技能指令。
提交仅包含技能的插件
如果插件不需要 MCP 服务器,请选择这种方式。
了解 OpenAI 支持的内容
| Claude 插件中的内容 | 处理方式 |
|---|---|
skills |
将每项技能及其 SKILL.md、脚本、参考资料和资源文件保存在一起。直接上传 Claude 归档文件时,其中必须至少有一项技能,其文件路径为 skills/<skill-name>/SKILL.md。 |
| 清单中声明的自定义技能目录 | 在归档文件中保留这些目录及其对应的清单声明。 |
| 明确提及 Claude 的技能 | 将技能指令中专指 Claude 的表述改为不限定提供商的说法,例如“模型”。仅在指令确实适用于某个产品时保留该产品的名称。 |
commands、commands/、agents 或 agents/ |
将可复用的行为转换为技能。将每条 Markdown 命令转换为一项技能,把可复用的智能体操作流程移入技能,并将有用的角色设定指令合并到相应技能中。 |
hooks 或 hooks/hooks.json |
向公开插件目录提交插件前,请移除生命周期钩子。如果插件依赖生命周期钩子,请以便于用户在 Codex 桌面端手动安装的形式分发插件。请参阅生命周期钩子。 |
userConfig 或 ${user_config.*} |
OpenAI 不会执行 Claude 安装时的交互式提示,也不会展开 user_config 变量。请按照替换 Claude userConfig 中的说明操作。如果插件需要凭据或需要持久保存用户设置,请使用 MCP 服务器。 |
| 创建或更新 Claude 动态制品的技能 | OpenAI 目前不支持 Claude 动态制品。请移除要求创建、重新打开、刷新或更新制品的指令。请直接在对话中输出制品的内容,例如将制品中的表格呈现为普通表格。制品特有的 HTML、持久化功能、刷新行为和交互功能均不会保留。 |
bin/、settings、settings.json、CLAUDE.md 或 .claude/settings*.json |
在插件中保留必需的辅助程序和指令。使用相对于插件包的路径调用随包提供的可执行文件,并移除仅适用于 Claude 的设置。 |
outputStyles、lspServers、experimental.themes、experimental.monitors、channels 或 dependencies |
将必要功能移入技能,然后移除相应的 Claude 声明。如果核心工作流需要接收来自渠道的消息,请联系您的 OpenAI 合作伙伴。 |
.claude-plugin/plugin.json |
直接上传 Claude 归档文件时,请保留此清单。提交门户会将其转换为 .codex-plugin/plugin.json。 |
.claude-plugin/marketplace.json、.mcp.json、mcpServers、.app.json 或 apps |
请勿依赖这些文件或声明。仅上传技能时,上传内容不包括 MCP 服务器配置,也不能通过引用来提交现有的 MCP 服务器集成。 |
准备并上传归档文件
- 确认归档文件的根目录或其唯一的顶层目录中包含
.claude-plugin/plugin.json,且其中的description非空。该目录还必须包含至少一项有效技能,路径为skills/<skill-name>/SKILL.md。 - 打开插件提交门户,选择创建插件,再选择仅技能,然后上传归档文件。
- 检查生成的
.codex-plugin/plugin.json。转换过程中,门户会补充缺失的界面默认值,并将文本字段格式标准化。 - 在干净的环境中测试导入的技能。确认每项技能都能找到其引用的文件和可执行程序,且不依赖未声明的本地软件包、文件或凭据。
- 填写上架和审核所需的字段,修复扫描发现的所有问题,然后提交草稿。
如果归档文件不符合直接上传的条件,请按照打包插件中的说明创建 OpenAI 清单并组织插件包的目录结构。有关技能要求,请参阅构建技能。
提交包含远程 MCP 服务器的插件
如果服务器有稳定、公开且 OpenAI 可以访问的 HTTPS URL,请选择这种方式。即使服务器原先在 Claude 插件中本地运行,只要您已将其部署为远程服务,也可以采用这种提交方式。
了解 OpenAI 支持的内容
| Claude 集成中的内容 | 处理方式 |
|---|---|
| 远程 MCP 服务器 | 复用现有的服务器实现。提交使用 Streamable HTTP 的稳定、公开的 HTTPS 端点。 |
本地 MCP 服务器或 Claude Desktop 扩展程序(.mcpb) |
将 MCP 服务器部署到公开的 HTTPS URL,或按照提交仅适用于桌面端的插件中的说明提交本地 MCP 插件。门户不接受 .mcpb 文件。 |
| 技能或清单中声明的自定义技能目录 | 选择包含 MCP 时,请在同一次提交中包含这些技能。将每个 SKILL.md 与对应的脚本、参考资料和资源文件保存在一起。 |
| 明确提及 Claude 的技能 | 将技能指令中专指 Claude 的表述改为不限定提供商的说法,例如“模型”。仅在指令确实适用于某个产品时保留该产品的名称。 |
commands、commands/、agents 或 agents/ |
将可复用的行为转换为技能。将每条 Markdown 命令转换为一项技能,把可复用的智能体操作流程移入技能,并将有用的角色设定指令合并到相应技能中。 |
hooks 或 hooks/hooks.json |
向公开插件目录提交插件前,请移除生命周期钩子。如果插件依赖生命周期钩子,请以便于用户在 Codex 桌面端手动安装的形式分发插件。请参阅生命周期钩子。 |
userConfig 或 ${user_config.*} |
OpenAI 不会执行 Claude 安装时的交互式提示,也不会展开 user_config 变量。请按照替换 Claude userConfig 中的说明,根据每个值的用途,分别改用显式输入、OAuth、托管存储或 Codex 本地配置。 |
| 创建或更新 Claude 动态制品的技能 | OpenAI 目前不支持 Claude 动态制品。请移除要求创建、重新打开、刷新或更新制品的指令。请直接在对话中输出制品的内容,例如将制品中的表格呈现为普通表格。制品特有的 HTML、持久化功能、刷新行为和交互功能均不会保留。 |
.app.json、apps 或现有的 MCP 服务器集成 |
直接提交 MCP 服务器端点。不能通过引用来提交现有的 MCP 服务器集成。 |
outputStyles、lspServers、experimental.themes、experimental.monitors、channels 或 dependencies |
将必要功能移入技能或 MCP 工具,然后移除相应的 Claude 声明。如果核心工作流需要接收来自渠道的消息,请联系您的 OpenAI 合作伙伴。 |
准备并提交 MCP 服务器
- 在生产环境的 HTTPS 端点部署 MCP 服务器,并使用 Streamable HTTP。如果服务器访问用户的私有数据或代用户执行操作,请使用 OAuth 2.1。请按照验证用户身份中的说明操作,确保符合产品要求和 MCP 授权规范。
- 添加准确的工具模式定义和安全注解。逐一测试工具,确认每个工具都能建立连接、完成身份验证、返回结构符合预期的结果,并在执行写入或破坏性操作前按预期要求确认。
- 将所有命令或智能体转换为技能,并确保这些技能不依赖未声明的本地软件包、文件或凭据。
- 打开插件提交门户,选择创建插件,再选择包含 MCP,然后提交生产端点。如果有转换后的技能,请将其添加到同一份草稿中。
- 验证服务器域名。如果服务器要求登录,请配置身份验证。填写上架和审核所需的字段,修复扫描发现的所有问题,然后提交草稿。
提交前,请为以下两项设置做好准备:
- 域名验证: 您必须能够在 MCP 主机或允许使用的上级域名主机上,通过
/.well-known/openai-apps-challenge原样返回门户提供的验证令牌。门户提示时,请完成验证。请参阅配置 MCP 提交信息。 - OAuth 和工作空间域名限制: 如果插件使用 OAuth,请提供 UserInfo 端点,使其返回用户的
email声明和email_verified: true。请公布并启用openid和email作用域。请参阅支持工作空间域名限制。
提交前,请查看远程 MCP 服务器审核要求。
替换 Claude userConfig
OpenAI 插件不会执行 Claude userConfig 安装时的交互式提示,也不会展开 ${user_config.*} 引用。请移除这些引用,并根据每个值在插件中的用途选择替代方式。
| 值的用途 | 在 OpenAI 插件中的替代方式 |
|---|---|
| 可随任务变化的选项 | 为技能或 MCP 工具添加显式输入参数。仅在工作流需要时询问该值。 |
| 远程服务的凭据 | 通过远程 MCP 服务器使用 OAuth 2.1。请勿将密钥等机密信息放入技能归档文件、清单、指令或默认值中。 |
| 需要持久保存的偏好设置 | 将偏好设置保存在托管服务中,并与已通过身份验证的用户关联。允许用户通过专门的工作流或显式的工具输入参数更新设置。 |
| Codex 本地脚本或钩子的设置 | 使用文档中有说明的环境变量或配置文件。使用前请检查该设置是否存在。如有缺失,请返回说明如何解决问题的错误信息。ChatGPT 的核心工作流不应依赖这项本地设置。 |
| 对所有用户都相同的固定值 | 将不含机密信息的默认值写入技能指令或托管服务配置。 |
如果仅包含技能的插件需要凭据,或需要在不同对话之间保留某项设置,请添加 MCP 服务器。远程服务器应使用 OAuth 和托管存储。 如果该值仅影响当前任务,请让插件继续仅包含技能,并通过显式的技能输入参数获取该值。
满足提交要求
无论提交哪种插件,您都需要先在将拥有该插件的 OpenAI 组织中获得应用管理写入权限。您还必须完成个人或企业身份验证。所有插件都必须经过 OpenAI 审核。
如果插件的核心功能需要在本地执行、任意访问用户计算机上的文件、访问硬件或应用、离线运行或接收来自渠道的消息,请在提交前联系您的 OpenAI 合作伙伴。这些情况可能需要针对具体产品进行审核。