Descripción general

Los administradores del Área de trabajo pueden importar un marketplace de complementos desde GitHub al directorio de su Área de trabajo. Un marketplace es un catálogo JSON que enumera los complementos que se van a importar. Tras la importación, la sincronización diaria mantiene los complementos al día con los cambios del repositorio.


La sincronización del marketplace importa el contenido de los complementos; no conecta las cuentas de los miembros del Área de trabajo ni concede acceso a las aplicaciones incluidas en un complemento.


Para obtener una introducción a los complementos y las aplicaciones que incluyen, consulta: complementos en ChatGPT y Codex.

Antes de empezar

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

• Obtén las aprobaciones que exija la organización de GitHub 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 independiente para cada uno, y las futuras sincronizaciones pueden añadir nuevos complementos.

Los nuevos complementos tienen inicialmente la política de instalación Disponible y requieren autenticación al instalarlos. Los nuevos marketplaces tienen habilitada la sincronización automática diaria. Tras la importación, revisa los ajustes del Área de trabajo y las aplicaciones necesarias de cada complemento.

Importar un marketplace

1. Ve a la consola de administración, selecciona el Área de trabajo de ChatGPT correspondiente y abre Complementos. A continuación, selecciona Añadir y elige Importar marketplace.

2. En Origen, introduce 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 el marketplace está en un subdirectorio, introduce ese directorio en Ruta. Por ejemplo, introduce team-tools para team-tools/.agents/plugins/marketplace.json. Deja Ruta en blanco para usar la raíz del repositorio. No introduzcas el nombre del archivo de manifiesto.

4. Si quieres, introduce 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 concreto, se mantendrá esa revisión.

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

6. Revisa los Resultados de la importación y, después, abre cada complemento importado para configurar su política de instalación y las aplicaciones que necesite.

La importación inicial puede tardar hasta 1 hora en el caso de marketplaces 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 igualmente.

Formatos compatibles

El directorio seleccionado debe contener un archivo de manifiesto compatible:

• .agents/plugins/marketplace.json para un marketplace de Codex.

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

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

Las entradas del marketplace pueden hacer referencia a carpetas de complementos del mismo repositorio o a orígenes de repositorios de GitHub compatibles. La importación al Área de trabajo no admite otros servicios de alojamiento de Git ni orígenes de registros de paquetes, como npm.

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

Configurar el acceso en el Área de trabajo

GitHub proporciona el contenido de los complementos, mientras que los ajustes del Área de trabajo controlan 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 estos ajustes para cada complemento de tu Área de trabajo.


Usa Política de instalación para elegir Disponible o Instalado para cada rol al que se aplique. Las aplicaciones necesarias 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 gestionar un complemento existente desde GitHub, se conservan sus políticas del Área de trabajo. Importar un complemento no concede acceso a las aplicaciones ni conecta las cuentas de los miembros.


Para obtener información sobre la navegación por el Área de trabajo, el acceso a las aplicaciones y los controles del Área de trabajo, consulta: controles de administración, seguridad y cumplimiento para complementos y aplicaciones.

Mantener los complementos actualizados

Los nuevos marketplaces comprueban a diario si hay actualizaciones. Para solicitar una actualización sin esperar a la sincronización automática:

1. Ve a la consola de administración, selecciona el Área de trabajo de ChatGPT correspondiente y abre Complementos.

2. Abre Marketplaces y selecciona el marketplace.

3. Selecciona Sincronizar ahora.

La sincronización puede añadir nuevas entradas del marketplace y actualizar los complementos existentes. Revisa los cambios del repositorio antes de fusionarlos, ya que la sincronización automática puede importar nuevos complementos sin que tengas que repetir el proceso de importación.

Revisar los resultados de la sincronización

Tras una sincronización, revisa su estado y el informe guardado. Completada — N errores significa que la sincronización ha finalizado, pero no se han podido 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 se pueden completar igualmente. Corrige en GitHub el problema indicado y, después, selecciona Sincronizar ahora para volver a intentarlo.


Si en la vista de administración aparece 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 el contenido desde GitHub.

Qué ocurre al quitar entradas y eliminar marketplaces

Quitar una entrada del repositorio no elimina la copia importada al Área de trabajo. El complemento se marca como Ya no está en el origen.


Al eliminar el marketplace en ChatGPT, se eliminan todos los complementos importados desde él. No elimines un marketplace para volver a conectar GitHub o cambiar de propietario.

Volver a conectar o cambiar el acceso a GitHub

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

Volver a conectar la cuenta original

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

2. Pide al administrador que importó originalmente el marketplace que abra el complemento de GitHub en ChatGPT y vuelva a conectar su cuenta.

Transferir la gestión a un nuevo administrador

El nuevo administrador del Área de trabajo puede importar el mismo marketplace usando su propia conexión a GitHub:

1. Ve a la consola de administración, selecciona el Área de trabajo de ChatGPT correspondiente y abre Complementos. A continuación, selecciona Añadir > Importar marketplace.

2. Introduce los mismos valores de Origen, Ruta y Rama, etiqueta o commit que se usaron para el marketplace existente.

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

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

Pasar a gestionar un complemento existente desde GitHub

Puedes usar un marketplace para gestionar un complemento existente del Área de trabajo que se haya subido como archivo comprimido o que aún no se gestione desde un origen de GitHub. El complemento existente debe estar en la misma Área de trabajo y tener el mismo nombre de complemento. No se puede asumir de este modo la gestión de un complemento gestionado desde otro origen de GitHub.


Para identificar el complemento existente en tu marketplace:

1. Ve a la consola de administración, selecciona el Área de trabajo de ChatGPT correspondiente y abre Complementos. Abre el complemento.

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

3. Añade ese ID como pluginId junto a name y source en la entrada correspondiente del array plugins del marketplace. No lo añadas al archivo plugin.json del complemento.

El complemento conserva su ID, su configuración de uso compartido y sus políticas del Área de trabajo. GitHub pasa a ser el origen de las futuras actualizaciones, por lo que las posteriores subidas de archivos comprimidos no podrán reemplazar el complemento.


Para ver un ejemplo de migración y los requisitos, consulta: gestión de complementos.

Hacer referencia a una aplicación existente

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


La referencia no crea ninguna aplicación ni concede permisos adicionales. Siguen aplicándose las condiciones de acceso al Área de trabajo, la autenticación, los controles de acciones y los permisos del servicio conectado que ya tenga la aplicación.


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

Qué significa la etiqueta Solo para escritorio

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


Añadir una referencia en .app.json no elimina por sí solo la etiqueta Solo para escritorio. Toda aplicación 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.