Огляд

Адміністратори робочого простору можуть імпортувати маркетплейс плагінів із 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. Скопіюйте ідентифікатор плагіна, розташований після /admin/plugins/ у його URL-адресі.

3. Додайте цей ідентифікатор як pluginId поруч із name та source у відповідному записі масиву plugins маркетплейсу. Не додавайте його до файлу plugin.json плагіна.

Плагін зберігає свій ідентифікатор, налаштування спільного доступу та політики робочого простору. GitHub стає джерелом подальших оновлень, тому наступні завантаження архівів не зможуть замінити плагін.


Приклад перенесення та вимоги див. у статті Керування плагінами.

Посилання на наявний застосунок

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


Це посилання не створює застосунок і не надає додаткових дозволів. Для застосунку й надалі діють наявні налаштування доступу в робочому просторі, автентифікації, керування діями та дозволів підключеного сервісу.


Опис формату JSON див. у статті Керування плагінами.

Що означає позначка «Лише на комп’ютері»

Плагін із позначкою Лише на комп’ютері не може працювати у вебверсії ChatGPT. Імпортовані плагіни можуть отримати цю позначку, якщо в них оголошено сервери MCP, наприклад у файлі mcp.json або .mcp.json, навіть якщо сервер використовує віддалену HTTPS-адресу.


Саме по собі додавання посилання у файлі .app.json не знімає позначку Лише на комп’ютері. Будь-який застосунок, на який є посилання, має бути доступним для ролі учасника; до нього й надалі застосовуються звичайні вимоги щодо доступу та автентифікації.