仅限桌面端使用的插件必须在用户自己的计算机上运行。这类插件包括大多数使用本地 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 服务器的插件
- 在 OpenAI 平台的组织设置中找到负责提交的组织的 ID。
- 将该 ID 发送给您的 OpenAI 代表,请其将您的组织加入许可名单,以便提交使用本地 MCP 服务器的插件。收到确认后再提交。
- 打开插件提交门户,选择创建插件,然后选择仅含技能。使用上传 ZIP 文件上传包含本地 MCP 配置的插件包。
- 按照提交要求完成准备工作,然后提交插件以供审核。审批通过后,在门户中发布插件。
不使用 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 代表,以确认该组织是否有提交权限。