Обзор

Администраторы рабочей области могут импортировать маркетплейс плагинов из GitHub в каталог своей рабочей области. Маркетплейс — это каталог в формате JSON со списком плагинов для импорта. После импорта ежедневная синхронизация обновляет плагины с учётом изменений в репозитории.


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


Общие сведения о плагинах и входящих в их состав приложениях см. в статье «Плагины в ChatGPT и Codex».

Перед началом работы

• Используйте аккаунт GitHub с доступом на чтение к репозиторию маркетплейса и ко всем репозиториям, на которые он ссылается. Поддерживаются публичные и приватные репозитории на github.com.

• Получите все необходимые одобрения организации GitHub, чтобы аккаунт, используемый для импорта, имел доступ к этим репозиториям.

• Проверьте содержимое репозитория. При импорте обрабатываются все плагины без ошибок, без отдельного одобрения каждого из них. Последующие синхронизации могут добавлять новые плагины.

Для новых плагинов изначально задана политика установки Доступен и аутентификация при установке. Для новых маркетплейсов включена автоматическая ежедневная синхронизация. После импорта проверьте настройки каждого плагина в рабочей области и необходимые ему приложения.

Импорт маркетплейса

1. Перейдите в консоль администратора, выберите нужную рабочую область ChatGPT и откройте раздел Плагины. Затем нажмите Добавить и выберите Импортировать маркетплейс.

2. В поле Источник введите URL репозитория, например https://github.com/example/team-plugins. Укажите только URL репозитория, без пути к ветке или папке.

3. Если маркетплейс находится во вложенной папке, укажите её в поле Путь. Например, для team-tools/.agents/plugins/marketplace.json введите team-tools. Для корневой папки репозитория оставьте поле Путь пустым. Не вводите имя файла манифеста.

4. При необходимости заполните поле Ветка, тег или коммит. Оставьте его пустым, чтобы использовать ветку репозитория по умолчанию. Укажите ветку, чтобы получать изменения из новых коммитов. Если указать конкретный коммит, версия останется неизменной.

5. Нажмите Импортировать маркетплейс и предоставьте доступ к GitHub, когда появится запрос.

6. Просмотрите Результаты импорта, затем откройте каждый импортированный плагин и настройте его политику установки и необходимые приложения.

Первоначальный импорт очень крупных маркетплейсов может занять до 1 часа. Последующие ежедневные синхронизации обычно занимают несколько минут.

Если плагин не удастся импортировать, в отчёте будет указана причина ошибки. При этом другие плагины без ошибок могут быть импортированы.

Поддерживаемые форматы

Выбранная папка должна содержать манифест поддерживаемого формата:

• .agents/plugins/marketplace.json — для маркетплейса Codex.

• .claude-plugin/marketplace.json — для маркетплейса, совместимого с Claude.

• .claude-plugin/plugin.json — для отдельного плагина Claude при отсутствии манифеста маркетплейса.

Записи маркетплейса могут ссылаться на папки плагинов в том же репозитории или на поддерживаемые источники в репозиториях GitHub. Импорт в рабочую область не поддерживает другие Git-хостинги и источники из реестров пакетов, таких как npm.

Поддерживаемые форматы, примеры JSON и поля источников см. в разделе «Управление плагинами».

Настройка доступа в рабочей области

GitHub предоставляет содержимое плагинов, а настройки рабочей области определяют порядок установки и аутентификации. При импорте и синхронизации значения политик из репозитория, такие как AVAILABLE или ON_USE, не применяются. Задайте эти настройки для каждого плагина в своей рабочей области.


В разделе Политика установки выберите Доступен или Установлен для каждой подходящей роли. Необходимые приложения также должны быть включены, а участники должны иметь доступ к подключённому сервису и пройти требуемую аутентификацию.


При синхронизации обновления плагина или переводе существующего плагина под управление GitHub его политики в рабочей области сохраняются. Импорт плагина не предоставляет доступ к приложениям и не подключает аккаунты участников.


Сведения о навигации по рабочей области, доступе к приложениям и средствах управления рабочей областью см. в статье «Администрирование, безопасность и соответствие требованиям для плагинов и приложений».

Обновление плагинов

Для новых маркетплейсов проверка обновлений выполняется ежедневно. Чтобы запросить обновление, не дожидаясь автоматической синхронизации:

1. Перейдите в консоль администратора, выберите нужную рабочую область ChatGPT и откройте раздел Плагины.

2. Откройте раздел Маркетплейсы и выберите нужный маркетплейс.

3. Нажмите Синхронизировать сейчас.

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

Просмотр результатов синхронизации

После синхронизации проверьте её статус и сохранённый отчёт. Статус Завершено — ошибок: N означает, что синхронизация завершилась, но некоторые плагины не удалось обработать.


Если обновление существующего плагина содержит ошибки, сохраняется его последняя рабочая версия. При этом остальные обновления без ошибок могут быть выполнены. Исправьте указанную в отчёте проблему в GitHub, затем нажмите Синхронизировать сейчас, чтобы повторить попытку.


Если в интерфейсе администратора для отдельно импортированного плагина есть кнопка Обновить, используйте её для обновления этого плагина. Кнопка Обновить список плагинов лишь перезагружает отображаемый список и не запускает синхронизацию с GitHub.

Как работает удаление

При удалении записи из репозитория её импортированная копия в рабочей области не удаляется. Плагин получает метку Больше нет в источнике.


При удалении маркетплейса в ChatGPT удаляются все импортированные из него плагины. Не удаляйте маркетплейс, чтобы повторно подключить GitHub или сменить владельца.

Повторное подключение или изменение доступа к GitHub

Для синхронизации маркетплейса используется подключение к GitHub администратора, который его импортировал. У этого аккаунта должен сохраняться доступ к репозиторию маркетплейса и ко всем репозиториям, на которые он ссылается.

Повторное подключение исходного аккаунта

1. Убедитесь, что аккаунт GitHub, использованный для импорта, по-прежнему имеет доступ ко всем необходимым репозиториям.

2. Попросите администратора, который изначально импортировал маркетплейс, открыть плагин GitHub в ChatGPT и повторно подключить свой аккаунт.

Передача новому администратору

Новый администратор рабочей области может импортировать тот же маркетплейс через собственное подключение к GitHub:

1. Перейдите в консоль администратора, выберите нужную рабочую область ChatGPT и откройте раздел Плагины. Затем выберите Добавить > Импортировать маркетплейс.

2. В полях Источник, Путь и Ветка, тег или коммит укажите те же значения, что и для существующего маркетплейса.

3. Нажмите Импортировать маркетплейс и предоставьте доступ к GitHub, когда появится запрос.

При последующих синхронизациях будет использоваться подключение к GitHub нового администратора. У аккаунта нового администратора должен быть доступ на чтение к репозиторию маркетплейса и ко всем репозиториям, на которые он ссылается.

Перевод существующего плагина под управление GitHub

С помощью маркетплейса можно управлять существующим плагином рабочей области, который был загружен в виде архива или ещё не управляется через источник GitHub. Существующий плагин должен находиться в той же рабочей области и иметь то же имя. Таким способом нельзя перехватить управление плагином, который уже управляется через другой источник GitHub.


Чтобы указать существующий плагин в маркетплейсе:

1. Перейдите в консоль администратора, выберите нужную рабочую область ChatGPT и откройте раздел Плагины. Откройте плагин.

2. Скопируйте ID плагина, указанный после /admin/plugins/ в его URL.

3. Добавьте этот ID в поле pluginId рядом с name и source в соответствующей записи массива plugins маркетплейса. Не добавляйте его в файл plugin.json плагина.

ID плагина, настройки общего доступа и политики рабочей области сохранятся. Источником дальнейших обновлений станет GitHub, поэтому заменить плагин загрузкой архива больше не получится.


Пример переноса и требования см. в разделе «Управление плагинами».

Ссылка на существующее приложение

Плагин может ссылаться на существующее приложение в файле .app.json в корневой папке плагина. Не забудьте точку в начале имени файла и используйте ID приложения, а не плагина. Для нативного плагина задайте полю apps в файле .codex-plugin/plugin.json значение ./.app.json.


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


Описание формата JSON см. в разделе «Управление плагинами».

Что означает метка «Только в приложении для компьютера»

Плагин с меткой Только в приложении для компьютера не может работать в веб-версии ChatGPT. Импортированные плагины могут получить эту метку, если в них объявлены MCP-серверы, например в файле mcp.json или .mcp.json, даже если сервер использует удалённый HTTPS-адрес.


Само по себе добавление ссылки в .app.json не снимает метку Только в приложении для компьютера. Любое приложение, на которое ссылается плагин, по-прежнему должно быть доступно для роли участника. К нему применяются обычные требования к доступу и аутентификации.