AIREITER

Claude 插件提交门户:一步步完成提交

最后更新: 2026-09-25 19:01:30

如果你正在寻找 Claude 插件提交入口,直接打开 Anthropic 的开发者门户:claude.ai/directory/manage。当前流程是选择提交新内容 → 插件包。不过,插件要真正上线,还必须满足几个条件:使用公开的 GitHub 仓库,提交者拥有符合要求的套餐和权限,并通过审核。

当前的 Claude 插件提交流程

官方流程应从 Anthropic 的插件提交文档开始,而不是去公开的 GitHub marketplace 仓库提 Pull Request。同一个仓库里即使包含多个插件,也必须为每个插件文件夹分别提交。

准备事项当前要求
提交页面claude.ai/directory/manage
提交类型Plugin bundle
源代码插件上线前必须使用公开的 GitHub 仓库
访问权限使用具备目录提交权限的套餐和角色
审核需要通过验证和安全扫描;部分版本会进入人工审核
发布通过检查后仍需执行发布操作

本文讲的是面向公开目录的分发,不包括团队内部共享或本地安装插件。

打开门户前,先把仓库准备好

建议在进入提交页面之前,先完成仓库整理和自检。

1. 将插件放入 GitHub

目录会从 github.com 读取插件。Anthropic 要求仓库在插件上线前必须公开。如果插件不在仓库根目录,还要记下它所在的文件夹路径。

一个标准的 Claude Code 插件通常包含以下结构:

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

目录页面的大部分信息会从 manifest 和 README 中读取。提交前,请确认插件的许可证以及它依赖的外部服务。

2. 先在本地跑一遍验证

在包含插件文件夹的目录中运行:

claude plugin validate ./<plugin-folder>

这一步可以发现结构和格式问题,但门户中的验证还会执行额外检查。把本地命令当作初筛即可,不能视为已经获批。

3. 必要时单独提交 MCP 连接器

如果插件引用了一个由你运营、且尚未提交过的远程 MCP 服务器,Anthropic 的指南要求你将该服务器作为MCP connector单独提交。插件包和连接器会成为两个不同的目录条目。

按步骤提交一个插件包

1. 选择 Plugin bundle

打开开发者门户,选择提交新内容。当页面询问提交类型时,选择Plugin bundle。只有在将远程 MCP 服务器作为独立条目提交时,才选择MCP connector。

2. 填写仓库、路径和分支

在源代码页面填写:

  • GitHub URL 或 owner/repo。
  • 如果 .claude-plugin/plugin.json 不在仓库根目录,填写插件路径。
  • 如果目录需要跟踪默认分支以外的内容,填写分支或标签。

标签会一直指向它当前对应的提交,除非你主动更改标签。如果分支名包含斜杠,请明确填写分支名,或者使用官方提交指南中介绍的 owner/repo@branch 格式。

点击验证。如果发现阻止提交的问题,修复仓库后推送改动,再重新验证。一次验证只对应一个提交。

3. 检查自动生成的目录页面

目录详情页面会展示插件在目录中的最终样子。Anthropic 会从 plugin.json 和 README 中读取这些信息。

如果名称或简介需要修改,应回到源文件中调整。Anthropic 的官方插件目录还提醒,已发布插件的安装 slug 应保持稳定,否则用户可能遇到 plugin-not-found。普通措辞调整使用显示名称即可;只有确实需要迁移时,才使用重命名映射。

4. 如实填写数据处理信息

数据处理页面会询问插件是否:

  • 读取或存储个人数据。
  • 向已声明的连接器之外的其他服务发送数据。
  • 保留数据,以及保留多长时间。
  • 面向 18 岁以下人群。

请根据实际实现回答,并把远程服务、文件访问、遥测和数据保留行为都考虑进去。

5. 完成合规确认

在合规页面确认 Anthropic 可以联系到你的邮箱,并勾选要求的确认项。插件必须符合 Anthropic 的软件目录政策。

6. 提交审核并选择更新方式

在检查并提交页面确认信息,然后选择新版本的获取方式:

  • GitHub 推送 webhook:当前指南中默认选择此项;配置完成后,推送代码可以触发检查。
  • 仅定时检查:依赖系统对所跟踪分支或标签进行检查。

点击提交审核。配置 webhook 需要 GitHub 管理员权限。Anthropic 当前限制每个组织任意 24 小时内最多提交 10 次,已保存的草稿和主动撤回的提交也会计入这一限制。相关限制和更新设置详见提交流程文档。

提交后会发生什么

Anthropic 会扫描所跟踪分支或标签上的最新提交,重新执行目录验证,并进行安全扫描。官方指南列出了以下几种状态:

状态含义下一步
通过所有检查该版本具备发布资格选择发布
等待审核需要审核人员处理相关问题按要求修改,或等待审核完成
未通过门户列出了不符合的规则或安全类别修复仓库,然后检查新的提交
被拒绝提交未获批准查看修改要求,然后使用重新提交审核

通过检查并不代表版本已经上线。默认设置可能仍要求发起发布请求,并由审核人员完成发布;对于之后通过检查的版本,门户也支持自动发布设置。

在提交记录中打开插件,查看版本页面即可跟踪进度。完成修复后,如果页面提供该选项,请点击检查新提交。后续更新时,只需向所跟踪的分支推送代码,或移动所跟踪的标签,不需要重新填写提交表单。当新版本失败或等待审核时,最近一次已发布的版本仍会继续提供服务。

这些安全检查不能省

Anthropic 的官方目录提醒,插件可能包含 MCP 服务器、文件以及其他不受 Anthropic 控制的软件。提交前,应记录每个外部服务、权限、数据保留期限和后台行为。

“我的意思是,我让它审计我的插件提交为什么失败,并修复了这个问题。”——@tarasshyn 在X上的说法,描述了一次提交失败和审计流程。

提交前可以按下面的清单逐项确认:

  1. 声明并记录所有对外连接的服务。
  2. 在 README 中说明权限、安装设置、数据流向和保留期限。
  3. 确认所跟踪的引用包含你准备发布的代码。
  4. 每次修复并生成新提交后,重新执行验证。
  5. 披露后台索引、遥测,以及可能产生较高成本的自动化行为。

Claude 插件提交 FAQ

GitHub 仓库必须公开吗?

是。Anthropic 当前文档说明,仓库必须在目录条目上线前公开。

一个仓库可以提交多个插件吗?

可以,但每个插件文件夹都要单独提交。在门户中分别填写对应的路径即可。

可以向社区仓库提 Pull Request 提交吗?

不可以。Anthropic 的社区 marketplace README说明,该仓库是只读镜像,直接提交的 Pull Request 会被自动关闭。请使用开发者门户。

远程 MCP 服务器需要单独提交吗?

如果插件引用了由你运营、且尚未列出的远程 MCP 服务器,就需要将它作为 MCP connector 单独提交。

验证失败后怎么办?

修复仓库、推送改动,然后重新验证。验证结果只对应特定提交。提交插件后,如果门户提供检查新提交的选项,也应使用该功能。

扫描通过后会自动发布插件吗?

不一定。通过检查的版本仍可能需要点击发布,并等待审核人员完成发布。之后通过检查的版本如何处理,由门户中的自动发布设置决定。

可以将已经发布的插件下架吗?

可以。在开发者门户中打开线上插件,然后申请下架插件。Anthropic 表示,这一变化可能需要一段时间才能同步到所有 Claude 应用,现有用户也可能不再收到更新。

如果目标是发布公开目录条目,最短路径就是:公开仓库,在本地完成验证,提交Plugin bundle,根据具体提交反馈修复问题,完成数据处理和合规步骤,最后发布通过检查的版本。如果目录的覆盖范围不足以抵消公开审核和后续维护成本,则应继续将团队内部使用的插件包保持为私有。