Descripción general

Los administradores del Espacio de trabajo pueden importar una tienda de complementos desde GitHub al directorio de su Espacio de trabajo. Una tienda es un catálogo JSON que enumera los complementos que se van a importar. Después de la importación, la sincronización diaria mantiene los complementos al día con los cambios del repositorio.


La sincronización de la tienda importa el contenido de los complementos; no conecta las cuentas de los miembros del Espacio de trabajo ni otorga acceso a las apps incluidas en un complemento.


Para conocer los complementos y las apps que incluyen, consulta: complementos en ChatGPT y Codex.

Antes de comenzar

• Usa una cuenta de GitHub con acceso de lectura al repositorio de la tienda y a todos los demás repositorios a los que haga referencia. Se admiten repositorios públicos y privados de github.com.

• Completa las aprobaciones de la organización de GitHub que se requieran para que la cuenta que realiza la importación pueda acceder a esos repositorios.

• Revisa el contenido del repositorio. La importación procesa todos los complementos válidos sin un paso de aprobación por separado para cada uno, y las sincronizaciones futuras pueden agregar complementos nuevos.

Los complementos nuevos tienen inicialmente la política de instalación Disponible y requieren autenticación al instalarlos. Las tiendas nuevas tienen habilitada la sincronización automática diaria. Después de la importación, revisa la configuración de cada complemento en el Espacio de trabajo y las apps que requiere.

Importar una tienda

1. Ve a la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda y abre Complementos. Luego selecciona Agregar y elige Importar tienda.

2. En Fuente, ingresa la URL del repositorio, por ejemplo, https://github.com/example/team-plugins. Usa solo la URL del repositorio, no la de una rama o carpeta.

3. Si la tienda está en un subdirectorio, ingresa ese directorio en Ruta. Por ejemplo, ingresa team-tools para team-tools/.agents/plugins/marketplace.json. Deja Ruta en blanco para usar el directorio raíz del repositorio. No ingreses el nombre del archivo de manifiesto.

4. Si lo deseas, ingresa un valor en Rama, etiqueta o commit. Déjalo en blanco para usar la rama predeterminada del repositorio. Usa una rama para recibir futuros commits. Si especificas un commit fijo, se mantendrá esa revisión.

5. Selecciona Importar tienda y autoriza el acceso a GitHub cuando se te solicite.

6. Revisa los Resultados de la importación y luego abre cada complemento importado para configurar su política de instalación y las apps que requiera.

La importación inicial puede tardar hasta 1 hora en el caso de tiendas muy grandes. Las sincronizaciones diarias posteriores suelen tardar unos minutos.

Si no se puede importar un complemento, el informe explica el error. Los demás complementos válidos se pueden importar de todos modos.

Formatos compatibles

El directorio seleccionado debe contener un archivo de manifiesto compatible:

• .agents/plugins/marketplace.json para una tienda de Codex.

• .claude-plugin/marketplace.json para una tienda compatible con Claude.

• .claude-plugin/plugin.json para un complemento independiente de Claude cuando no hay un archivo de manifiesto de tienda.

Las entradas de la tienda pueden hacer referencia a carpetas de complementos del mismo repositorio o a fuentes compatibles de repositorios de GitHub. La importación al Espacio de trabajo no admite otros servicios de alojamiento de Git ni fuentes de registros de paquetes, como npm.

Para conocer los formatos compatibles, ver ejemplos de JSON y consultar los campos de fuente, consulta: administración de complementos.

Configurar el acceso en el Espacio de trabajo

GitHub proporciona el contenido de los complementos, mientras que la configuración del Espacio de trabajo controla la instalación y la autenticación. La importación y la sincronización no aplican los valores de las políticas del repositorio, como AVAILABLE u ON_USE. Configura estas opciones para cada complemento de tu Espacio de trabajo.


Usa Política de instalación para elegir Disponible o Instalado para cada rol al que se aplique. Las apps requeridas también deben estar habilitadas, y los miembros deben tener acceso al servicio conectado y completar la autenticación que se requiera.


Al sincronizar una actualización de un complemento o pasar a administrar un complemento existente desde GitHub, se conservan sus políticas del Espacio de trabajo. Importar un complemento no otorga acceso a las apps ni conecta las cuentas de los miembros.


Para conocer la navegación del Espacio de trabajo, el acceso a las apps y los controles del Espacio de trabajo, consulta: controles de administración, seguridad y cumplimiento para complementos y apps.

Mantener los complementos actualizados

Las tiendas nuevas buscan actualizaciones a diario. Para solicitar una actualización sin esperar la sincronización automática:

1. Ve a la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda y abre Complementos.

2. Abre Tiendas y selecciona la tienda.

3. Selecciona Sincronizar ahora.

La sincronización puede agregar nuevas entradas de la tienda y actualizar los complementos existentes. Revisa los cambios del repositorio antes de fusionarlos, ya que la sincronización automática puede importar complementos nuevos sin otro paso de importación.

Revisar los resultados de la sincronización

Después de una sincronización, revisa su estado y el informe guardado. Completada — N errores significa que la sincronización terminó, pero no se pudieron procesar algunos complementos.


Si una actualización de un complemento existente no es válida, se conserva la última versión que funcionaba. Las demás actualizaciones válidas pueden completarse de todos modos. Corrige en GitHub el problema indicado y luego selecciona Sincronizar ahora para volver a intentarlo.


Si tu vista de administración muestra Actualizar para un complemento importado individualmente, usa esa opción para actualizarlo. Actualizar lista de complementos solo vuelve a cargar la lista que se muestra; no sincroniza desde GitHub.

Entender qué ocurre al quitar entradas o eliminar tiendas

Quitar una entrada del repositorio no elimina la copia importada al Espacio de trabajo. El complemento se marca como Ya no está en la fuente.


Al eliminar la tienda en ChatGPT, se eliminan todos los complementos importados desde ella. No elimines una tienda para volver a conectar GitHub o cambiar de propietario.

Volver a conectar o cambiar el acceso a GitHub

La sincronización de la tienda usa la conexión de GitHub del administrador que la importó. Esa cuenta debe mantener el acceso al repositorio de la tienda y a todos los repositorios a los que haga referencia.

Volver a conectar la cuenta original

1. Confirma que la cuenta de GitHub usada para la importación siga teniendo acceso a todos los repositorios necesarios.

2. Pídele al administrador que importó la tienda originalmente que abra el complemento de GitHub en ChatGPT y vuelva a conectar su cuenta.

Transferir a un nuevo administrador

El nuevo administrador del Espacio de trabajo puede importar la misma tienda con su propia conexión de GitHub:

1. Ve a la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda y abre Complementos. Luego selecciona Agregar > Importar tienda.

2. Ingresa los mismos valores de Fuente, Ruta y Rama, etiqueta o commit que se usaron para la tienda existente.

3. Selecciona Importar tienda y autoriza el acceso a GitHub cuando se te solicite.

Las sincronizaciones futuras usarán la conexión de GitHub del nuevo administrador. La cuenta del nuevo administrador debe tener acceso de lectura al repositorio de la tienda y a todos los repositorios a los que haga referencia.

Pasar a administrar un complemento existente desde GitHub

Puedes usar una tienda para administrar un complemento existente del Espacio de trabajo que se haya cargado como archivo comprimido o que aún no se administre desde una fuente de GitHub. El complemento existente debe estar en el mismo Espacio de trabajo y tener el mismo nombre de complemento. No se puede asumir de esta manera la administración de un complemento que se administra desde otra fuente de GitHub.


Para identificar el complemento existente en tu tienda:

1. Ve a la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda y abre Complementos. Abre el complemento.

2. Copia el ID del complemento que aparece después de /admin/plugins/ en su URL.

3. Agrega ese ID como pluginId junto a name y source en la entrada correspondiente del arreglo plugins de la tienda. No lo agregues al archivo plugin.json del complemento.

El complemento conserva su ID, su configuración de uso compartido y sus políticas del Espacio de trabajo. GitHub pasa a ser la fuente de las futuras actualizaciones, por lo que las cargas posteriores de archivos comprimidos no podrán reemplazarlo.


Para ver un ejemplo de migración y sus requisitos, consulta: administración de complementos.

Hacer referencia a una app existente

Un complemento puede hacer referencia a una app existente en .app.json, en el directorio raíz del complemento. Incluye el punto inicial en el nombre del archivo y usa el ID de la app en lugar del ID de un complemento. Para un complemento nativo, establece el campo apps de .codex-plugin/plugin.json en ./.app.json.


La referencia no crea una app ni otorga permisos adicionales. Siguen vigentes las condiciones de acceso de la app en el Espacio de trabajo, la autenticación, los controles de acciones y los permisos del servicio conectado.


Para conocer el formato JSON, consulta: administración de complementos.

Entender la etiqueta Solo para escritorio

Un complemento marcado como Solo para escritorio no se puede ejecutar en ChatGPT en la web. Los complementos importados pueden recibir esta etiqueta cuando declaran servidores MCP, por ejemplo, en mcp.json o .mcp.json, incluso si un servidor usa una URL HTTPS remota.


Agregar una referencia en .app.json no elimina por sí solo la etiqueta Solo para escritorio. Toda app a la que se haga referencia debe seguir estando disponible para el rol del miembro, y se aplican sus requisitos habituales de acceso y autenticación.