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

將你的 Claude Code 外掛程式提交至 OpenAI

將 Claude Code 外掛程式或連接器轉換為可提交至 OpenAI 的外掛程式。

如果你已發布 Claude Code 外掛程式或連接器,請根據其中包含技能、MCP 伺服器,還是兩者皆有,選擇提交方式。

現有內容應提交的內容
只有技能,沒有 MCP 伺服器上傳僅含技能的外掛程式
公開的 HTTPS MCP 端點建立遠端 MCP 提交申請。如有技能,請一併加入同一份草稿。
本機 MCP 伺服器將其部署至公開的 HTTPS URL。如果無法部署,請聯絡你的 OpenAI 聯絡窗口,尋求本機 MCP 支援。

Claude Code 外掛程式與 MCP 連接器在 Claude 各有獨立的提交流程。OpenAI 則使用單一外掛程式套件,可包含技能、MCP 伺服器或兩者。Claude 市集的上架資訊與核准結果不會移轉。

如果你的外掛程式包含技能,請在透過任一途徑提交技能前,依照 指令遵循指引 審查技能的指令。

提交僅含技能的外掛程式

如果外掛程式不需要 MCP 伺服器,請選擇此提交方式。

確認 OpenAI 支援的內容

你的 Claude 外掛程式包含的內容處理方式
skills保留每項技能及其 SKILL.md、指令碼、參考資料和資源。直接上傳的 Claude 封存檔必須在 skills/<skill-name>/SKILL.md 至少包含一項技能。
資訊清單中宣告的自訂技能目錄在封存檔中保留這些目錄,以及資訊清單中對應的宣告。
明確提及 Claude 的技能將技能指示中專指 Claude 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。
commandscommands/agentsagents/將可重複使用的行為轉換為技能。將每個 Markdown 指令轉換為一項技能,將可重複使用的智慧體程序移入技能,並將有用的角色設定指示整合至相關技能中。
hookshooks/hooks.json調整指令掛勾,使其適用於 Codex 掛勾執行環境,包括 ChatGPT Work 和 Codex。掛勾指令碼必須存在於執行環境中,並在執行前獲得信任。一般對話中請勿依賴掛勾;Codex 不會執行提示詞或智慧體掛勾處理常式。
userConfig${user_config.*}OpenAI 不會執行 Claude 的安裝提示,也不會展開 user_config 變數。請依照替換 Claude userConfig 的說明操作。如果外掛程式需要憑證或需持續儲存的使用者設定,請使用 MCP 伺服器。
建立或更新 Claude 即時成品的技能OpenAI 目前不支援 Claude 即時成品。請移除要求建立、重新開啟、重新整理或更新成品的指示,改以一般對話輸出傳回其中的內容;例如,將成品中的表格呈現為標準表格。成品專屬的 HTML、持續儲存功能、重新整理行為與互動功能都不會保留。
bin/settingssettings.jsonCLAUDE.md.claude/settings*.json在外掛程式中保留必要的輔助程式與指示。使用相對於套件的路徑呼叫隨附的執行檔,並移除僅適用於 Claude 的設定。
outputStyleslspServersexperimental.themesexperimental.monitorschannelsdependencies將必要行為移入技能,再移除 Claude 宣告。如果核心工作流程需要接收傳入的頻道訊息,請聯絡你的 OpenAI 合作窗口。
.claude-plugin/plugin.json直接上傳 Claude 封存檔時,請保留資訊清單。入口網站會將其轉換為 .codex-plugin/plugin.json
.claude-plugin/marketplace.json.mcp.jsonmcpServers.app.jsonapps請勿依賴這些檔案或宣告。僅含技能的上傳內容不包含 MCP 伺服器組態,而且你無法以參照方式提交現有的 MCP 伺服器整合。

準備並上傳封存檔

  1. 確認封存檔的根目錄或其唯一的頂層目錄中,包含 .claude-plugin/plugin.json,且其中的 description 不為空,並在 skills/<skill-name>/SKILL.md 至少包含一項有效技能。
  2. 開啟外掛程式提交入口網站, 選取「 建立外掛程式」,選擇「 僅含技能」,然後上傳封存檔。
  3. 審查產生的 .codex-plugin/plugin.json。入口網站會在轉換時補上缺少的 介面預設值,並將文字欄位正規化。
  4. 在乾淨的環境中測試匯入的技能。確認每項技能都能找到其參照的檔案與執行檔,且不依賴未宣告的本機套件、檔案或憑證。
  5. 填妥上架與審查欄位,修正所有掃描結果指出的問題,然後提交草稿。

如果封存檔不符合直接上傳的條件,請依照 封裝外掛程式的說明,建立 OpenAI 資訊清單與套件目錄結構。技能的相關要求請參閱建立技能

提交含有遠端 MCP 伺服器的外掛程式

如果伺服器具有穩定、公開且 OpenAI 可連線的 HTTPS URL,請選擇此提交方式。伺服器先前可以是在 Claude 外掛程式中於本機執行;這種提交方式的重點是,你已將其部署為遠端服務。

確認 OpenAI 支援的內容

你的 Claude 整合包含的內容處理方式
遠端 MCP 伺服器沿用現有的伺服器實作。提交使用 Streamable HTTP 且穩定、公開的 HTTPS 端點。
本機 MCP 伺服器或 Claude Desktop 擴充功能(.mcpb將 MCP 伺服器部署至公開的 HTTPS URL。如果無法部署,請聯絡你的 OpenAI 聯絡窗口,尋求本機 MCP 支援。入口網站不接受 .mcpb 檔案。
技能或資訊清單中宣告的自訂技能目錄將技能一併加入同一份「 含 MCP 」提交申請。保留每份 SKILL.md 及其指令碼、參考資料和資源。
明確提及 Claude 的技能將技能指示中專指 Claude 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。
commandscommands/agentsagents/將可重複使用的行為轉換為技能。將每個 Markdown 指令轉換為一項技能,將可重複使用的智慧體程序移入技能,並將有用的角色設定指示整合至相關技能中。
hookshooks/hooks.json調整指令掛勾,使其適用於 Codex 掛勾執行環境,包括 ChatGPT Work 和 Codex。掛勾指令碼必須存在於執行環境中,並在執行前獲得信任。一般對話中請勿依賴掛勾;Codex 不會執行提示詞或智慧體掛勾處理常式。
userConfig${user_config.*}OpenAI 不會執行 Claude 的安裝提示,也不會展開 user_config 變數。請依照替換 Claude userConfig 的說明,將各個值改由明確的輸入、OAuth、託管儲存空間或 Codex 本機組態提供。
建立或更新 Claude 即時成品的技能OpenAI 目前不支援 Claude 即時成品。請移除要求建立、重新開啟、重新整理或更新成品的指示,改以一般對話輸出傳回其內容;例如,將成品中的表格呈現為標準表格。成品專屬的 HTML、持續儲存功能、重新整理行為及互動功能都不會保留。
.app.jsonapps 或現有的 MCP 伺服器整合直接提交 MCP 伺服器端點。你無法透過參照來提交現有的 MCP 伺服器整合。
outputStyleslspServersexperimental.themesexperimental.monitorschannelsdependencies將必要行為移至技能或 MCP 工具,再移除 Claude 宣告。如果核心工作流程需要接收傳入的頻道訊息,請聯絡你的 OpenAI 合作夥伴。

準備並提交 MCP 伺服器

  1. 使用 Streamable HTTP 將 MCP 伺服器部署至正式環境的 HTTPS 端點。當伺服器存取使用者的私人資料或代替使用者 執行動作時,請使用 OAuth 2.1。請依照驗證使用者身分中的說明, 遵循支援的產品需求與 MCP 授權規格。
  2. 新增準確的工具結構描述與安全註解。測試每個工具,確認它們都能連線、完成身分驗證、傳回預期格式的結果,並在執行寫入或破壞性動作時要求預定的確認。
  3. 將所有指令或智慧體轉換為技能,並確認技能不依賴未宣告的本機套件、檔案或憑證。
  4. 開啟外掛程式提交入口網站, 選取 建立外掛程式,選擇 包含 MCP,然後提交正式環境的 端點。如有轉換後的技能,請一併加入同一份草稿。
  5. 驗證伺服器網域;如果伺服器要求登入,請設定身分驗證。填妥上架資訊與審查欄位,修正所有掃描結果指出的問題,然後提交草稿。

提交前,請先規劃以下兩項設定步驟:

  • 網域驗證: 你必須能在 MCP 主機或允許的上層主機上, 透過 /.well-known/openai-apps-challenge 提供與入口網站所給內容完全一致的 Token。 入口網站提示時,請完成驗證挑戰。請參閱 設定 MCP 提交內容
  • OAuth 與工作區網域限制: 如果外掛程式使用 OAuth,請提供 UserInfo 端點,傳回使用者的 email 宣告及 email_verified: true。宣告並啟用 openidemail 範圍。 請參閱 支援工作區網域限制

提交前,請詳閱 遠端 MCP 伺服器審查要求

取代 Claude userConfig

OpenAI 外掛程式不會執行 Claude userConfig 安裝提示,也不會展開 ${user_config.*} 參照。請移除這些參照,並根據外掛程式使用各個值的方式, 以適當方式取代。

值所控制的項目OpenAI 替代方式
可隨任務變更的選擇新增明確的技能或 MCP 工具輸入。只在工作流程需要時,才詢問該值。
遠端服務的憑證透過遠端 MCP 伺服器使用 OAuth 2.1。請勿將機密資訊放入技能封存檔、資訊清單、指示或預設值中。
應持續保留的偏好設定將偏好設定儲存在託管服務中,並與已驗證身分的使用者建立關聯。讓使用者透過明確的工作流程或工具輸入來更新設定。
Codex 本機指令碼或掛鉤的設定使用有文件說明的環境變數或設定檔。使用前先檢查;若缺少設定,請傳回附有具體解決方式的錯誤訊息。請勿讓 ChatGPT 的核心工作流程依賴這項本機設定。
所有使用者皆相同的固定值將不含機密資訊的預設值放入技能指示或託管服務組態中。

如果僅含技能的外掛程式需要憑證,或需要在不同對話之間持續保留的設定,請新增 MCP 伺服器。為遠端伺服器使用 OAuth 與託管儲存空間。如果該值只影響目前的任務,請讓外掛程式維持僅含技能,並透過明確的技能輸入取得該值。

完成提交要求

無論提交哪一種外掛程式,都請先在將擁有該外掛程式的 OpenAI 組織中取得 應用程式管理 寫入權限。你也必須完成個人或 企業身分驗證。每個外掛程式都必須完成 OpenAI 審查。

如果外掛程式的核心價值需要本機執行、任意存取使用者電腦上的檔案、存取硬體或應用程式、離線運作,或接收傳入的頻道訊息,請在提交前聯絡你的 OpenAI 合作夥伴。這些情況可能需要針對特定產品進行審查。

如需完整的入口網站操作流程,請參閱 提交外掛程式。如果入口網站回報套件 驗證代碼,請查閱 提交錯誤參考資料