僅限桌面版的外掛程式必須在使用者的電腦上執行。這類外掛程式包括大多數使用本機 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 代表,以確認該組織是否有提交權限。