如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .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 代表,以確認該組織是否有提交權限。