如果你已發布 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 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。 |
commands、commands/、agents 或 agents/ | 將可重複使用的行為轉換為技能。將每個 Markdown 指令轉換為一項技能,將可重複使用的智慧體程序移入技能,並將有用的角色設定指示整合至相關技能中。 |
hooks 或 hooks/hooks.json | 調整指令掛勾,使其適用於 Codex 掛勾執行環境,包括 ChatGPT Work 和 Codex。掛勾指令碼必須存在於執行環境中,並在執行前獲得信任。一般對話中請勿依賴掛勾;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 伺服器整合。 |
準備並上傳封存檔
- 確認封存檔的根目錄或其唯一的頂層目錄中,包含
.claude-plugin/plugin.json,且其中的description不為空,並在skills/<skill-name>/SKILL.md至少包含一項有效技能。 - 開啟外掛程式提交入口網站, 選取「 建立外掛程式」,選擇「 僅含技能」,然後上傳封存檔。
- 審查產生的
.codex-plugin/plugin.json。入口網站會在轉換時補上缺少的 介面預設值,並將文字欄位正規化。 - 在乾淨的環境中測試匯入的技能。確認每項技能都能找到其參照的檔案與執行檔,且不依賴未宣告的本機套件、檔案或憑證。
- 填妥上架與審查欄位,修正所有掃描結果指出的問題,然後提交草稿。
如果封存檔不符合直接上傳的條件,請依照 封裝外掛程式的說明,建立 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 的用語改為不限定供應商的說法,例如「模型」。只有在指示確實適用於該產品時,才保留產品名稱。 |
commands、commands/、agents 或 agents/ | 將可重複使用的行為轉換為技能。將每個 Markdown 指令轉換為一項技能,將可重複使用的智慧體程序移入技能,並將有用的角色設定指示整合至相關技能中。 |
hooks 或 hooks/hooks.json | 調整指令掛勾,使其適用於 Codex 掛勾執行環境,包括 ChatGPT Work 和 Codex。掛勾指令碼必須存在於執行環境中,並在執行前獲得信任。一般對話中請勿依賴掛勾;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 伺服器
- 使用 Streamable HTTP 將 MCP 伺服器部署至正式環境的 HTTPS 端點。當伺服器存取使用者的私人資料或代替使用者 執行動作時,請使用 OAuth 2.1。請依照驗證使用者身分中的說明, 遵循支援的產品需求與 MCP 授權規格。
- 新增準確的工具結構描述與安全註解。測試每個工具,確認它們都能連線、完成身分驗證、傳回預期格式的結果,並在執行寫入或破壞性動作時要求預定的確認。
- 將所有指令或智慧體轉換為技能,並確認技能不依賴未宣告的本機套件、檔案或憑證。
- 開啟外掛程式提交入口網站, 選取 建立外掛程式,選擇 包含 MCP,然後提交正式環境的 端點。如有轉換後的技能,請一併加入同一份草稿。
- 驗證伺服器網域;如果伺服器要求登入,請設定身分驗證。填妥上架資訊與審查欄位,修正所有掃描結果指出的問題,然後提交草稿。
提交前,請先規劃以下兩項設定步驟:
- 網域驗證: 你必須能在 MCP 主機或允許的上層主機上,
透過
/.well-known/openai-apps-challenge提供與入口網站所給內容完全一致的 Token。 入口網站提示時,請完成驗證挑戰。請參閱 設定 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 合作夥伴。這些情況可能需要針對特定產品進行審查。