如果您打算公开发布插件,请为插件中的远程 MCP 服务器及其可选用户界面做好审核准备。
本页介绍提交远程 MCP 服务器的要求。请通过插件提交门户提交并发布完整插件,包括技能、MCP 服务器和可选用户界面。完整提交流程以提交插件为准。有关如何在插件中集成由服务器提供的功能,请参阅构建 MCP 服务器。
提交插件前准备远程 MCP 功能
如果插件包含远程 MCP 服务器,请参照本页了解组织验证、管理权限、服务器要求、审核快照和版本维护方面的要求。
确认远程 MCP 服务器能在 ChatGPT 中正常运行后,请通过插件提交门户提交审核。本页介绍提交时远程 MCP 服务器和可选用户界面需要满足的要求。
仅当您打算在提交时指定的国家/地区公开提供插件时,才应提交插件。如果仅供私人或工作空间内部使用,请使用自定义 MCP 服务器连接。
提交插件前,请阅读插件指南,了解对 MCP 服务器和可选用户界面的要求,并参阅提交插件,了解插件提交、审批和发布的完整流程。
有关仅包含技能的插件以及使用 MCP 的插件从提交到审核、审批和发布的完整流程,请参阅提交插件。
提交插件前
组织验证
提交任何插件前,请在 OpenAI 平台控制台完成身份验证。验证时使用的名称应与您计划在目录中发布插件时使用的发布者名称一致。
- 如果您希望以个人名义发布,请完成个人验证。
- 如果您希望以企业名义发布,请完成企业验证。
审核时会核查这一要求。如果提交时使用未经验证的个人或企业名称,插件将被拒绝。
插件提交权限
创建插件草稿并提交审核需要 api.apps.write 权限。在控制台中查看草稿和审核状态需要 api.apps.read 权限。组织所有者自动拥有这两项权限,也可以在 OpenAI 平台控制台中通过角色将权限授予非所有者。
远程 MCP 服务器要求
- 将 MCP 服务器托管在可公开访问的域名下。
- 不要使用本地端点或测试端点。
- 如果服务器返回用户界面,请定义内容安全策略(CSP),明确列出组件获取资源时需要访问的具体域名,并允许访问这些域名。
模板化 MCP 服务器 URL
大多数插件应提交通用 MCP 服务器 URL,即所有用户和组织都能使用的同一个托管 MCP 端点。仅当插件为不同工作空间使用不同的 MCP 服务器 URL 时,才应选择模板,例如每个客户都有独立的租户、工作空间或托管 MCP 端点。只有与我们已有合作关系的受信任开发者才能使用模板化 URL。
使用模板提交时,需要提供两个 URL 值:
- 示例 MCP 服务器 URL: 可正常访问的具体 MCP 端点,供审核和自动检查使用。
- MCP 服务器 URL 模板: 用于说明 MCP 端点中的哪些部分因客户工作空间而异的 URL 模式。
示例 MCP 服务器 URL 必须指向真实端点,且 OpenAI 在审核期间能够连接到该端点。请勿在示例 MCP 服务器 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
提交审核
满足前提条件后,您可以通过插件提交门户将插件提交审核。
启动审核流程
在插件提交门户中执行以下操作:
- 填写 MCP 服务器信息(如果选择了 OAuth,还需填写 OAuth 凭据),然后选择扫描工具。
- 填写提交表单中的必填字段,并勾选所有确认框。您需要提供插件名称、徽标、描述、公司网站和隐私政策的 URL、MCP 和工具信息、测试提示及响应,以及本地化信息。
- 选择提交审核。
扫描工具时存储的元数据
选择扫描工具后,控制台会将 MCP 端点声明的元数据导入草稿。其中包括工具名称、标题和描述,输入和输出模式,安全方案,_meta 字段,工具注解,关联的用户界面资源元数据(包括 CSP 设置),以及 MCP 服务器的 instructions。控制台显示的是服务器提供的注解值。
提交时,请说明服务器提供的注解值为何符合各工具的行为。这些说明不会覆盖注解。例如,如果服务器声明 readOnlyHint: false,即使您在说明中称该工具“在功能上是只读的”,工具也不会因此被视为只读。如果工具确实是只读的,请将服务器上的对应注解更新为 readOnlyHint: true,部署更改,再次选择扫描工具,核实更新后的值,然后提交。
每个组织可以发布多个不同的 MCP 插件。对于每项 MCP 服务器集成,同一时间只能有一个已发布版本,也只能有一个版本处于审核中。如果提交后需要修改,请选择取消审核撤回提交,然后重新提交同一版本的草稿。
目前,采用欧盟数据驻留的项目无法提交包含 MCP 服务器的插件供审核。请使用采用全球数据驻留的项目。如果您没有这样的项目,请在 OpenAI 控制台中为当前组织创建一个新项目。
审核与审批
提交后,插件会进入审核队列。您可以在控制台中查看状态。状态发生变化时,您会收到电子邮件通知。
审核与检查
我们可能会进行自动扫描或人工审核,以了解插件的工作方式,并判断它是否可能与我们的政策冲突。
审批结果与申诉
如果插件获批,我们会通过电子邮件通知您。获批后,您可以通过插件提交门户发布插件。
如果插件因其 MCP 服务器、工具或用户界面而被拒绝或移除,您会收到反馈,了解哪些检查未通过。完成必要修改后,您可以重新提交插件供审核。如需申诉,请回复收到的电子邮件,清楚说明申诉理由,并提供任何有助于复核的新信息。
获取帮助
如果您在提交前、提交过程中或提交后遇到问题,而文档未能解答,请联系 OpenAI 支持团队。请附上插件提交门户中显示的 ID,以便支持团队找到您的插件。
审核与审批常见问题
审核需要多长时间?
我们正在持续完善审核流程并扩大审核规模,所需时间可能有所不同。我们无法安排加急审核,请勿为此联系支持团队。
插件被拒绝的常见原因有哪些?如何解决?
- 我们无法使用您提供的 MCP URL、测试凭据或两者连接到您的 MCP 服务器。
- 如果服务器要求身份验证,审核团队必须能够直接登录演示账户,无需额外配置。
- 请确保提供的 URL 和凭据正确,且登录时无需 MFA。不得要求输入短信验证码,也不得要求通过需要短信、电子邮件或其他验证方式的系统登录。
- 请确认可以使用提供的凭据成功登录。测试时,请使用公司网络、局域网及其他内部网络以外的网络。
- 请确认凭据尚未过期。
- 一个或多个测试用例未产生正确结果。
- 仔细检查并重新运行每个测试用例,确认输出与预期结果一致。如果插件有用户界面,还应确认界面没有错误,例如内容或图片加载失败等问题。
- 确保返回的文本紧扣用户请求,不包含与请求无关的额外信息,包括无关的个人标识符。
- 确保所有测试用例都能在插件将要支持的各个 ChatGPT 和 Codex 使用界面上通过。
- 将每个工具的实际输出与明确定义的预期行为逐一比较,修正所有不一致之处,确保结果与用户输入相关,且插件能可靠地实现其承诺的功能。
- 如有必要,请在重新提交时修改测试用例和预期响应,使其清晰、无歧义。
- 插件返回了隐私政策中未披露的用户相关数据类型。
- 在 ChatGPT 中运行几个符合实际使用场景的示例请求,检查 MCP 工具的响应,并列出服务器返回的所有用户相关字段,包括嵌套字段和“调试”载荷。确保工具仅返回处理用户请求所必需的信息,移除不必要的个人身份信息、遥测数据或内部标识信息(例如会话 ID、跟踪 ID、请求 ID、时间戳、内部账户 ID 或日志),以及所有身份验证机密(Token、密钥或密码)。
- 您也可以考虑更新已发布的隐私政策,明确披露您收集、处理或返回的所有个人数据类别及原因。如果某个字段确实没有必要,请直接移除该字段,而非仅在政策中披露。
- 如果确实需要用户标识符,应仅在用户明确要求且该标识符与用户意图直接相关时返回,避免默认查询并原样返回标识符。
- 工具提示注解与工具的实际行为似乎不符:
- readOnlyHint: 如果工具仅获取、查找、列出或检索数据,且不会修改任何内容,请设为
true。如果工具能创建、更新或删除任何内容,触发操作(发送电子邮件或消息、运行作业、将任务加入队列、写入日志、启动工作流),或以其他方式改变状态,请设为false。 - 破坏性操作提示: 如果工具可能造成不可逆的后果(删除或覆盖内容、发送无法撤回的消息或发起无法撤销的交易、撤销访问权限,或执行破坏性的管理操作),请将破坏性操作注解设为
true。即使这些后果只会在特定模式下、使用默认参数时或因间接副作用而发生,也应如此设置。请在提交说明中写明哪些后果不可逆、在什么条件下会发生,以及有哪些防护措施,例如确认步骤、模拟运行选项或作用范围限制。如果不会造成不可逆的后果,请设为false。 - openWorldHint: 如果工具访问公共互联网,或其可交互的外部对象没有固定范围,请设为
true。这包括网页搜索等只读工具,也包括在公共平台上发帖、向外部收件人发送消息、发布内容、推送代码或提交表单的写入工具。如果工具的访问范围仅限于特定的私人账户或工作空间,即使服务托管在外部,也应设为false。
- readOnlyHint: 如果工具仅获取、查找、列出或检索数据,且不会修改任何内容,请设为
发布与分发
发布插件
插件获批后,您可以在插件提交门户选择发布来发布插件。
用户如何找到插件
发布后,用户可以通过以下方式在 ChatGPT 和 Codex 共用的插件目录中找到您的插件:
- 点击直接指向该插件目录条目的链接。
- 按名称搜索插件。
在实际使用中表现出较高实用性且用户满意度高的插件,可能获得更多分发机会,例如在目录中获得展示位,或由系统主动推荐。不过,只有少数插件会在发布时获得这些机会。开发者无法申请额外分发。
发布与分发常见问题
插件获批后会怎样?它会自动出现在插件目录中吗?
插件获批后,您可以选择通过插件提交门户发布。只有发布后,插件才能出现在通用插件目录中。
为什么我在目录中看不到自己的插件?
只有被 OpenAI 选中进行额外分发的插件才会出现在目录的主要页面上。要确认插件是否已发布,请使用完整且准确的发布名称搜索,或从插件提交门户打开插件的目录 URL。
如果我想发布有关插件的新闻稿或公告,该怎么做?
发布任何有关插件上线的新闻稿或公告前,请先发送电子邮件至 press@openai.com,与我们的传播团队协调。
持续维护
已发布的 MCP 元数据版本如何运作
请将 MCP 服务器公开的元数据视为插件的 API 契约,并按版本管理。在插件提交门户扫描 MCP 端点时,OpenAI 会将发现的元数据与该草稿版本一并存储。提交该版本时,送审的是这份已存储的快照。发布后,持续审核流程会更新工具定义,无需创建新的插件版本。工具调用和用户界面资源仍使用您在线运行的 MCP 服务器。
持续审核与工具更新
OpenAI 会定期获取 MCP 服务器提供的工具,并与已发布的定义进行比较,包括工具描述、模式和注解。
- 已删除的工具: 扫描一旦发现工具已删除,就会立即将其从已发布的工具列表中移除,无需等待自动检查。
- 新增的工具: 通过自动检查后即可使用。在此之前,用户无法使用这些工具。
- 已更改的工具: 在更新后的定义通过自动检查或扫描发现您已移除工具之前,旧定义会继续生效。通过检查后,新定义会自动替换旧定义。
每个工具可以独立通过检查。例如,您新增了 create_note,修改了 search 使其接受 folder 参数,并删除了 archive_note。下次扫描时,系统会立即移除 archive_note。如果 create_note 通过了检查,但 search 的更新被暂缓,用户就能使用 create_note,而 search 仍使用不含 folder 参数的旧定义。
更新被暂缓时,请确保服务器与当前生效的定义保持兼容。OpenAI 保留的是工具定义,不会保存服务器实现的副本。即使检查尚未发现问题,只要检查未完成,更新就不会获批。
其他更改
请根据下表确定各类更改的发布方式:
| 更改内容 | 所需操作 | 用户何时能看到更改 |
|---|---|---|
工具安全方案、工具的 _meta 字段、用户界面资源引用或关联资源的元数据(包括内容安全策略(CSP)设置) |
部署更改。持续审核会将这些字段与工具定义一并审核。 | 更新后的工具定义通过自动检查后。 |
MCP 服务器的 instructions |
部署更改。共享指令会与受影响的工具一并审核。 | 所需检查全部完成,且既未暂缓现有工具的更新,也未发现指令存在问题时。 |
| 通过同一已发布用户界面资源 URI 提供的向后兼容的内容更新 | 部署内容更新。只要 URI 和已发布的契约保持兼容,就无需扫描、提交或发布新版本。 | 部署后。ChatGPT 可能会继续提供缓存的资源内容,最长可达一小时。 |
仅涉及服务器的修复,或对实时工具结果(包括结果中的 _meta)或业务数据的更改 |
部署服务器更改。只要更改仍符合已发布的契约,就无需扫描、提交或发布新版本。 | 部署后,用户即可通过在线端点看到更改。 |
MCP 服务器的源(scheme、hostname 或 port) |
如需更改源,请创建新插件,然后完成扫描、提交、审核和发布流程。如果仅更改端点路径,请按常规流程发布新版本。 | 发布新插件或获批的新版本后。 |
服务器更改会先行生效,之后扫描才能发现更改,更改也才可能获批。在这段时间内,请确保现有输入模式和每个已发布的用户界面资源 URI 都能正常使用。如果部署导致服务器不再符合当前生效的契约,请回滚服务器更改,不要等待审核。
提交新版本供审核
如需更改已提交的插件信息或已导入的技能,请为现有插件创建新的草稿版本,并重新提交审核。工具的持续审核不能替代这一流程。每次重新提交都会启动新一轮审核。请在发行说明中描述更改内容。
不同版本之间不能更改 MCP 服务器的源(scheme、hostname 或 port)。如需使用不同的源,请使用新的 MCP 服务器源提交新插件。您可以在现有插件的新版本中更改端点路径。
我们会重新审核更新后的插件元数据,并通过电子邮件和插件提交门户告知您更新是否获批。如果更新被拒绝,您可以修改后重新提交,也可以提出申诉。
重新提交的版本获批后,您就可以发布更新。发布后,新版本会替换旧版本。
如果您在提交后、获批前又修改了插件,并希望提交新版本供审核,请在插件提交门户中取消当前审核,然后重新提交。
替换已发布的元数据版本和移除插件
要替换已发布的插件版本,请直接在插件提交门户发布获批的新版本。新版本审核期间,请保持当前版本的发布状态。发布获批的新版本时,当前版本会被替换,无需先将其下架。
只有当您希望插件不再对公众可见时,才应将当前版本下架。如果没有已发布的替代版本,下架当前版本会导致插件不可用。
要从您的组织以及 ChatGPT 和 Codex 中移除插件,请在插件提交门户中删除该插件。
维护要求
不活跃、运行不稳定或不符合要求的插件可能会被移除。我们可能随时出于任何原因拒绝插件或将其从我们的服务中移除,恕不另行通知。这些原因包括法律或安全方面的顾虑,以及违反政策的情况。
持续维护常见问题
如果用户举报我的插件有害或具有误导性,会怎样?
OpenAI 会审查用户举报,并可能审核或调查您的插件,包括其 MCP 服务器、工具和用户界面。违反政策的插件可能会受到限制或被移除。您可以按照本页所述的申诉流程,对移除插件或其他处置措施提出申诉。请定期查看并回应反馈,发现问题后及时更新插件。
更新审核需要多长时间?
与首次审核一样,我们无法提供更新审核的预计完成时间。