AIREITER

Claude Plugin 提交入口:一步步完成送審與發布

最近更新: 2026-09-25 19:02:39

如果你正在找 Claude plugin 的提交入口,直接前往 Anthropic 開發者入口:claude.ai/directory/manage。目前的操作路徑是Submit new → Plugin bundle。不過,要讓 plugin 正式上架,還必須準備公開的 GitHub 儲存庫、符合資格的方案與角色,並通過審查。

目前的 Claude plugin 提交流程

官方流程是從 Anthropic 的plugin 提交文件開始,而不是前往公開的 GitHub marketplace 儲存庫。即使同一個儲存庫裡放了多個 plugin,每個 plugin 資料夾仍然要分開提交。

需要準備的項目目前要求
提交頁面claude.ai/directory/manage
提交類型Plugin bundle
來源在 listing 上線前,必須使用公開的 GitHub 儲存庫
存取資格必須使用可提交至 directory 的方案與角色
審查需要通過驗證與安全掃描;部分版本會暫停並交由審查人員處理
發布通過審查的版本仍然需要發布

本文介紹的是公開 directory 發布流程,不涵蓋私人團隊分享或本機安裝 plugin。

開啟提交入口前,先準備好這些項目

建議先把儲存庫整理好,再開啟提交入口。

1. 將 plugin 放到 GitHub

directory 會從 github.com 讀取 plugin,而 Anthropic 要求儲存庫必須在 listing 上線前設為公開。如果 plugin 不在儲存庫根目錄,也要先記下它所在的資料夾路徑。

標準的 Claude Code plugin 通常會包含:

plugin-name/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json          # optional
├── commands/          # optional
├── agents/            # optional
├── skills/            # optional
└── README.md

directory listing 的許多資訊會取自 manifest 和 README。提交前,也請確認 plugin 的授權條款與外部服務內容。

2. 先在本機執行驗證

請在包含 plugin 資料夾的目錄中執行:

claude plugin validate ./<plugin-folder>

這個指令可以先找出結構與格式問題,但入口網站中的Validate步驟還會進行額外檢查。換句話說,本機驗證只是第一關,不能視為已經獲得批准。

3. 必要時分開提交 MCP connector

如果你的 plugin 使用了由你營運、且尚未提交的遠端 MCP server,Anthropic 文件要求你另外將該 server 以MCP connector提交。plugin bundle 與 connector 會是兩個不同的 directory listing。

逐步提交一個 Plugin bundle

1. 選擇 Plugin bundle

開啟開發者入口後,選取Submit new。當系統詢問要提交什麼內容時,選擇Plugin bundle。只有在要把遠端 MCP server 獨立列為一個 listing 時,才選擇MCP connector。

2. 填入儲存庫、路徑與分支

在Source中提供:

  • GitHub URL 或 owner/repo。
  • 如果 .claude-plugin/plugin.json 不在儲存庫根目錄,填入Plugin path。
  • 如果 directory 要追蹤的不是預設分支,填入Branch or tag。

指定 tag 後,系統會一直使用該 tag 所指向的 commit,直到你修改 tag。如果分支名稱包含斜線,請明確填入分支名稱,或使用官方提交指南所述的 owner/repo@branch 格式。

選取Validate。如果發現問題導致無法提交,先修正儲存庫、推送變更,再重新驗證。每次驗證結果只適用於單一 commit。

3. 檢查系統產生的 listing

Listing details步驟會顯示 plugin 在 directory 中的呈現方式。Anthropic 會從 plugin.json 與 README 讀取這些內容。

如果名稱或簡短描述需要修改,請回到來源檔案調整。Anthropic 的官方 plugin directory也提醒,已發布的安裝 slug 應維持穩定,否則使用者可能遇到 plugin-not-found。一般文字調整請使用顯示標籤;只有在確實需要遷移時,才使用重新命名對應。

4. 回答資料處理問題

Data handling步驟會詢問 plugin 是否:

  • 讀取或儲存個人資料。
  • 將資料傳送至已宣告 connector 以外的服務。
  • 保留資料,以及保留多久。
  • 以未滿 18 歲的人士為目標對象。

請根據實際實作回答,並納入遠端服務、檔案存取、遙測資料與保留政策等資訊。

5. 完成合規聲明

在Compliance頁面,確認 Anthropic 能聯絡到你的電子郵件地址,並勾選必要的確認項目。Plugin 必須符合 Anthropic 的Software Directory 政策。

6. 提交並選擇更新方式

在Review and submit頁面確認資料,並選擇新版本的取得方式:

  • GitHub push webhook:目前指南中的預設選項;完成設定後,推送變更可以觸發檢查。
  • Scheduled check only:只依靠系統對目前追蹤的分支或 tag 進行檢查。

選取Submit for review。設定 webhook 需要 GitHub 管理員權限。Anthropic 目前限制每個組織在任何 24 小時期間最多提交 10 次,而儲存的草稿與撤回的提交也會計入限制。這些限制與更新設定都記載於提交流程文件中。

提交之後會發生什麼事?

Anthropic 會掃描目前追蹤分支或 tag 上的最新 commit,重新執行 directory 驗證,並進行安全掃描。官方指南列出以下幾種狀態:

狀態代表意義下一步
Passes every check這個版本符合發布資格選取Publish
Held for a reviewer需要審查人員確認並處理發現的問題依照要求修改,或等待審查
Doesn’t pass入口網站列出未通過的規則或安全分類修正儲存庫,然後檢查新的 commit
Rejected提交未獲批准查看要求的修改內容,並使用Resubmit for review

通過檢查不代表版本一定已經上線。預設設定可能要求先提出發布請求,再由審查人員發布;入口網站也支援讓部分後續通過檢查的版本自動發布。

你可以在Submissions中開啟 plugin,並查看Versions掌握進度。完成修正後,如果畫面提供Check for new commits,請使用該功能。日後更新時,只要推送到目前追蹤的分支,或移動目前追蹤的 tag,不需要重新填寫提交表單。當新版本失敗或等待審查時,最後一個已發布的版本仍會維持上線。

開發者不能跳過的安全檢查

Anthropic 的官方 directory 提醒,plugin 可能包含 MCP server、檔案,以及其他不在 Anthropic 控制範圍內的軟體。提交前,請逐一記錄所有外部服務、權限、資料保留期間與背景操作。

「我的意思是,我請它稽核 plugin 提交失敗的原因,並修正問題。」— @tarasshyn,X,描述一次提交失敗與稽核流程。

提交前可以依照這份清單檢查:

  1. 宣告並記錄每一個對外連線的服務。
  2. 在 README 說明權限、設定方式、資料流向與保留政策。
  3. 確認目前追蹤的 ref 包含你準備發布的程式碼。
  4. 每次修正並產生新的 commit 後,都重新驗證。
  5. 揭露背景索引、遙測資料,或可能產生高額成本的自動化行為。

FAQ:Claude plugin 提交

GitHub 儲存庫一定要公開嗎?

是。Anthropic 目前的文件指出,儲存庫必須在 listing 上線前設為公開。

可以從同一個儲存庫提交多個 plugin 嗎?

可以,但每個 plugin 資料夾都要個別提交。在入口網站中,分別填入每個 plugin 的路徑即可。

可以透過向 community repository 發送 pull request 來提交嗎?

不行。Anthropic 的community marketplace README說明,該儲存庫是唯讀鏡像,直接提交的 pull request 會自動關閉。請改用開發者入口。

遠端 MCP server 需要另外提交嗎?

如果你的 plugin 使用了由你營運、且尚未列出的遠端 MCP server,就必須另外以 MCP connector 的形式提交。

驗證失敗時該怎麼辦?

修正儲存庫、推送變更,然後重新驗證。驗證結果只適用於特定 commit。提交之後,如果入口網站提供新 commit 檢查功能,也請使用該功能。

通過掃描後,plugin 會自動發布嗎?

不一定。通過檢查的版本仍可能需要選取Publish,再由審查人員發布。至於後續通過檢查的版本如何處理,則取決於入口網站的自動發布設定。

可以將已發布的 plugin 下架嗎?

可以。在開發者入口中開啟已上線的 plugin,並提出Delist plugin請求。Anthropic 表示,這項變更可能需要一些時間才會同步到每個 Claude app,而現有使用者也可能不再收到更新。

如果你要發布公開 listing,最精簡的流程就是:將儲存庫設為公開、先在本機驗證、提交Plugin bundle、修正針對特定 commit 的問題、完成資料處理與合規步驟,最後發布通過檢查的版本。如果公開審查與後續維護的成本不值得,則應讓只供團隊使用的套件維持私人狀態。