AIREITER

Портал отправки плагинов Claude: пошаговое руководство

Последнее обновление: 2026-09-25 19:04:17

Чтобы отправить плагин 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, об отказе при отправке и процессе аудита.

Перед отправкой пройдитесь по этому списку:

  1. Заявите и опишите каждый внешний сервис, к которому выполняются исходящие обращения.
  2. Объясните в README разрешения, настройку, поток данных и сроки хранения.
  3. Убедитесь, что отслеживаемая ссылка указывает на код, который вы действительно собираетесь опубликовать.
  4. Повторяйте валидацию после каждого исправляющего коммита.
  5. Раскройте информацию о фоновой индексации, телеметрии и ресурсоемких автоматических действиях.

FAQ: отправка плагина Claude

Репозиторий GitHub обязательно должен быть публичным?

Да. В актуальной документации Anthropic указано, что репозиторий должен быть публичным до публикации записи в каталоге.

Можно ли отправить несколько плагинов из одного репозитория?

Да, но каждая папка плагина оформляется как отдельная отправка. Для каждого плагина укажите соответствующий путь в портале.

Можно ли отправить плагин через pull request в репозиторий сообщества?

Нет. В README репозитория community marketplace Anthropic называет его зеркалом, доступным только для чтения, и сообщает, что прямые pull request автоматически закрываются. Используйте портал разработчика.

Нужно ли отдельно отправлять удаленный MCP-сервер?

Если плагин обращается к удаленному MCP-серверу, которым вы управляете, и этот сервер еще не опубликован, отправьте его отдельно как MCP-коннектор.

Что делать, если валидация завершилась ошибкой?

Исправьте репозиторий, отправьте изменения и запустите проверку заново. Валидация относится к конкретному коммиту. После отправки используйте проверку новых коммитов в портале, если она доступна.

Публикуется ли плагин автоматически после успешного сканирования?

Не всегда. Для версии, прошедшей проверку, все равно может потребоваться нажать Publish и дождаться публикации проверяющим. Способ обработки следующих успешных версий зависит от настройки автоматической публикации в портале.

Можно ли убрать опубликованный плагин из каталога?

Да. Откройте опубликованный плагин в портале разработчика и отправьте запрос Delist plugin. Anthropic предупреждает, что изменение может не сразу появиться во всех приложениях Claude, а существующие пользователи могут перестать получать обновления.

Для публичной публикации схема простая: сделать репозиторий открытым, выполнить локальную валидацию, отправить Plugin bundle, исправить найденные проблемы в нужном коммите, заполнить разделы о данных и соответствии требованиям, а затем опубликовать прошедшую проверку версию. Если публичный каталог не оправдывает затраты на ревью и поддержку, пакет для команды лучше оставить приватным.