Gerenciar plugins para sua organização

Os marketplaces de plugins permitem que proprietários de planos Team e Enterprise distribuam plugins selecionados para todos na sua organização. Você cria um marketplace, adiciona plugins a ele e controla exatamente quais plugins seus membros da equipe podem ver e usar. Os plugins que você distribui aparecem no chat (na web e na aba Chat do Claude Desktop), no Claude Cowork e nas sessões do Claude Code onde os membros fazem login com a mesma conta Claude.

Requisitos: Cowork e Skills devem estar ambos habilitados para sua organização antes de você poder usar marketplaces de plugins.

Para uma versão de referência desses controles, consulte Gerenciar plugins para sua organização na documentação do Claude Code.

A aba "Inventory" lista todos os skills e plugins que sua organização governa, incluindo os que os usuários criaram para si mesmos. Skills e plugins agora vivem na mesma página, então você não precisa alternar entre configurações.

Para cada item, a tabela mostra sua origem, versão, capacidades, público e quantas pessoas o usaram nos últimos 30 dias.

Para encontrar um item, pesquise por nome ou use os filtros:

Skills que sua organização gerencia aparecem em Biblioteca da organização. Você gerencia marketplaces de plugins na aba Marketplaces.

Para agir em um item, clique no botão de menu no final de sua linha. Você pode visualizar detalhes e arquivos, ver histórico de versões e alterar acesso padrão e de grupo.

Para skills e plugins que os usuários criaram, a aba Inventory mostra metadados e status de compartilhamento. Ela não mostra os arquivos em si.

A Anthropic fornece marketplaces integrados de plugins para diferentes funções, como jurídico e finanças. Um marketplace Knowledge Work é adicionado à sua organização por padrão.

Para adicionar um marketplace construído pela Anthropic:

Para remover o marketplace Knowledge Work se não for relevante para suas equipes:

Marketplaces construídos pela Anthropic mostram nomes legíveis, como "Knowledge Work", em vez do slug do repositório subjacente.

Além dos marketplaces construídos pela Anthropic, você pode criar o seu próprio. Existem duas maneiras de adicionar plugins a um marketplace que você cria:

Você pode usar ambas as abordagens em paralelo. Por exemplo, execute um marketplace sincronizado com GitHub para seus plugins principais e um marketplace manual separado para ferramentas ad-hoc.

Se você fizer upload de um plugin com o mesmo nome de um existente, ele sobrescreve a versão anterior automaticamente. Você não precisa deletar o antigo primeiro.

A sincronização do GitHub permite que você gerencie plugins como código em um repositório. Quando você faz push de alterações, você pode disparar uma sincronização para atualizar seu marketplace, manualmente ou automaticamente.

Prepare seu repositório

Você pode conectar um repositório hospedado em github.com ou no host do GitHub Enterprise da sua organização. Em github.com, seu repositório deve ser privado ou interno—repositórios públicos não são permitidos para marketplaces da organização. Para sincronizar do GitLab, consulte Configure um marketplace sincronizado com GitLab.

Marketplaces sincronizados com GitHub suportam um conjunto mais estreito de tipos de source em marketplace.json do que o Claude Code faz. Caminhos relativos para pastas de plugins dentro do repositório do marketplace (por exemplo, "source": "./plugins/my-plugin") são totalmente suportados e são a opção mais simples. Os tipos de source github, url e git-subdir também são suportados. Os tipos de source npm, archive e command não são suportados.

Uma fonte de plugin pode ser privada em três casos:

Todas as outras fontes são buscadas sem credenciais, portanto deve ser um repositório público no github.com, gitlab.com ou bitbucket.org. Fontes em qualquer outro host são rejeitadas.

Se o código do seu plugin reside em um repositório privado que não atende aos critérios acima, copie essas pastas de plugin para o repositório de marketplace e altere a fonte de cada plugin para um caminho relativo (uma git subtree ou uma etapa de CI que vende os arquivos funciona bem).

Para detalhes sobre a estrutura e formatação do plugin, consulte a referência de manifesto do plugin.

Recursos adicionais:

Conectar o repositório

Seu token GitHub pessoal é verificado para confirmar que você tem acesso, então Cowork usa seu token de instalação do GitHub App para operações de sincronização.

Não consegue ver seu repositório? Certifique-se de que o Claude GitHub App está instalado nesse repositório.

Como funciona a sincronização

Uma sincronização inicial é executada automaticamente quando você conecta um repositório. No fluxo de criação do GitHub, você também pode desativar "Sincronizar automaticamente", que está ativado por padrão. Com isso ativado, uma sincronização é executada quando um pull request é mesclado na branch que o marketplace segue, ou quando alguém faz push diretamente para essa branch.

A pessoa que ativa ou desativa a sincronização automática deve ter acesso de nível de administrador a esse repositório no GitHub. Isso é verificado através de sua conexão GitHub pessoal, que é separada da instalação do Claude GitHub App. Sem acesso de administrador, a página mostra "Não é possível acessar o repositório. Certifique-se de que o repositório existe e o Claude GitHub App está instalado", mesmo quando o App está instalado corretamente e as atualizações manuais funcionam.

A permissão Webhooks (Leitura e Escrita) do Claude GitHub App também deve ser aprovada na instalação. Em instalações criadas antes dessa permissão ser introduzida, o GitHub mostra um prompt "Claude está solicitando permissões atualizadas" que um administrador do repositório ou organização precisa aprovar.

Uma vez habilitada, a sincronização automática para um repositório GitHub é executada quando um pull request que inclui um bump de versão do plugin é mesclado na branch padrão do repositório. Pushes diretos para a branch padrão não acionam uma sincronização. Você sempre pode acionar uma sincronização manualmente clicando em "Re-sincronizar" no marketplace.

Durante uma sincronização, Cowork compara o commit mais recente no seu repositório com o commit sincronizado pela última vez. Se nada mudou, a sincronização é ignorada. Se houver alterações, Cowork lê o manifesto, valida cada plugin e substitui todos os plugins no marketplace pelo estado atual do repositório. As sincronizações podem levar até 30 minutos dependendo do número de plugins.

Você pode sincronizar um marketplace da organização a partir de um repositório no gitlab.com ou em uma instância GitLab auto-gerenciada. Para tipos de fonte de plugin suportados e quais fontes podem ser privadas, consulte Preparar seu repositório acima.

Antes de começar

Etapa 1: Adicionar uma configuração GitLab

Para adicionar uma configuração GitLab:

Você pode executar o teste novamente a qualquer momento no menu da configuração com Testar conexão. O nome do host não pode ser alterado posteriormente. Se mudar, exclua a configuração e adicione uma nova.

Etapa 2: Adicionar o marketplace

Para adicionar o marketplace:

Claude lê o branch padrão do projeto e valida o arquivo do marketplace antes de criar o marketplace, que é nomeado de acordo com o caminho do projeto.

Etapa 3: Sincronização automática

Com Sincronizar automaticamente ativado, cada push para o branch padrão do projeto dispara uma sincronização através de um webhook no projeto GitLab. Se seu token puder gerenciar webhooks (consulte Antes de começar), Claude cria o webhook para você e não há mais nada a fazer.

Você pode ativar ou desativar Sincronizar automaticamente posteriormente no menu do marketplace. Ativá-lo configura o webhook da mesma forma.

Etapa 4: Se Claude não conseguir criar o webhook

Se o token não conseguir gerenciar webhooks, Claude exibe uma mensagem Concluir configuração do webhook no GitLab na tela com uma URL do webhook e um token. O token é exibido apenas uma vez, portanto conclua esta etapa antes de fechar a mensagem.

Se perder o token, abra Configurar webhook no menu do marketplace, clique em "Remover webhook" e depois em "Ativar webhook" para obter um novo. O token antigo deixará de funcionar.

Depois que seu marketplace tiver plugins, você controla como eles são distribuídos usando preferências de instalação. Para cada plugin, você pode definir uma de quatro opções:

Os membros navegam pelos plugins disponíveis na aba Descobrir em Personalizar > Plugins. Os plugins que você define como "Instalado por padrão" ou "Obrigatório" aparecem na lista deles automaticamente. Os plugins que você define como "Disponível para instalar" aparecem em Descobrir para que os membros os adicionem por conta própria.

Os membros não podem editar plugins gerenciados pela organização, o que evita alterações conflitantes em ferramentas compartilhadas.

Administradores corporativos podem substituir a preferência de instalação em toda a organização de um plugin para grupos específicos. Por exemplo, você pode instalar automaticamente um plugin para o grupo de Engenharia, disponibilizá-lo para o Jurídico instalar por conta própria e ocultá-lo de todos os outros.

Cada plugin no seu marketplace tem uma preferência de instalação em toda a organização (Instalado por padrão, Disponível para instalar, Obrigatório ou Não disponível). Por padrão, cada grupo herda essa configuração em toda a organização.

Quando você define uma substituição em nível de grupo para um plugin, ela substitui a configuração em toda a organização para os membros desse grupo. A ordem de resolução é: configuração de grupo, depois configuração em toda a organização, depois padrão do marketplace.

Grupos criados manualmente e grupos provisionados por SCIM do seu provedor de identidade aparecem no seletor de grupo e funcionam da mesma forma.

Se um membro pertence a dois ou mais grupos com configurações diferentes para o mesmo plugin, a configuração mais permissiva se aplica. A ordem de mais para menos permissiva é: Obrigatório > Instalado por padrão > Disponível para instalar > Não disponível.

Por exemplo, se o Grupo A define um plugin como "Não disponível" e o Grupo B o define como "Instalado por padrão", um membro em ambos os grupos obtém o plugin instalado por padrão.

Se um grupo for removido (por exemplo, excluído do seu provedor de identidade), a substituição permanece na interface do administrador, mas é marcada como órfã. Não tem efeito nos membros (já que ninguém pertence a um grupo excluído) e não conta para o crachá de acesso personalizado. Você pode limpar substituições órfãs nas configurações "Acesso de grupo..." do plugin.

Sim. As substituições em nível de grupo persistem quando você ressincroniza um marketplace conectado ao GitHub ou GitLab. Elas são removidas apenas se o próprio plugin for excluído do marketplace.

Um Proprietário ou Proprietário Primário pode limitar quais marketplaces de plugins as pessoas em sua organização podem adicionar, usando uma lista de permissões, uma lista de bloqueio ou ambas. Você define essas listas nas configurações gerenciadas do Claude Code, mas elas também se aplicam no Claude e Claude Cowork.

Para definir uma lista de permissões ou lista de bloqueio:

Digite o nome da sua organização GitHub exatamente como o GitHub o mostra, porque a correspondência da lista de permissões diferencia maiúsculas de minúsculas. Se uma fonte estiver em ambas as listas, ela será bloqueada.

Depois que as listas são definidas, o Claude as verifica sempre que alguém em sua organização adiciona um marketplace de um repositório Git no Claude, Claude Desktop ou Cowork. Isso cobre marketplaces que os usuários adicionam para si mesmos em Personalizar e marketplaces adicionados para toda a organização em Configurações da organização > Plugins e habilidades. O Claude recusa qualquer repositório que as listas não permitam, exceto marketplaces construídos pela Anthropic.

Tenha em mente:

Para cada tipo de fonte que as listas aceitam, consulte Restringir o que os usuários podem instalar na documentação do Claude Code.

Para atualizar um plugin, carregue um novo arquivo ZIP com o mesmo nome do plugin. A nova versão substitui a existente automaticamente. Os nomes dos plugins são o identificador único, portanto legal sempre substituirá legal.

Para remover um plugin, delete-o do seu marketplace em Configurações da organização > Plugins e skills na aba "Inventário".

Envie suas alterações para o repositório conectado, depois acesse Configurações da organização > Plugins e skills e clique na aba "Marketplaces", encontre seu marketplace e clique em "Atualizar" para disparar uma sincronização. Cada sincronização substitui todos os plugins pelo estado atual do repositório. Se um proprietário ativou "Sincronizar automaticamente" para o marketplace, uma sincronização também é executada sempre que um pull request com um bump de versão do plugin é mesclado ao branch padrão do repositório.

Para marketplaces sincronizados com GitLab, consulte Configurar um marketplace sincronizado com GitLab.

Para remover um plugin, delete-o do repositório e dispare uma sincronização.

Os nomes dos plugins devem usar palavras em minúsculas separadas por hífens (por exemplo, deployment-tools, não Deployment Tools). Os seguintes nomes de marketplace são reservados e não podem ser usados:

Nomes que imitam marketplaces oficiais da Anthropic também são bloqueados.

Causas comuns: o arquivo excede 200 MB, não é um arquivo ZIP válido ou o marketplace atingiu o limite de 1000 plugins. Verifique o tamanho e o formato do arquivo e remova plugins não utilizados se estiver no limite. Se a verificação de skill e plugin estiver ativada, um plugin também pode ser rejeitado por ter sido sinalizado como conteúdo malicioso. Revise o motivo, corrija o problema e carregue o plugin novamente.

Verifique a preferência de instalação do plugin nas configurações do seu marketplace. Se estiver definida como Não disponível, os membros não o verão. Também confirme que Cowork e Skills estão ambos ativados para sua organização.

As alterações entram em vigor na próxima sessão ou atualização de plugin de cada membro. No Claude Code, os usuários recebem a alteração na próxima vez que iniciarem o Claude Code. Se a atualização ainda não estiver aparecendo, confirme que o upload foi bem-sucedido verificando a versão do plugin no seu marketplace.

Um ou mais plugins no seu repositório provavelmente estão formatados incorretamente. Corrija o problema de formatação, envie a atualização para o GitHub e dispare a sincronização novamente. Para requisitos de estrutura de plugin, consulte a referência de manifesto do plugin.

Uma ou mais entradas de plugin no seu marketplace.json usam uma source que aponta para fora do repositório conectado (uma fonte github, url ou git-subdir), e a sincronização da organização não consegue buscá-la. Uma fonte privada funciona apenas em três casos: um repositório github.com compartilha o proprietário do seu repositório de marketplace, um repositório no host GitHub Enterprise da sua organização com seu GitHub Enterprise App instalado nele, ou uma fonte url ou git-subdir no mesmo host GitLab que seu repositório de marketplace (em gitlab.com, também sob o mesmo grupo de nível superior ou namespace de usuário).

Para qualquer outra fonte privada, mova as pastas do plugin para o repositório do marketplace e altere a source de cada entrada para um caminho relativo (por exemplo, "./plugins/my-plugin"), depois faça push e ressincronize. Alternativamente, carregue os plugins afetados individualmente via Configurações da organização > Plugins e skills Clique em "Adicionar", "Carregar um plugin" e selecione "Adicionar a um marketplace existente." Os plugins carregados através do menu Personalizar de um membro são instalados apenas para esse membro e não são distribuídos para sua organização, embora os membros possam compartilhar plugins com colegas ou grupos específicos se o compartilhamento estiver ativado.

Certifique-se de que o Claude GitHub App está instalado nesse repositório. Seu token pessoal do GitHub é verificado primeiro para confirmar o acesso, mas a sincronização em si usa o token de instalação do GitHub App.

Se as atualizações manuais funcionam, mas ativar "Sincronizar automaticamente" mostra "Não é possível acessar o repositório. Certifique-se de que o repositório existe e o Claude GitHub App está instalado", há duas causas prováveis:

Se você vir esta mensagem ao adicionar um marketplace no GitLab, certifique-se de que adicionou a configuração do GitLab primeiro. Consulte Etapa 1: Adicionar uma configuração do GitLab em Configurar um marketplace sincronizado com GitLab.

Certifique-se de que o nome do host da URL corresponde exatamente a um nome do host do GitLab configurado.

Verifique se a visibilidade do projeto é privada ou interna. Projetos públicos do gitlab.com não podem ser usados como marketplaces da organização.

Confirme se a instância está acessível pela internet pública via HTTPS e se os endereços IP de saída da Anthropic são permitidos através do seu firewall. "Não foi possível estabelecer uma conexão segura" geralmente significa que o certificado CA está ausente ou incorreto.

O token expirou, foi revogado ou está faltando um escopo ou função listado na seção Antes de começar em Configurar um marketplace sincronizado com GitLab. Crie um novo token e cole-o na configuração (Editar > Token de acesso).