Visió general

Els administradors de l'espai de treball poden importar un mercat de connectors des de GitHub al directori del seu espai de treball. Un mercat és un catàleg JSON que enumera els connectors que s'han d'importar. Després de la importació, la sincronització diària manté els connectors al dia amb els canvis del repositori.


La sincronització del mercat importa el contingut dels connectors; no connecta els comptes dels membres de l'espai de treball ni concedeix accés a les aplicacions incloses en un connector.


Per obtenir una introducció als connectors i a les aplicacions que inclouen, consulta: Connectors a ChatGPT i Codex.

Abans de començar

• Utilitza un compte de GitHub amb accés de lectura al repositori del mercat i a tots els altres repositoris als quals fa referència. S'admeten repositoris públics i privats de github.com.

• Completa els tràmits d'aprovació que exigeixi l'organització de GitHub perquè el compte que fa la importació pugui accedir a aquests repositoris.

• Revisa el contingut del repositori. La importació processa tots els connectors vàlids sense un pas d'aprovació independent per a cadascun, i les sincronitzacions futures poden afegir connectors nous.

Els connectors nous tenen inicialment la política d'instal·lació Disponible i requereixen autenticació en instal·lar-los. Els mercats nous tenen habilitada la sincronització automàtica diària. Després de la importació, revisa la configuració de cada connector a l'espai de treball i les aplicacions que necessita.

Importa un mercat

1. Ves a la Consola d'administració, selecciona l'espai de treball de ChatGPT corresponent i obre Connectors. A continuació, selecciona Afegeix i tria Importa un mercat.

2. A Font, introdueix l'URL del repositori, com ara https://github.com/example/team-plugins. Utilitza només l'URL del repositori, no el d'una branca o carpeta.

3. Si el mercat és en un subdirectori, introdueix aquest directori a Camí. Per exemple, introdueix team-tools per a team-tools/.agents/plugins/marketplace.json. Deixa Camí buit per utilitzar l'arrel del repositori. No introdueixis el nom del fitxer manifest.

4. Opcionalment, introdueix una Branca, etiqueta o commit. Deixa el camp buit per utilitzar la branca per defecte del repositori. Utilitza una branca per rebre els commits futurs. Si fixes un commit, es mantindrà aquesta revisió.

5. Selecciona Importa un mercat i autoritza l'accés a GitHub quan se't demani.

6. Revisa els Resultats de la importació i, a continuació, obre cada connector importat per configurar-ne la política d'instal·lació i les aplicacions necessàries.

La importació inicial pot trigar fins a 1 hora en el cas de mercats molt grans. Les sincronitzacions diàries posteriors solen trigar uns minuts.

Si no es pot importar un connector, l'informe explica l'error. La resta de connectors vàlids es poden importar igualment.

Formats compatibles

El directori seleccionat ha de contenir un manifest compatible:

• .agents/plugins/marketplace.json per a un mercat de Codex.

• .claude-plugin/marketplace.json per a un mercat compatible amb Claude.

• .claude-plugin/plugin.json per a un connector independent de Claude quan no hi ha cap manifest de mercat.

Les entrades del mercat poden fer referència a carpetes de connectors del mateix repositori o a fonts de repositoris de GitHub compatibles. La importació a l'espai de treball no admet altres serveis d'allotjament Git ni fonts de registres de paquets, com ara npm.

Per obtenir informació sobre els formats compatibles, exemples JSON i els camps de font, consulta: Gestió de connectors.

Configura l'accés a l'espai de treball

GitHub proporciona el contingut dels connectors, mentre que la configuració de l'espai de treball controla la instal·lació i l'autenticació. La importació i la sincronització no apliquen els valors de les polítiques del repositori, com ara AVAILABLE o ON_USE. Configura aquests paràmetres per a cada connector del teu espai de treball.


Utilitza Política d'instal·lació per triar Disponible o Instal·lat per a cada rol que compleixi els requisits. També cal habilitar les aplicacions necessàries, i els membres han de tenir accés al servei connectat i completar l'autenticació que es requereixi.


Quan se sincronitza una actualització d'un connector o es passa a gestionar un connector existent des de GitHub, es conserven les seves polítiques de l'espai de treball. Importar un connector no concedeix accés a les aplicacions ni connecta els comptes dels membres.


Per obtenir informació sobre la navegació per l'espai de treball, l'accés a les aplicacions i els controls de l'espai de treball, consulta: Controls d'administració, seguretat i compliment normatiu per a connectors i aplicacions.

Mantén els connectors al dia

Els mercats nous comproven diàriament si hi ha actualitzacions. Per sol·licitar una actualització sense esperar la sincronització automàtica:

1. Ves a la Consola d'administració, selecciona l'espai de treball de ChatGPT corresponent i obre Connectors.

2. Obre Mercats i selecciona el mercat.

3. Selecciona Sincronitza ara.

La sincronització pot afegir entrades noves del mercat i actualitzar els connectors existents. Revisa els canvis del repositori abans de fusionar-los, perquè la sincronització automàtica pot importar connectors nous sense cap pas d'importació addicional.

Revisa els resultats de la sincronització

Després d'una sincronització, revisa'n l'estat i l'informe desat. Completada — N errors vol dir que la sincronització ha acabat, però que no s'han pogut processar alguns connectors.


Si una actualització d'un connector existent no és vàlida, se'n conserva l'última versió que funcionava. La resta d'actualitzacions vàlides es poden completar igualment. Corregeix el problema indicat a GitHub i, a continuació, selecciona Sincronitza ara per tornar-ho a provar.


Si la vista d'administració mostra Actualitza per a un connector importat individualment, utilitza aquesta opció per actualitzar-lo. Actualitza la llista de connectors només torna a carregar la llista que es mostra; no la sincronitza amb GitHub.

Entén què passa quan retires o suprimeixes contingut

Retirar una entrada del repositori no suprimeix la còpia que se n'ha importat a l'espai de treball. El connector es marca com a Ja no és a la font.


Si suprimeixes el mercat a ChatGPT, se suprimeixen tots els connectors que se n'han importat. No suprimeixis un mercat per tornar a connectar GitHub o canviar-ne el propietari.

Torna a connectar o canvia l'accés a GitHub

La sincronització del mercat utilitza la connexió de GitHub de l'administrador que l'ha importat. Aquest compte ha de mantenir l'accés al repositori del mercat i a tots els repositoris als quals fa referència.

Torna a connectar el compte original

1. Confirma que el compte de GitHub utilitzat per a la importació encara té accés a tots els repositoris necessaris.

2. Demana a l'administrador que va importar originalment el mercat que obri el connector de GitHub a ChatGPT i torni a connectar el seu compte.

Transfereix la gestió a un administrador nou

El nou administrador de l'espai de treball pot importar el mateix mercat amb la seva pròpia connexió de GitHub:

1. Ves a la Consola d'administració, selecciona l'espai de treball de ChatGPT corresponent i obre Connectors. A continuació, selecciona Afegeix > Importa un mercat.

2. Introdueix els mateixos valors de Font, Camí i Branca, etiqueta o commit que es van utilitzar per al mercat existent.

3. Selecciona Importa un mercat i autoritza l'accés a GitHub quan se't demani.

Les sincronitzacions futures utilitzaran la connexió de GitHub del nou administrador. El compte del nou administrador ha de tenir accés de lectura al repositori del mercat i a tots els repositoris als quals fa referència.

Passa a gestionar un connector existent des de GitHub

Pots utilitzar un mercat per gestionar un connector existent de l'espai de treball que s'hagi pujat com a fitxer d'arxiu o que encara no es gestioni des d'una font de GitHub. El connector existent ha de ser al mateix espai de treball i tenir el mateix nom de connector. No es pot assumir d'aquesta manera la gestió d'un connector que ja es gestiona des d'una altra font de GitHub.


Per identificar el connector existent al teu mercat:

1. Ves a la Consola d'administració, selecciona l'espai de treball de ChatGPT corresponent i obre Connectors. Obre el connector.

2. Copia l'ID del connector que apareix després de /admin/plugins/ al seu URL.

3. Afegeix aquest ID com a pluginId al costat de name i source a l'entrada corresponent de la matriu plugins del mercat. No l'afegeixis al fitxer plugin.json del connector.

El connector conserva l'ID, la configuració d'ús compartit i les polítiques de l'espai de treball. GitHub passa a ser la font de les actualitzacions futures, de manera que ja no es podrà substituir el connector pujant fitxers d'arxiu.


Per veure un exemple de migració i els requisits, consulta: Gestió de connectors.

Fes referència a una aplicació existent

Un connector pot fer referència a una aplicació existent mitjançant .app.json, a l'arrel del connector. Inclou el punt inicial al nom del fitxer i utilitza l'ID de l'aplicació, no el d'un connector. Per a un connector natiu, estableix el camp apps de .codex-plugin/plugin.json en ./.app.json.


La referència no crea cap aplicació ni concedeix permisos addicionals. Es continuen aplicant les condicions d'accés a l'espai de treball, l'autenticació, els controls d'accions i els permisos dels serveis connectats que ja té l'aplicació.


Per obtenir informació sobre el format JSON, consulta: Gestió de connectors.

Entén l'etiqueta Només per a escriptori

Un connector marcat com a Només per a escriptori no es pot executar a la versió web de ChatGPT. Els connectors importats poden rebre aquesta etiqueta quan declaren servidors MCP, per exemple a mcp.json o .mcp.json, encara que un servidor utilitzi un URL HTTPS remot.


Afegir una referència .app.json no elimina per si sol l'etiqueta Només per a escriptori. Qualsevol aplicació referenciada ha de continuar estant disponible per al rol del membre, i se li apliquen els requisits habituals d'accés i autenticació.