Gestionar complementos para tu organización

Los mercados de complementos permiten a los propietarios de planes Team y Enterprise distribuir complementos seleccionados a todos en su organización. Creas un mercado, añades complementos a él y controlas exactamente qué complementos pueden ver y usar tus miembros del equipo. Los complementos que distribuyes aparecen tanto en el chat (en la web y en la pestaña Chat de Claude Desktop) como en Claude Cowork.

Requisitos: Cowork y Skills deben estar habilitados para tu organización antes de que puedas usar mercados de complementos.

Anthropic proporciona mercados integrados de complementos para diferentes funciones, como legal y finanzas. Un mercado de Knowledge Work se añade a tu organización de forma predeterminada.

Para añadir un mercado creado por Anthropic:

Para eliminar el mercado de Knowledge Work si no es relevante para tus equipos:

Los mercados creados por Anthropic muestran nombres legibles, como "Knowledge Work", en lugar del slug del repositorio subyacente.

Más allá de los mercados creados por Anthropic, puedes crear el tuyo propio. Hay dos formas de añadir complementos a un mercado que crees:

Puedes usar ambos enfoques en paralelo. Por ejemplo, ejecuta un mercado sincronizado con GitHub para tus complementos principales y un mercado manual separado para herramientas ad-hoc.

Si cargas un complemento con el mismo nombre que uno existente, sobrescribe automáticamente la versión anterior. No necesitas eliminar la antigua primero.

La sincronización de GitHub te permite gestionar complementos como código en un repositorio. Cuando insertas cambios, puedes activar una sincronización para actualizar tu mercado, ya sea manual o automáticamente.

Preparar tu repositorio

Tu repositorio debe ser privado o interno—los repositorios públicos no están permitidos para mercados de organizaciones. Puedes conectar un repositorio alojado en github.com o en el host de GitHub Enterprise de tu organización.

Los mercados sincronizados con GitHub admiten un conjunto más limitado de tipos de source en marketplace.json que Claude Code. Las rutas relativas a carpetas de complementos dentro del repositorio del mercado (por ejemplo, "source": "./plugins/my-plugin") son totalmente compatibles y son la opción más simple. Los tipos de fuente github, url y git-subdir también son compatibles. Los tipos de fuente npm, archive y command no son compatibles.

Una fuente de complemento puede ser privada en dos casos: una fuente github.com que comparta el propietario del repositorio de tu mercado, que la sincronización de la organización obtiene a través de la aplicación Claude GitHub, o una fuente en el host de GitHub Enterprise de tu organización con la aplicación GitHub Enterprise de tu organización instalada en ese repositorio. Todas las demás fuentes se obtienen sin credenciales, por lo que los repositorios github.com bajo un propietario diferente y los repositorios en otros hosts (como GitLab o Bitbucket) deben ser públicos.

Si tu código de complemento vive en un repositorio privado que no cumple los criterios anteriores, copia esas carpetas de complementos en el repositorio del mercado y cambia la fuente de cada complemento a una ruta relativa (un git subtree o un paso de CI que venda los archivos funciona bien).

Para obtener detalles sobre la estructura y el formato de complementos, consulta la documentación de referencia de complementos.

Recursos adicionales:

Conectar el repositorio

Tu token personal de GitHub se verifica para confirmar que tienes acceso, luego Cowork utiliza su token de instalación de la aplicación de GitHub para operaciones de sincronización.

¿No ves tu repositorio? Asegúrate de que la aplicación Claude GitHub esté instalada en ese repositorio.

Cómo funciona la sincronización

Una sincronización inicial se ejecuta automáticamente cuando conectas un repositorio. Después de eso, los propietarios de la organización pueden optar por recibir actualizaciones automáticas continuas por marketplace accediendo a Configuración de la organización > Complementos, haciendo clic en el botón de menú en la esquina superior derecha del marketplace y luego activando "Sincronizar automáticamente":

Habilitar la sincronización automática crea un webhook en el repositorio conectado. La persona que activa el interruptor debe tener acceso de nivel de administrador a ese repositorio en GitHub. Esto se verifica a través de su conexión personal de GitHub, que es independiente de la instalación de la aplicación Claude GitHub. Sin acceso de administrador, la página muestra "No se puede acceder al repositorio. Asegúrate de que el repositorio existe y la aplicación Claude GitHub está instalada", incluso cuando la aplicación está instalada correctamente y las actualizaciones manuales funcionan.

El permiso Webhooks (Lectura y Escritura) de la aplicación Claude GitHub también debe ser aprobado en la instalación. En instalaciones creadas antes de que se introdujera este permiso, GitHub muestra un mensaje "Claude está solicitando permisos actualizados" que un administrador del repositorio u organización debe aprobar.

Una vez habilitada, la sincronización automática se ejecuta cuando se fusiona una solicitud de extracción que incluye un aumento de versión del complemento en la rama predeterminada del repositorio. Los envíos directos a la rama predeterminada no activan una sincronización. Siempre puedes activar una sincronización manualmente haciendo clic en "Actualizar" en el marketplace.

Durante una sincronización, Cowork compara la confirmación más reciente en tu repositorio con la confirmación sincronizada por última vez. Si nada ha cambiado, la sincronización se omite. Si hay cambios, Cowork lee el manifiesto, valida cada complemento y reemplaza todos los complementos en el marketplace con el estado actual del repositorio. Las sincronizaciones pueden tardar hasta 30 minutos según la cantidad de complementos.

Una vez que tu marketplace tiene complementos, controlas cómo se distribuyen usando preferencias de instalación. Para cada complemento, puedes establecer una de cuatro opciones:

Los miembros exploran los complementos disponibles a través del modal Explorar complementos. Los complementos instalados automáticamente aparecen en su lista de instalados automáticamente. Los complementos disponibles aparecen en el catálogo para instalación de autoservicio.

Los miembros no pueden editar complementos administrados por la organización, lo que evita cambios conflictivos en las herramientas compartidas.

Los administradores empresariales pueden anular la preferencia de instalación de un complemento en toda la organización para grupos específicos. Por ejemplo, puede instalar automáticamente un complemento para el grupo de Ingeniería, ponerlo disponible para que Legal lo instale por su cuenta y ocultarlo de todos los demás.

Cada complemento en su marketplace tiene una preferencia de instalación en toda la organización (Instalado por defecto, Disponible para instalar, Requerido o No disponible). Por defecto, cada grupo hereda esa configuración en toda la organización.

Cuando establece una anulación a nivel de grupo para un complemento, reemplaza la configuración en toda la organización para los miembros de ese grupo. El orden de resolución es: configuración de grupo, luego configuración en toda la organización, luego predeterminado del marketplace.

Tanto los grupos creados manualmente como los grupos aprovisionados por SCIM de su proveedor de identidad aparecen en el selector de grupos y funcionan de la misma manera.

Si un miembro pertenece a dos o más grupos con diferentes configuraciones para el mismo complemento, se aplica la configuración más permisiva. El orden de más a menos permisivo es: Requerido > Instalado por defecto > Disponible para instalar > No disponible.

Por ejemplo, si el Grupo A establece un complemento en "No disponible" y el Grupo B lo establece en "Instalado por defecto", un miembro en ambos grupos obtiene el complemento instalado por defecto.

Si se elimina un grupo (por ejemplo, se elimina de su proveedor de identidad), la anulación permanece en la interfaz de usuario de administración pero se marca como huérfana. No tiene efecto en los miembros (ya que nadie pertenece a un grupo eliminado) y no cuenta hacia la insignia de acceso personalizado. Puede borrar anulaciones huérfanas de la configuración de acceso personalizado del complemento.

Sí. Las anulaciones a nivel de grupo persisten cuando resincroniza un marketplace conectado a GitHub. Solo se eliminan si el complemento en sí se elimina del marketplace.

Para actualizar un complemento, cargue un nuevo archivo ZIP con el mismo nombre de complemento. La nueva versión sobrescribe la existente automáticamente. Los nombres de complementos son el identificador único, por lo que legal siempre reemplazará legal.

Para eliminar un complemento, elimínelo de su marketplace en Configuración de la organización > Complementos.

Envíe sus cambios al repositorio conectado, luego vaya a Configuración de la organización > Complementos, encuentre su marketplace y haga clic en "Actualizar" para activar una sincronización. Cada sincronización reemplaza todos los complementos con el estado actual del repositorio. Si un propietario ha habilitado "Sincronizar automáticamente" para el marketplace, una sincronización también se ejecuta cada vez que se fusiona una solicitud de extracción con un aumento de versión de complemento en la rama predeterminada del repositorio.

Para eliminar un complemento, elimínelo del repositorio y active una sincronización.

Los nombres de los complementos deben usar palabras en minúsculas separadas por guiones (por ejemplo, deployment-tools, no Deployment Tools). Los siguientes nombres de marketplace están reservados y no se pueden usar:

También se bloquean los nombres que se hacen pasar por marketplaces oficiales de Anthropic.

Causas comunes: el archivo supera 50 MB, no es un archivo ZIP válido, o el marketplace ha alcanzado el límite de 100 complementos. Verifica el tamaño y formato del archivo, y elimina los complementos no utilizados si estás al límite. Si el escaneo de habilidades y complementos está activado, un complemento también puede ser rechazado si se marca como contenido malicioso. Revisa el motivo, soluciona el problema y carga el complemento nuevamente.

Verifica la preferencia de instalación del complemento en la configuración de tu marketplace. Si está configurada como No disponible, los miembros no la verán. También confirma que Cowork y Skills estén habilitados para tu organización.

Los cambios surten efecto en la siguiente sesión o actualización de complemento de cada miembro. Si la actualización aún no se muestra, confirma que la carga fue exitosa verificando la versión del complemento en tu marketplace.

Es probable que uno o más complementos en tu repositorio tengan un formato incorrecto. Corrige el problema de formato, envía la actualización a GitHub y activa la sincronización nuevamente. Para conocer los requisitos de estructura de complementos, consulta la documentación de referencia de complementos.

Una o más entradas de complemento en tu marketplace.json utilizan una source que apunta fuera del repositorio conectado (una fuente github, url o git-subdir), y la sincronización de la organización no puede obtenerla. Una fuente privada solo funciona en dos casos: un repositorio de github.com comparte el propietario del repositorio de tu marketplace, o un repositorio en el host de GitHub Enterprise de tu organización con tu GitHub Enterprise App instalada en él.

Para cualquier otra fuente privada, mueve las carpetas de complementos al repositorio de marketplace y cambia la source de cada entrada a una ruta relativa (por ejemplo, "./plugins/my-plugin"), luego envía y vuelve a sincronizar. Alternativamente, carga los complementos afectados individualmente a través de Configuración de la organización > Complementos > Agregar complementos > Cargar un archivo, luego selecciona "Agregar a un marketplace existente". Los complementos cargados a través del menú Personalizar de un miembro solo se instalan para ese miembro y no se distribuyen a tu organización, aunque los miembros pueden compartir complementos con colegas o grupos específicos si el uso compartido está activado.

Una sincronización fallida de GitHub puede eliminar temporalmente complementos de tu marketplace. Soluciona el problema subyacente, vuelve a sincronizar correctamente y verifica que las preferencias de instalación estén configuradas correctamente, ya que es posible que se hayan restablecido.

Asegúrate de que la aplicación Claude GitHub esté instalada en ese repositorio. Tu token personal de GitHub se verifica primero para confirmar el acceso, pero la sincronización en sí utiliza el token de instalación de la aplicación GitHub.

Si las actualizaciones manuales funcionan pero activar "Sync automatically" (Sincronizar automáticamente) muestra "Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed" (No se puede acceder al repositorio. Asegúrate de que el repositorio exista y de que la aplicación Claude GitHub esté instalada), hay dos causas probables: