For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

提交外掛程式

透過 OpenAI Platform 提交、發布及維護外掛程式

準備好發布外掛程式供大眾使用時,請透過外掛程式提交入口網站將外掛程式送交審查。

如果你要遷移現有的 Claude Code 外掛程式或連接器,請先閱讀 將你的 Claude Code 外掛程式提交至 OpenAI, 瞭解開始提交前需要進行哪些變更。

如果入口網站傳回錯誤代碼,請查閱 提交錯誤參考資料, 找出對應的要求。

外掛程式可以包含技能、MCP 伺服器,或同時包含兩者。你可以提交:

  • 將可重複使用的工作流程封裝在一起、僅含技能的外掛程式。
  • 僅含遠端 MCP 的外掛程式。自訂 UI 為選用項目。
  • 結合遠端 MCP 伺服器與已上傳或從 MCP 匯入之技能的外掛程式。

請透過 包含 MCP 提交 MCP 伺服器,並使用穩定、公開的 HTTPS 端點。 如果你的 MCP 伺服器在本機執行,請將其部署至公開的 HTTPS 網址。如果無法部署, 請洽詢你的 OpenAI 聯絡人,以取得本機 MCP 支援。

入口網站會收集上架資訊、MCP 伺服器或套件詳細資料、技能、起始提示詞、測試案例、開放使用的國家,以及政策遵循聲明。需要填寫哪些欄位,取決於外掛程式包含技能、遠端 MCP 伺服器,還是同時包含兩者。

如需本機開發、封裝及市集設定的相關資訊,請參閱 建置外掛程式

如需伺服器支援功能的相關資訊,請參閱 建置 MCP 伺服器

提交前的準備

提交遠端 MCP 伺服器,而非現有整合的參照

你無法提交參照現有已發布整合的外掛程式。如果外掛程式包含的 MCP 伺服器已存在於 ChatGPT 或 Codex 中,請透過入口網站,以全新的 MCP 外掛程式提交案重新提交該伺服器。入口網站會掃描該 MCP 伺服器、驗證工具中繼資料,並在審查時使用你提交的伺服器詳細資料。

取得外掛程式提交權限

你需要具備外掛程式提交寫入權限的組織角色, 才能建立或提交外掛程式草稿。目前 Platform 將這項 權限標示為 應用程式管理

  1. 開啟 OpenAI Platform 角色設定
  2. 選取擁有此外掛程式的組織。
  3. 開啟指派給提交者的角色,或建立新角色。
  4. 在角色權限中,將 應用程式管理 設為 寫入
  5. 儲存角色,並將其指派給每位需要建立、編輯或提交外掛程式草稿的人員。
  6. 重新載入外掛程式提交入口網站
Platform 角色設定中的應用程式管理寫入權限

組織擁有者已具備這些權限。非擁有者的提交者需要寫入權限才能建立或提交草稿,並需要讀取權限才能檢視草稿和審查狀態。

驗證你的開發者或企業身分

所有供公開發布的提交案,都必須使用已在 OpenAI Platform 驗證的開發者或企業身分。審查人員會透過此身分,確認提交案與公開上架資訊中的名稱、網站、支援聯絡資訊、隱私權政策及條款一致。

驗證身分的步驟:

  1. 登入 OpenAI Platform
  2. 選取將發布外掛程式的組織。
  3. 開啟組織設定
  4. 如果你將以個人名義發布,請完成 個人驗證 ; 如果將以公司名義發布,請完成 企業驗證
  5. 返回外掛程式提交表單,並在 開發者身分 欄位中選取已驗證的身分。

如果發布者身分未經驗證或與提交資料不符, 審查人員可能會拒絕該提交案。請參閱 組織驗證要求, 瞭解此項審查規則的依據。

如果 Platform 顯示開發者或企業身分已通過驗證, 但外掛程式提交表單無法辨識,請確認你是從 完成身分驗證的同一個組織和專案提交。 提交者也需要具備該組織的 應用程式管理 寫入權限。 請組織擁有者或管理員更新指派給提交者的角色, 然後重新載入外掛程式提交入口網站。

準備必要資料

開啟表單前,請備妥:

資料準備內容
上架詳細資訊外掛程式名稱、簡短說明、詳細說明、標誌、類別、網站、支援網址、隱私權政策網址及條款網址。
開發者身分已在 OpenAI Platform 驗證的個人或企業身分。
遠端 MCP 伺服器公開的 MCP 伺服器網址、網域驗證所需的存取權、身分驗證詳細資料、示範帳號憑證(如有需要)、內容安全政策,以及準確的工具中繼資料。
工具註解包含遠端 MCP 的外掛程式:每個 MCP 工具的 readOnlyHintopenWorldHintdestructiveHint 值。
技能包含技能的外掛程式:最終版技能套件,或提供靜態技能供 掃描工具 匯入的遠端 MCP 伺服器。
提示詞能呈現實用且符合實際情境之工作流程的起始提示詞。
測試案例五個正向測試案例和三個反向測試案例,並清楚說明預期行為。
開放使用範圍應開放使用此外掛程式的國家或地區。
版本資訊簡要說明此次提交的內容,以及相較於先前版本的變更。

建立外掛程式提交案

  1. 開啟外掛程式提交入口網站
  2. 選取 建立外掛程式
  3. 選擇提交類型:
    • 僅含技能的外掛程式,請選擇僅限技能
    • 僅含遠端 MCP 的外掛程式,請選擇包含 MCP
    • 結合遠端 MCP 伺服器與上傳 或透過 MCP 匯入之技能的外掛程式,請選擇包含 MCP

填寫表單時,入口網站會將提交內容儲存為草稿。

填寫表單

資訊

填寫公開上架資訊與發布者欄位:

  • 外掛程式名稱: 使用面向客戶的產品或工作流程名稱。
  • 說明: 說明外掛程式能協助使用者完成哪些事。簡短說明應保持精簡, 詳細說明則用來介紹工作流程的細節。
  • 開發人員身分: 為發布者選取 已驗證的個人或企業身分。
  • 標誌與類別: 使用可供正式發布的品牌素材。
  • 網站、支援、隱私權與條款 URL: 使用與發布者相符的公開 URL, 並揭露相關的資料處理方式。
已填妥發布者與政策 URL 的「資訊」分頁

提交前,請對照隱私權政策檢查 MCP 回應。從工具回應中移除不必要的個人資料、身分驗證機密、偵錯酬載、內部識別碼,以及未揭露的使用者相關欄位。

MCP

若提交內容包含遠端 MCP 伺服器:

  1. 選擇 MCP 伺服器 URL 類型:
    • 若所有使用者與組織都能使用同一個固定的 MCP 伺服器 URL, 請選擇 通用
    • 只有在 OpenAI 已核准使用工作區專屬 URL 時,才能選擇 範本 , 例如每位客戶都有獨立的租用戶、工作區, 或代管 MCP 端點的情況。
  2. 輸入所需的 URL:
    • 若選擇 通用,請輸入正式環境的 MCP 伺服器 URL
    • 若選擇 範本,請同時輸入 MCP 伺服器範例 URLMCP 伺服器 範本 URL。範例必須是實際可用的端點, 符合範本格式,且能搭配提交的測試憑證使用。
  3. 設定身分驗證;若伺服器需要登入,請提供可供審查人員直接使用的示範憑證。
  4. 定義內容安全性政策,明確允許 UI 擷取資料時所使用的網域。
  5. 若入口網站顯示 網域尚未驗證的驗證要求, 請完成網域驗證。使用 MCP 主機名稱或其上層主機名稱的 HTTPS 來源, 並在 /.well-known/openai-apps-challenge 提供完全相符的 Token。
  6. 選取 掃描工具
  7. 檢查找到的工具、匯入的技能、網域、驗證輸出,以及工具中繼資料。
  8. 修正伺服器、技能或中繼資料的問題,部署修正後再重新掃描。
掃描示範 MCP 伺服器後,顯示中繼資料建議的 MCP 分頁

若使用 OAuth 的外掛程式需要支援工作區網域限制, 請將授權伺服器設定為宣告提供 UserInfo 端點, 並讓該端點傳回使用者的 email 宣告與 email_verified: true。提交前, 請確認提供者也已宣告並啟用 openidemail 範圍。你也可以在 ID Token 中傳回這些宣告, 但工作區網域限制仍必須使用 UserInfo 端點。若提供者 不支援這些要求,請與提供者合作新增支援。請參閱 支援工作區網域限制

MCP 伺服器範本 URL

大多數外掛程式應使用 通用。MCP 伺服器範本 URL 僅限於不同使用者群組或資料群組需要不同 MCP 伺服器 URL 的少數情況。OpenAI 僅對已建立合作關係 且值得信任的開發人員提供範本 URL 支援。若 OpenAI 尚未核准你 使用範本 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

範例 URL 必須在審查期間可公開存取。請勿在 MCP 伺服器範例 URL 欄位中輸入預留位置 URL。如需完整的 MCP 審查要求,請參閱 MCP 伺服器範本 URL

請勿輸入現有整合服務的 ID,也不要嘗試讓入口網站指向已發布的整合服務。提交時必須直接提供 MCP 伺服器 URL 與審查資料,即使該伺服器已為 ChatGPT 或 Codex 中發布的整合服務提供支援,也不例外。

網域驗證

包含 MCP 的外掛程式必須驗證其對伺服器所在網域的控制權。當入口網站顯示網域驗證要求時,請在產生的 well-known URL 提供完全相符的驗證 Token:

https://<challenge-base-host>/.well-known/openai-apps-challenge

驗證端點只能傳回該外掛程式的驗證 Token。請勿從同一個 URL 傳回 JSON、Token 清單或多個 Token。

驗證基底 URL 是選填的 HTTPS 來源,用來告知入口網站 應在何處檢查 Token。它必須使用 MCP 主機名稱或其上層主機名稱。 路徑會被忽略。例如,若 MCP 伺服器 URL 是 https://api.example.com/mcp,則預設的驗證 URL 為 https://api.example.com/.well-known/openai-apps-challenge。 若你能在 https://example.com 提供 Token, 也可以將它用作上層來源的驗證基底。

如果兩個包含 MCP 的外掛程式使用相同的主機名稱,僅路徑不同,它們也會共用同一個預設驗證 URL。由於路徑會被忽略,你無法在「驗證基底 URL」中填入不同的租用戶路徑來分別驗證。請使用能提供新 Token 的上層來源,或為 MCP 伺服器設定不同的主機名稱;如果這兩種代管方式都不可行,請聯絡 OpenAI 支援團隊。

若另一個包含 MCP 的外掛程式已使用相同的主機名稱,除非該外掛程式不再需要既有的驗證 Token,否則請勿替換它。請為新的提交內容使用允許的上層來源作為「驗證基底 URL」,或使用不同的 MCP 主機名稱。

每個工具都應具備清楚的名稱、說明、結構描述與輸出結構。若輸出結構描述有助於審查人員和模型理解工具傳回的內容,請加入輸出結構描述。

請依照各工具的實際行為設定工具註解:

註解適用情況
readOnlyHint只有當工具會擷取、查詢、列出、取得、預覽或計算資訊,且不會變更任何內容時,才設為 true。若工具能建立、更新、刪除、傳送、加入佇列、執行作業、啟動工作流程、寫入記錄,或以其他方式改變狀態,請設為 false
openWorldHint當工具會存取公開網際網路或範圍不限的外部實體時,請設為 true,包括網頁搜尋等唯讀工具,以及能張貼內容、傳送訊息、發布內容、推送程式碼或提交表單的寫入工具。若工具僅限於範圍明確的私人帳戶或工作區,即使該服務由外部代管,也請設為 false
destructiveHint對於寫入工具,若工具能刪除、覆寫、撤銷存取權、傳送無法撤回的訊息或交易,或造成其他無法復原的副作用,請設為 true。否則,請設為 false

如需實作詳情,請參閱 工具註解與引導測試。 如需了解審查標準,請參閱 工具提示遭拒的相關指引

技能

以下任一方式皆可將技能新增至草稿:

  • 若提交內容僅包含技能,或同時包含技能與 MCP,請上傳最終版技能套件。
  • 若提交遠端 MCP,請從 MCP 伺服器匯入靜態技能。 選取 掃描工具時,OpenAI 會將這些技能匯入草稿。

請使用與本機測試時相同的檔案樹狀結構與指示。若要從 MCP 匯入技能, 請遵循 技能擴充功能草案與靜態資源資訊清單

可上傳技能套件的「技能」分頁

每項技能都應包含:

  • 清楚列出觸發條件與任務指示的 SKILL.md
  • 所有參照的指令碼、範本或素材。
  • 符合外掛程式用途、精簡且範圍明確的指示。

OpenAI 會掃描上傳及透過 MCP 匯入的技能,檢查是否符合政策及是否存在安全風險,包括敏感資訊、不必要的存取要求,以及可能與外掛程式安全或預期行為衝突的指示。技能必須遵循與外掛程式其他部分相同的標準;若未通過自動掃描,可能會導致無法提交,或需要修正。

OpenAI 從 MCP 匯入技能時,會擷取提交當下的快照。 已發布的外掛程式不會即時更新這些技能。在伺服器上變更技能後,請再次選取 掃描工具 ,並在提交新版外掛程式前 檢查更新後的技能。

若要移除所有透過 MCP 匯入的技能,請保持技能擴充功能啟用,並傳回 不含 nextCursor{ "skills": [] },然後重新掃描。 移除擴充功能,或傳回未通過驗證的回應,都會保留 先前的快照。

提示詞

新增起始提示詞,展示外掛程式最具價值的工作流程。好的提示詞應夠具體,讓使用者知道何時該使用外掛程式,同時也應保有通用性,方便使用者依需求調整。

範例:

  • 「調查上一個版本發布後的結帳錯誤,並彙整可能的根本原因。」
  • 「根據最新的支援工單及相關部署,撰寫一份 P1 事件簡報。」
  • 「審查部署失敗的記錄,並建議下一個偵錯步驟。」
顯示起始提示詞範例的「提示詞」分頁

測試

提交至少五個正向測試案例和三個負向測試案例。

每個正向測試案例都應包含:

  • 使用者提示詞。
  • 工具、技能或工作流程的預期行為。
  • 預期的結果結構。
  • 重現案例所需的測試帳戶或預設測試資料。

每個負向測試案例都應包含:

  • 使用者提示詞或情境。
  • 預期的拒絕、釐清或安全替代行為。
  • 外掛程式不應完成所要求操作的原因。

使用審查人員無須瞭解內部背景即可執行的測試案例。如果外掛程式需要身分驗證,請確保審查人員使用提供的示範憑證,就能完成每項測試,無須 MFA、簡訊、電子郵件確認或私人網路存取權。

顯示 roll_dice 工具測試案例的「測試」分頁

全球

選擇要提供外掛程式的國家或地區。僅選擇發布者、產品、支援流程和法律條款都已準備好為當地使用者提供服務的地點。

用於設定可用國家與地區的「全球」分頁

提交

提交前,請檢查完整草稿。

在版本資訊中簡要說明:

  • 外掛程式的功能。
  • 這是首次提交還是更新。
  • 如果先前曾提交過版本,請說明這次有哪些變更。
  • 審查人員應瞭解的測試憑證、預期資料或設定相關事項。

確認刊登資訊、伺服器、 技能、提示詞、測試及可用地區皆正確無誤後,才能完成政策遵循聲明。接著選取 提交審查

顯示版本資訊及最終聲明的「提交」分頁

公開發布流程

提交外掛程式會啟動審查,不會立即發布外掛程式。公開提供外掛程式的流程如下:

  1. 透過外掛程式提交入口網站提交外掛程式。
  2. OpenAI 會審查提交內容。隨著 OpenAI 建立審查流程並擴大審查規模,審查所需時間可能有所不同。
  3. OpenAI 核准外掛程式後,開發者可自行決定發布時間,並從入口網站發布。
  4. 發布後,外掛程式會顯示在 ChatGPT 與 Codex 共用的統一外掛程式目錄中。

僅含 MCP、僅含技能,以及結合技能與 MCP 的外掛程式,都會顯示在外掛程式目錄中。

已發布 MCP 中繼資料版本的運作方式

發布後,OpenAI 會定期擷取您的 MCP 工具。已刪除的工具 會在掃描偵測到後立即移除。新增或變更的工具定義 會在通過自動化檢查後開放使用;若更新暫緩,則會繼續使用先前的 定義。請參閱 持續審查與工具更新

若要變更已提交的外掛程式資訊或已匯入的技能,仍須建立新版本, 並經過審查與發布。

最終檢查清單

提交前,請確認:

  • 提交者具有 應用程式管理 的寫入權限。
  • 發布者的開發者或企業身分已通過驗證。
  • 含有 UI 的外掛程式已針對元件擷取資料的確切網域定義內容安全性政策。
  • 工具名稱、說明、結構描述及註解均符合實際行為。
  • 每個工具的 readOnlyHintopenWorldHintdestructiveHint 值皆正確無誤。
  • 工具回應不含非必要的個人資料、身分驗證機密、偵錯酬載、內部識別碼,或未揭露的使用者相關欄位。
  • 已使用最終檔案樹在本機測試技能。
  • 起始提示詞呈現貼近實際使用情境的使用者工作流程。
  • 提交內容包含五個正向測試案例和三個負向測試案例。

若提交內容包含遠端 MCP,還需確認:

  • MCP 伺服器使用可公開存取的正式環境 URL。
  • 審查人員的憑證可正常使用,無須 MFA、電子郵件確認、簡訊確認或私人網路存取權。
  • 從 MCP 匯入的技能與最新的 掃描工具 快照一致。
  • 隱私權政策、條款、支援及網站的 URL 皆可公開存取,且與發布者身分一致。