Чтобы отправить плагин Claude в публичный каталог, откройте портал разработчика Anthropic: claude.ai/directory/manage. Сейчас путь выглядит так: Submit new → Plugin bundle. Но одной формы недостаточно: понадобится публичный репозиторий на GitHub, подходящие тариф и роль, а сам плагин должен пройти проверку.
Как сейчас отправляют плагины Claude
Официальный процесс начинается с документации Anthropic по отправке плагинов, а не с публичного репозитория GitHub Marketplace. Каждый каталог плагина отправляется отдельно — даже если в одном репозитории находятся несколько плагинов.
| Что потребуется | Актуальное требование |
|---|---|
| Страница отправки | 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
Манифест и README содержат большую часть информации для карточки в каталоге. До отправки проверьте лицензию плагина и все внешние сервисы, с которыми он работает.
2. Выполните локальную проверку
Перейдите в каталог, содержащий папку плагина, и выполните:
claude plugin validate ./<plugin-folder>
Команда выявляет проблемы со структурой и форматированием. Однако на портале шаг Validate выполняет дополнительные проверки, поэтому локальную валидацию стоит считать предварительным тестом, а не официальным одобрением.
3. При необходимости отправьте MCP-коннектор отдельно
Если плагин использует удаленный MCP-сервер, которым вы управляете, и этот сервер еще не отправлялся в каталог, Anthropic рекомендует зарегистрировать его отдельно как MCP connector. Пакет плагина и коннектор считаются разными записями каталога.
Как отправить пакет плагина
1. Выберите Plugin bundle
Откройте портал разработчика и нажмите Submit new. Когда появится вопрос о типе отправки, выберите Plugin bundle. Вариант MCP connector нужен только для отдельной публикации удаленного MCP-сервера.
2. Укажите репозиторий, путь и ветку
В разделе Source укажите:
- URL GitHub или значение в формате
owner/repo. - Plugin path, если файл
.claude-plugin/plugin.jsonнаходится не в корне репозитория. - Branch or tag, если каталог должен отслеживать не ветку по умолчанию.
Тег остается привязанным к своему коммиту, пока вы не измените сам тег. Если в имени ветки есть косая черта, укажите ее явно или используйте формат owner/repo@branch, описанный в официальном руководстве по отправке.
Нажмите Validate. Если найденная проблема блокирует отправку, исправьте репозиторий, отправьте изменения и запустите проверку заново. Результат валидации относится к конкретному коммиту.
3. Проверьте сформированную карточку
На шаге Listing details показано, как плагин будет выглядеть в каталоге. Anthropic берет эти данные из plugin.json и README.
Если нужно изменить название или краткое описание, внесите правки в исходные файлы. В официальном каталоге плагинов также предупреждают: опубликованный slug установки лучше не менять, иначе пользователи могут столкнуться с ошибкой plugin-not-found. Для обычных изменений формулировок используйте отображаемую подпись, а переименование с миграцией оставляйте для действительно необходимых случаев.
4. Ответьте на вопросы об обработке данных
На шаге Data handling портал спросит, делает ли плагин следующее:
- Читает или сохраняет персональные данные.
- Передает данные в сервисы, не заявленные как коннекторы.
- Хранит данные и, если да, то как долго.
- Ориентирован на пользователей младше 18 лет.
Отвечайте по фактической реализации. Укажите удаленные сервисы, доступ к файлам, телеметрию и правила хранения данных.
5. Подтвердите соответствие требованиям
В разделе Compliance укажите контактный email, по которому Anthropic сможет с вами связаться, и подтвердите необходимые пункты. Плагин должен соответствовать политике Software Directory Anthropic.
6. Отправьте плагин и настройте доставку обновлений
На шаге Review and submit проверьте введенные данные и выберите способ доставки новых версий:
- GitHub push webhook — в текущем руководстве этот вариант выбран по умолчанию; после настройки он может запускать проверки при отправке изменений.
- Scheduled check only — портал будет проверять отслеживаемую ветку или тег по расписанию.
Нажмите Submit for review. Для настройки webhook нужны права администратора GitHub. Сейчас Anthropic ограничивает организацию 10 отправками за любой 24-часовой период; сохраненные черновики и отозванные отправки тоже учитываются. Эти ограничения и параметры обновлений описаны в процессе отправки.
Что происходит после отправки
Anthropic сканирует последний коммит отслеживаемой ветки или тега, повторно запускает валидацию каталога и выполняет проверку безопасности. В официальном руководстве описаны следующие состояния:
| Статус | Что он означает | Что делать дальше |
|---|---|---|
| Passes every check | Версия готова к публикации | Нажать Publish |
| Held for a reviewer | Найденные проблемы должен закрыть проверяющий | Внести запрошенные изменения или дождаться проверки |
| Doesn’t pass | Портал показывает нарушенные правила или категорию проблемы безопасности | Исправить репозиторий и проверить новый коммит |
| Rejected | Отправка не одобрена | Изучить список необходимых изменений и использовать Resubmit for review |
Успешная проверка еще не означает, что версия уже доступна пользователям. Настройки по умолчанию могут требовать запроса на публикацию и ручного выпуска проверяющим; для некоторых последующих версий, прошедших проверку, портал поддерживает автоматическую публикацию.
Чтобы следить за процессом, откройте плагин в разделе Submissions и перейдите к Versions. После исправлений используйте Check for new commits, если эта кнопка доступна. Для выпуска обновлений достаточно отправить изменения в отслеживаемую ветку или переместить отслеживаемый тег — повторно заполнять форму не нужно. Последняя опубликованная версия остается доступной, пока новая не прошла проверку или ожидает ручного ревью.
Проверки безопасности, которые нельзя пропускать
В официальном каталоге Anthropic предупреждают: плагины могут включать MCP-серверы, файлы и другое программное обеспечение, не контролируемое Anthropic. До отправки зафиксируйте все внешние сервисы, разрешения, сроки хранения данных и фоновые действия.
«Я попросил его выяснить, почему мои отправки плагинов не прошли, и исправить проблему», — @tarasshyn, X, об отказе при отправке и процессе аудита.
Перед отправкой пройдитесь по этому списку:
- Заявите и опишите каждый внешний сервис, к которому выполняются исходящие обращения.
- Объясните в README разрешения, настройку, поток данных и сроки хранения.
- Убедитесь, что отслеживаемая ссылка указывает на код, который вы действительно собираетесь опубликовать.
- Повторяйте валидацию после каждого исправляющего коммита.
- Раскройте информацию о фоновой индексации, телеметрии и ресурсоемких автоматических действиях.
FAQ: отправка плагина Claude
Репозиторий GitHub обязательно должен быть публичным?
Да. В актуальной документации Anthropic указано, что репозиторий должен быть публичным до публикации записи в каталоге.
Можно ли отправить несколько плагинов из одного репозитория?
Да, но каждая папка плагина оформляется как отдельная отправка. Для каждого плагина укажите соответствующий путь в портале.
Можно ли отправить плагин через pull request в репозиторий сообщества?
Нет. В README репозитория community marketplace Anthropic называет его зеркалом, доступным только для чтения, и сообщает, что прямые pull request автоматически закрываются. Используйте портал разработчика.
Нужно ли отдельно отправлять удаленный MCP-сервер?
Если плагин обращается к удаленному MCP-серверу, которым вы управляете, и этот сервер еще не опубликован, отправьте его отдельно как MCP-коннектор.
Что делать, если валидация завершилась ошибкой?
Исправьте репозиторий, отправьте изменения и запустите проверку заново. Валидация относится к конкретному коммиту. После отправки используйте проверку новых коммитов в портале, если она доступна.
Публикуется ли плагин автоматически после успешного сканирования?
Не всегда. Для версии, прошедшей проверку, все равно может потребоваться нажать Publish и дождаться публикации проверяющим. Способ обработки следующих успешных версий зависит от настройки автоматической публикации в портале.
Можно ли убрать опубликованный плагин из каталога?
Да. Откройте опубликованный плагин в портале разработчика и отправьте запрос Delist plugin. Anthropic предупреждает, что изменение может не сразу появиться во всех приложениях Claude, а существующие пользователи могут перестать получать обновления.
Для публичной публикации схема простая: сделать репозиторий открытым, выполнить локальную валидацию, отправить Plugin bundle, исправить найденные проблемы в нужном коммите, заполнить разделы о данных и соответствии требованиям, а затем опубликовать прошедшую проверку версию. Если публичный каталог не оправдывает затраты на ревью и поддержку, пакет для команды лучше оставить приватным.