Přehled

Správci pracovního prostoru mohou importovat tržiště pluginů z GitHubu do katalogu svého pracovního prostoru. Tržiště je katalog ve formátu JSON se seznamem pluginů k importu. Po importu udržuje každodenní synchronizace pluginy aktuální podle změn v úložišti.


Synchronizace tržiště importuje obsah pluginů – nepropojuje účty členů pracovního prostoru ani neuděluje přístup k aplikacím zahrnutým v pluginu.


Úvod do pluginů a aplikací, které obsahují, najdete v článku Pluginy v ChatGPT a Codexu.

Než začnete

• Použijte účet GitHub s oprávněním ke čtení úložiště tržiště i všech dalších úložišť, na která odkazuje. Podporována jsou veřejná i soukromá úložiště na github.com.

• Zajistěte všechna schválení organizace na GitHubu potřebná k tomu, aby účet provádějící import mohl k těmto úložištím přistupovat.

• Zkontrolujte obsah úložiště. Import zpracuje všechny platné pluginy bez samostatného schvalování každého z nich a budoucí synchronizace mohou přidávat nové pluginy.

Nové pluginy mají výchozí zásadu instalace Dostupný a ověřování při instalaci. Nová tržiště mají zapnutou automatickou každodenní synchronizaci. Po importu zkontrolujte u každého pluginu nastavení v pracovním prostoru a požadované aplikace.

Import tržiště

1. Přejděte do Konzole správce, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Poté vyberte Přidat a zvolte Importovat tržiště.

2. Do pole Zdroj zadejte URL úložiště, například https://github.com/example/team-plugins. Použijte pouze URL úložiště, nikoli URL konkrétní větve nebo složky.

3. Pokud je tržiště v podadresáři, zadejte tento adresář do pole Cesta. Například pro team-tools/.agents/plugins/marketplace.json zadejte team-tools. Pro kořenový adresář úložiště ponechte pole Cesta prázdné. Nezadávejte název souboru manifestu.

4. Volitelně vyplňte pole Větev, tag nebo commit. Pokud ho ponecháte prázdné, použije se výchozí větev úložiště. Chcete-li přijímat budoucí commity, použijte větev. Při zadání konkrétního commitu zůstane obsah na dané revizi.

5. Vyberte Importovat tržiště a po zobrazení výzvy povolte přístup ke GitHubu.

6. Zkontrolujte Výsledky importu a poté otevřete každý importovaný plugin a nastavte jeho zásady instalace a případné požadované aplikace.

U velmi velkých tržišť může první import trvat až 1 hodinu. Následné každodenní synchronizace obvykle trvají několik minut.

Pokud plugin nelze importovat, najdete v reportu vysvětlení chyby. Ostatní platné pluginy lze přesto importovat.

Podporované formáty

Vybraný adresář musí obsahovat podporovaný manifest:

• .agents/plugins/marketplace.json pro tržiště Codex.

• .claude-plugin/marketplace.json pro tržiště kompatibilní s Claude.

• .claude-plugin/plugin.json pro samostatný plugin Claude, pokud není přítomen manifest tržiště.

Položky tržiště mohou odkazovat na složky pluginů ve stejném úložišti nebo na podporované zdroje v úložištích na GitHubu. Import do pracovního prostoru nepodporuje jiné hostingové služby pro Git ani zdroje z registrů balíčků, jako je npm.

Podporované formáty, příklady JSON a pole pro určení zdroje najdete v článku Správa pluginů.

Nastavení přístupu v pracovním prostoru

GitHub poskytuje obsah pluginů, zatímco nastavení pracovního prostoru řídí instalaci a ověřování. Import ani synchronizace nepřebírají hodnoty zásad z úložiště, například AVAILABLE nebo ON_USE. Tato nastavení nakonfigurujte u každého pluginu ve svém pracovním prostoru.


V části Zásady instalace vyberte pro každou způsobilou roli možnost Dostupný nebo Nainstalovaný. Požadované aplikace musí být také povolené a členové musí mít přístup k připojené službě a dokončit případné požadované ověření.


Synchronizace aktualizace pluginu ani převod existujícího pluginu pod správu GitHubu nemění jeho zásady v pracovním prostoru. Import pluginu neuděluje přístup k aplikacím ani nepropojuje účty členů.


Informace o navigaci v pracovním prostoru, přístupu k aplikacím a ovládacích prvcích pracovního prostoru najdete v článku Správcovské ovládací prvky, zabezpečení a dodržování předpisů pro pluginy a aplikace.

Udržování pluginů v aktuálním stavu

U nových tržišť se aktualizace kontrolují každý den. Pokud chcete požádat o aktualizaci bez čekání na automatickou synchronizaci:

1. Přejděte do Konzole správce, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy.

2. Otevřete Tržiště a vyberte příslušné tržiště.

3. Vyberte Synchronizovat nyní.

Synchronizace může přidat nové položky tržiště a aktualizovat existující pluginy. Před sloučením změn v úložišti je zkontrolujte, protože automatická synchronizace může importovat nové pluginy bez dalšího ručního importu.

Kontrola výsledků synchronizace

Po synchronizaci zkontrolujte její stav a uložený report. Stav Dokončeno — počet chyb: N znamená, že synchronizace skončila, ale některé pluginy se nepodařilo zpracovat.


Pokud je aktualizace existujícího pluginu neplatná, zachová se jeho poslední funkční verze. Ostatní platné aktualizace se přesto mohou dokončit. Opravte nahlášený problém na GitHubu a poté vyberte Synchronizovat nyní pro další pokus.


Pokud se v rozhraní správce u jednotlivě importovaného pluginu zobrazuje možnost Obnovit, použijte ji k aktualizaci daného pluginu. Možnost Obnovit seznam pluginů pouze znovu načte zobrazený seznam; nespouští synchronizaci z GitHubu.

Jak funguje odebrání a smazání

Odebráním položky z úložiště se nesmaže její kopie importovaná do pracovního prostoru. Plugin se označí jako Již není ve zdroji.


Smazáním tržiště v ChatGPT se smažou všechny pluginy, které z něj byly importovány. Tržiště nemažte, pokud chcete znovu připojit GitHub nebo změnit vlastníka.

Obnovení nebo změna přístupu ke GitHubu

Synchronizace tržiště využívá připojení ke GitHubu správce, který tržiště importoval. Tento účet musí mít i nadále přístup k úložišti tržiště a ke všem úložištím, na která odkazuje.

Opětovné připojení původního účtu

1. Ověřte, že účet GitHub použitý při importu má stále přístup ke všem požadovaným úložištím.

2. Požádejte správce, který tržiště původně importoval, aby v ChatGPT otevřel plugin GitHub a znovu připojil svůj účet.

Převod na nového správce

Nový správce pracovního prostoru může importovat stejné tržiště pomocí svého vlastního připojení ke GitHubu:

1. Přejděte do Konzole správce, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Poté vyberte Přidat > Importovat tržiště.

2. Do polí Zdroj, Cesta a Větev, tag nebo commit zadejte stejné hodnoty jako u stávajícího tržiště.

3. Vyberte Importovat tržiště a po zobrazení výzvy povolte přístup ke GitHubu.

Budoucí synchronizace budou využívat připojení ke GitHubu nového správce. Účet nového správce musí mít oprávnění ke čtení úložiště tržiště i všech úložišť, na která odkazuje.

Převod existujícího pluginu pod správu GitHubu

Pomocí tržiště můžete spravovat existující plugin pracovního prostoru, který byl nahrán jako archiv nebo zatím není spravován ze zdroje na GitHubu. Existující plugin musí být ve stejném pracovním prostoru a mít stejný název. Takto nelze převzít správu pluginu, který už je spravován z jiného zdroje na GitHubu.


Existující plugin ve svém tržišti určíte takto:

1. Přejděte do Konzole správce, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Otevřete plugin.

2. Zkopírujte ID pluginu, které v jeho URL následuje za /admin/plugins/.

3. Přidejte toto ID jako pluginId vedle name a source do odpovídající položky v poli plugins tržiště. Nepřidávejte ho do souboru plugin.json daného pluginu.

Plugin si zachová své ID, nastavení sdílení a zásady pracovního prostoru. Zdrojem budoucích aktualizací se stane GitHub, takže plugin už nepůjde nahradit pozdějším nahráním archivu.


Příklad migrace a požadavky najdete v článku Správa pluginů.

Odkaz na existující aplikaci

Plugin může odkazovat na existující aplikaci v souboru .app.json v kořenovém adresáři pluginu. Nezapomeňte na tečku na začátku názvu souboru a použijte ID aplikace, nikoli ID pluginu. U nativního pluginu nastavte pole apps v souboru .codex-plugin/plugin.json na ./.app.json.


Odkaz nevytváří aplikaci ani neuděluje další oprávnění. Pro aplikaci nadále platí stávající nastavení přístupu v pracovním prostoru, ověřování, řízení akcí a oprávnění připojené služby.


Informace o formátu JSON najdete v článku Správa pluginů.

Co znamená označení Pouze pro desktop

Plugin s označením Pouze pro desktop nelze spustit v ChatGPT na webu. Importované pluginy mohou toto označení získat, pokud deklarují servery MCP, například v souboru mcp.json nebo .mcp.json, a to i tehdy, když server používá vzdálenou URL s protokolem HTTPS.


Přidání odkazu v souboru .app.json samo o sobě neodstraní označení Pouze pro desktop. Každá odkazovaná aplikace musí být i nadále dostupná pro roli daného člena a platí pro ni obvyklé požadavky na přístup a ověřování.