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

提交仅限桌面端使用的插件

提交运行本地 MCP 服务器或需要在桌面端执行的插件。

仅限桌面端使用的插件必须在用户自己的计算机上运行。这类插件包括大多数使用本地 MCP 服务器(stdio)的插件,以及调用本地程序的插件。它们在 OpenAI 插件目录中带有仅限桌面端标记。用户只能通过 ChatGPT 桌面应用安装这些插件,也只能在本地运行的对话线程中提及它们。

需要审批: 只有获批的合作伙伴才能提交使用本地 MCP 服务器的插件。执行以下步骤前,请联系您的 OpenAI 代表确认提交资格,并请其将负责提交的组织加入许可名单。

提交前,请先打包插件,在干净的桌面环境中测试插件的安装过程及其主要工作流。请确保满足提交前的标准要求,包括取得提交权限并完成开发者或企业身份验证。

配置本地 MCP 服务器

采用与其他插件相同的插件结构。在根目录的 mcp.json 中,将 mcpServers 下的 HTTP 服务器配置项替换为 stdio 配置项,并在其中指定本地启动命令。

服务器可以使用任何支持通过 stdio 进行 MCP 通信的语言或运行时。例如,Node.js 服务器的配置项可以这样写:

{
  "type": "stdio",
  "command": "node",
  "args": ["${PLUGIN_ROOT}/server/dist/index.js"],
  "cwd": "${PLUGIN_ROOT}"
}

请将服务器及其依赖项一并打包。${PLUGIN_ROOT} 是内置占位符。

提交使用本地 MCP 服务器的插件

  1. 在 OpenAI 平台的组织设置中找到负责提交的组织的 ID。
  2. 将该 ID 发送给您的 OpenAI 代表,请其将您的组织加入许可名单,以便提交使用本地 MCP 服务器的插件。收到确认后再提交。
  3. 打开插件提交门户,选择创建插件,然后选择仅含技能。使用上传 ZIP 文件上传包含本地 MCP 配置的插件包。
  4. 按照提交要求完成准备工作,然后提交插件以供审核。审批通过后,在门户中发布插件。

不使用 MCP 服务器的插件

如果您的插件仅包含技能且必须在桌面端运行,请将 requires_local_executor 设为 true。该字段位于 extensions.com.openai 下,配置文件为根目录中的 plugin.json:

{
  "extensions": {
    "com.openai": {
      "requires_local_executor": true
    }
  }
}

如果旧版插件包使用 .codex-plugin/plugin.json,请将 "requires_local_executor": true 添加到该清单的顶层。

此标志会将您的插件标记为仅限桌面端。请按标准提交流程提交插件。如果门户提示不允许使用该字段,请将负责提交的组织的 ID 发送给您的 OpenAI 代表,以确认该组织是否有提交权限。