如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

向 OpenAI 提交 Claude Code 外掛程式

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

如果你已發布 Claude Code 外掛程式或連接器,請依其中包含的元件(技能、MCP 伺服器或兩者)選擇提交方式。

現有內容 提交方式
有技能,沒有 MCP 伺服器 上傳僅含技能的外掛程式。
公開的 HTTPS MCP 端點 建立遠端 MCP 提交草稿。如有技能,請一併加入同一份草稿。
本機 MCP 伺服器 請參閱提交僅限桌面版的外掛程式,確認提交資格並依照說明提交。

Claude 對 Claude Code 外掛程式和 MCP 連接器採用不同的提交流程。OpenAI 採用單一外掛程式套件格式,可包含技能、MCP 伺服器或兩者。Claude 市集的上架資訊與核准結果不會轉移到 OpenAI。

如果外掛程式包含技能,無論採用哪種提交方式,都請先依照指示遵循指南檢查技能的指示。

提交僅含技能的外掛程式

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

確認 OpenAI 支援的內容

Claude 外掛程式的內容 處理方式
skills 將每個技能的 SKILL.md、指令碼、參考資料和資源檔放在一起。若要直接上傳 Claude 封存檔,封存檔中至少要有一個技能,其路徑為 skills/<skill-name>/SKILL.md。
資訊清單中宣告的自訂技能目錄 在封存檔中保留這些目錄,以及資訊清單中對應的宣告。
明確提及 Claude 的技能 將技能指示中專指 Claude 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。
commands、commands/、agents 或 agents/ 將可重複使用的行為轉換成技能。將每個 Markdown 指令轉換成一個技能,把可重複使用的智慧體作業流程移入技能,並將有用的角色設定指示併入相關技能。
hooks 或 hooks/hooks.json 提交至公開目錄前,請移除生命週期掛鉤。如果外掛程式依賴這些掛鉤,請以可供使用者在 Codex 桌面版手動安裝的方式發布。請參閱生命週期掛鉤。
userConfig 或 ${user_config.*} OpenAI 不會執行 Claude 的安裝提示,也不會展開 user_config 變數。請依照取代 Claude 的 userConfig 一節操作。如果外掛程式需要憑證或必須保留使用者設定,請使用 MCP 伺服器。
會建立或更新 Claude 即時成品的技能 OpenAI 目前不支援 Claude 即時成品。請移除要求建立、重新開啟、重新整理或更新成品的指示,改為在對話中直接輸出成品的內容,例如將成品中的表格顯示為一般表格。成品專屬的 HTML、持久儲存、重新整理行為與互動功能都不會保留。
bin/、settings、settings.json、CLAUDE.md 或 .claude/settings*.json 在外掛程式中保留必要的輔助程式和指示。使用相對於套件的路徑呼叫隨附的執行檔,並移除 Claude 專用設定。
outputStyles、lspServers、experimental.themes、experimental.monitors、channels 或 dependencies 將必要的行為移入技能,再移除 Claude 的對應宣告。如果核心工作流程需要接收頻道訊息,請聯絡你的 OpenAI 合作夥伴。
.claude-plugin/plugin.json 若要直接上傳 Claude 封存檔,請保留這份資訊清單。提交入口網站會將其轉換為 .codex-plugin/plugin.json。
.claude-plugin/marketplace.json、.mcp.json、mcpServers、.app.json 或 apps 請勿依賴這些檔案或宣告。僅含技能的上傳套件不包含 MCP 伺服器設定,也無法透過參照來提交現有的 MCP 伺服器整合。

準備並上傳封存檔

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

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

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

如果伺服器有穩定且公開的 HTTPS 網址,且 OpenAI 能連上該網址,請選擇這種提交方式。即使 Claude 外掛程式原本使用本機伺服器,只要已將伺服器部署為遠端服務,就可以用這種方式提交。

確認 OpenAI 支援的內容

Claude 整合的內容 處理方式
遠端 MCP 伺服器 沿用現有的伺服器實作。提交穩定、公開且使用 Streamable HTTP 的 HTTPS 端點。
本機 MCP 伺服器或 Claude Desktop 擴充功能(.mcpb) 將 MCP 伺服器部署至公開的 HTTPS 網址,或依照提交僅限桌面版的外掛程式的說明提交本機 MCP 外掛程式。提交入口網站不接受 .mcpb 檔案。
技能或資訊清單中宣告的自訂技能目錄 選擇含 MCP 時,請在同一份提交草稿中加入這些技能。將每個技能的 SKILL.md 與其指令碼、參考資料和資源檔放在一起。
明確提及 Claude 的技能 將技能指示中專指 Claude 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。
commands、commands/、agents 或 agents/ 將可重複使用的行為轉換成技能。將每個 Markdown 指令轉換成一個技能,把可重複使用的智慧體作業流程移入技能,並將有用的角色設定指示併入相關技能。
hooks 或 hooks/hooks.json 提交至公開目錄前,請移除生命週期掛鉤。如果外掛程式依賴這些掛鉤,請以可供使用者在 Codex 桌面版手動安裝的方式發布。請參閱生命週期掛鉤。
userConfig 或 ${user_config.*} OpenAI 不會執行 Claude 的安裝提示,也不會展開 user_config 變數。請依照取代 Claude 的 userConfig 一節,視各個值的用途,改用明確的輸入參數、OAuth、託管儲存空間或 Codex 本機設定。
會建立或更新 Claude 即時成品的技能 OpenAI 目前不支援 Claude 即時成品。請移除要求建立、重新開啟、重新整理或更新成品的指示,改為在對話中直接輸出成品的內容,例如將成品中的表格顯示為一般表格。成品專屬的 HTML、持久儲存、重新整理行為與互動功能都不會保留。
.app.json、apps 或現有的 MCP 伺服器整合 請直接提交 MCP 伺服器端點。無法透過參照來提交現有的 MCP 伺服器整合。
outputStyles、lspServers、experimental.themes、experimental.monitors、channels 或 dependencies 將必要的行為移入技能或 MCP 工具,再移除 Claude 的對應宣告。如果核心工作流程需要接收頻道訊息,請聯絡你的 OpenAI 合作夥伴。

準備並提交 MCP 伺服器

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

提交前,請先為以下兩項設定做好準備:

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

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

取代 Claude 的 userConfig

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

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

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

完成提交前的必要事項

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

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

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