Översikt

Arbetsytans administratörer kan importera en marknadsplats för pluginer från GitHub till arbetsytans katalog. En marknadsplats är en JSON-katalog som listar de pluginer som ska importeras. Efter importen hålls pluginerna uppdaterade med ändringar från förvaret genom daglig synkronisering.


Marknadsplatssynkroniseringen importerar plugininnehåll – den ansluter inte arbetsytans medlemmars konton och ger inte åtkomst till apparna som ingår i en plugin.


En introduktion till pluginer och apparna som ingår finns i: Pluginer i ChatGPT och Codex.

Innan du börjar

• Använd ett GitHub-konto som har läsåtkomst till marknadsplatsens förvar och alla andra förvar som den refererar till. Offentliga och privata förvar på github.com stöds.

• Se till att kontot som används för importen får de godkännanden från GitHub-organisationen som krävs för åtkomst till dessa förvar.

• Granska innehållet i förvaret. Importen bearbetar alla giltiga pluginer utan separat godkännande för varje plugin, och framtida synkroniseringar kan lägga till nya pluginer.

Nya pluginer har från början installationspolicyn Tillgänglig och autentisering vid installation. Automatisk daglig synkronisering är aktiverad för nya marknadsplatser. Efter importen granskar du varje plugins arbetsyteinställningar och obligatoriska appar.

Importera en marknadsplats

1. Gå till Administratörskonsolen, välj önskad ChatGPT-arbetsyta och öppna Pluginer. Välj sedan Lägg till och därefter Importera marknadsplats.

2. I Källa anger du förvarets URL, till exempel https://github.com/example/team-plugins. Använd endast förvarets URL, inte en URL till en gren eller mapp.

3. Om marknadsplatsen finns i en underkatalog anger du den katalogen i Sökväg. Ange till exempel team-tools för team-tools/.agents/plugins/marketplace.json. Lämna Sökväg tomt för att använda förvarets rotkatalog. Ange inte manifestets filnamn.

4. Du kan även ange en Gren, tagg eller commit. Lämna fältet tomt för att använda förvarets standardgren. Använd en gren för att få framtida ändringar. Om du anger en specifik commit används alltid den versionen.

5. Välj Importera marknadsplats och godkänn GitHub-åtkomst när du uppmanas att göra det.

6. Granska Importresultat och öppna sedan varje importerad plugin för att konfigurera dess installationspolicy och eventuella obligatoriska appar.

Den första importen kan ta upp till 1 timme för mycket stora marknadsplatser. Efterföljande dagliga synkroniseringar tar vanligtvis några minuter.

Om en plugin inte kan importeras förklaras felet i rapporten. Andra giltiga pluginer kan fortfarande importeras.

Format som stöds

Den valda katalogen måste innehålla ett manifest som stöds:

• .agents/plugins/marketplace.json för en Codex-marknadsplats.

• .claude-plugin/marketplace.json för en Claude-kompatibel marknadsplats.

• .claude-plugin/plugin.json för en fristående Claude-plugin när inget marknadsplatsmanifest finns.

Marknadsplatsposter kan referera till pluginmappar i samma förvar eller till GitHub-förvar som stöds som källor. Import till arbetsytan stöder inte andra Git-värdtjänster eller källor i paketregister som npm.

Information om format som stöds, JSON-exempel och källfält finns i: Pluginhantering.

Konfigurera åtkomst i arbetsytan

GitHub tillhandahåller plugininnehållet, medan arbetsytans inställningar styr installation och autentisering. Vid import och synkronisering tillämpas inte policyvärden från förvaret, som AVAILABLE eller ON_USE. Konfigurera dessa inställningar för varje plugin i din arbetsyta.


Använd Installationspolicy för att välja Tillgänglig eller Installerad för varje berättigad roll. Obligatoriska appar måste också vara aktiverade, och medlemmarna måste ha åtkomst till den anslutna tjänsten och slutföra eventuell autentisering som krävs.


Pluginens arbetsytepolicyer bevaras när en uppdatering synkroniseras eller när en befintlig plugin övergår till GitHub-hantering. När en plugin importeras ges ingen appåtkomst och medlemmarnas konton ansluts inte.


Information om navigering i arbetsytan, appåtkomst och arbetsytekontroller finns i: Administratörskontroller, säkerhet och efterlevnad för pluginer och appar.

Håll pluginer uppdaterade

Nya marknadsplatser söker efter uppdateringar dagligen. Så begär du en uppdatering utan att vänta på automatisk synkronisering:

1. Gå till Administratörskonsolen, välj önskad ChatGPT-arbetsyta och öppna Pluginer.

2. Öppna Marknadsplatser och välj marknadsplatsen.

3. Välj Synkronisera nu.

Synkroniseringen kan lägga till nya poster från marknadsplatsen och uppdatera befintliga pluginer. Granska ändringar i förvaret innan du slår samman dem, eftersom automatisk synkronisering kan importera nya pluginer utan ett nytt importsteg.

Granska synkroniseringsresultat

Granska synkroniseringens status och sparade rapport när den är klar. Slutförd – N fel betyder att synkroniseringen slutfördes, men att vissa pluginer inte kunde bearbetas.


Om en uppdatering av en befintlig plugin är ogiltig behålls den senaste fungerande versionen. Andra giltiga uppdateringar kan fortfarande slutföras. Åtgärda det rapporterade problemet i GitHub och välj sedan Synkronisera nu för att försöka igen.


Om alternativet Uppdatera visas i administratörsvyn för en separat importerad plugin använder du det för att uppdatera den pluginen. Uppdatera pluginlistan läser bara in listan som visas på nytt. Det synkroniserar inte från GitHub.

Skillnaden mellan att ta bort och radera

Om du tar bort en post från förvaret raderas inte den importerade kopian i arbetsytan. Pluginen markeras som Finns inte längre i källan.


Om du raderar marknadsplatsen i ChatGPT raderas alla pluginer som importerats från den. Radera inte en marknadsplats för att återansluta GitHub eller byta ägare.

Återanslut eller ändra GitHub-åtkomst

Marknadsplatssynkroniseringen använder GitHub-anslutningen för den administratör som importerade marknadsplatsen. Det kontot behöver fortsatt åtkomst till marknadsplatsens förvar och alla förvar som den refererar till.

Återanslut det ursprungliga kontot

1. Kontrollera att GitHub-kontot som användes för importen fortfarande har åtkomst till alla nödvändiga förvar.

2. Be administratören som ursprungligen importerade marknadsplatsen att öppna GitHub-pluginen i ChatGPT och återansluta sitt konto.

Överför till en ny administratör

Arbetsytans nya administratör kan importera samma marknadsplats med sin egen GitHub-anslutning:

1. Gå till Administratörskonsolen, välj önskad ChatGPT-arbetsyta och öppna Pluginer. Välj sedan Lägg till > Importera marknadsplats.

2. Ange samma värden för Källa, Sökväg och Gren, tagg eller commit som används för den befintliga marknadsplatsen.

3. Välj Importera marknadsplats och godkänn GitHub-åtkomst när du uppmanas att göra det.

Framtida synkroniseringar använder den nya administratörens GitHub-anslutning. Den nya administratörens konto måste ha läsåtkomst till marknadsplatsens förvar och alla förvar som den refererar till.

Övergå till GitHub-hantering för en befintlig plugin

Du kan använda en marknadsplats för att hantera en befintlig plugin i arbetsytan som laddats upp som ett arkiv eller ännu inte hanteras via en GitHub-källa. Den befintliga pluginen måste finnas i samma arbetsyta och ha samma pluginnamn. En plugin som hanteras via en annan GitHub-källa kan inte tas över på det här sättet.


Så identifierar du den befintliga pluginen i din marknadsplats:

1. Gå till Administratörskonsolen, välj önskad ChatGPT-arbetsyta och öppna Pluginer. Öppna pluginen.

2. Kopiera plugin-ID:t som står efter /admin/plugins/ i dess URL.

3. Lägg till detta ID som pluginId bredvid name och source i motsvarande post i marknadsplatsens plugins-array. Lägg inte till det i pluginens plugin.json-fil.

Pluginen behåller sitt ID, sina delningsinställningar och sina arbetsytepolicyer. GitHub blir källan för framtida uppdateringar, så pluginen kan inte längre ersättas genom att ladda upp ett arkiv.


Ett migreringsexempel och information om kraven finns i: Pluginhantering.

Referera till en befintlig app

En plugin kan referera till en befintlig app i .app.json i pluginens rotkatalog. Ta med den inledande punkten i filnamnet och använd appens ID, inte ett plugin-ID. För en plugin i det inbyggda formatet anger du ./.app.json i fältet apps i .codex-plugin/plugin.json.


Referensen skapar ingen app och ger inga ytterligare behörigheter. Appens befintliga regler för åtkomst i arbetsytan, autentisering, åtgärdskontroller och behörigheter i anslutna tjänster gäller fortfarande.


Information om JSON-formatet finns i: Pluginhantering.

Vad betyder märkningen Endast i skrivbordsappen?

En plugin märkt Endast i skrivbordsappen kan inte köras i ChatGPT på webben. Importerade pluginer kan få denna märkning när de deklarerar MCP-servrar, till exempel i mcp.json eller .mcp.json, även om en server använder en extern HTTPS-URL.


Att lägga till en .app.json-referens räcker inte i sig för att ta bort märkningen Endast i skrivbordsappen. Alla appar som pluginen refererar till måste fortfarande vara tillgängliga för medlemmens roll, och apparnas vanliga krav på åtkomst och autentisering gäller.