如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
概览 智能体访问 ChatGPT 与 Codex 用户文档 使用场景

向 OpenAI 提交您的 Claude Code 插件

将 Claude Code 插件或连接器转换为可提交给 OpenAI 的插件。

如果您已经发布了 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 服务器集成。

准备并上传归档文件

  1. 确认归档文件的根目录或其唯一的顶层目录中包含 .claude-plugin/plugin.json,且其中的 description 非空。该目录还必须包含至少一项有效技能,路径为 skills/<skill-name>/SKILL.md。
  2. 打开插件提交门户,选择创建插件,再选择仅技能,然后上传归档文件。
  3. 检查生成的 .codex-plugin/plugin.json。转换过程中,门户会补充缺失的界面默认值,并将文本字段格式标准化。
  4. 在干净的环境中测试导入的技能。确认每项技能都能找到其引用的文件和可执行程序,且不依赖未声明的本地软件包、文件或凭据。
  5. 填写上架和审核所需的字段,修复扫描发现的所有问题,然后提交草稿。

如果归档文件不符合直接上传的条件,请按照打包插件中的说明创建 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 服务器

  1. 在生产环境的 HTTPS 端点部署 MCP 服务器,并使用 Streamable HTTP。如果服务器访问用户的私有数据或代用户执行操作,请使用 OAuth 2.1。请按照验证用户身份中的说明操作,确保符合产品要求和 MCP 授权规范。
  2. 添加准确的工具模式定义和安全注解。逐一测试工具,确认每个工具都能建立连接、完成身份验证、返回结构符合预期的结果,并在执行写入或破坏性操作前按预期要求确认。
  3. 将所有命令或智能体转换为技能,并确保这些技能不依赖未声明的本地软件包、文件或凭据。
  4. 打开插件提交门户,选择创建插件,再选择包含 MCP,然后提交生产端点。如果有转换后的技能,请将其添加到同一份草稿中。
  5. 验证服务器域名。如果服务器要求登录,请配置身份验证。填写上架和审核所需的字段,修复扫描发现的所有问题,然后提交草稿。

提交前,请为以下两项设置做好准备:

  • 域名验证: 您必须能够在 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 合作伙伴。这些情况可能需要针对具体产品进行审核。

有关门户中的完整操作流程,请参阅提交插件。如果门户返回了插件包验证错误代码,请查阅提交错误参考。