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 tanto no chat (na web e na aba Chat do Claude Desktop) quanto no Claude Cowork.

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

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

Para adicionar um marketplace criado pela Anthropic:

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

Os marketplaces criados pela Anthropic mostram nomes legíveis, como "Knowledge Work", em vez do slug do repositório subjacente.

Além dos marketplaces criados 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ê carregar 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

Seu repositório deve ser privado ou interno—repositórios públicos não são permitidos para marketplaces da organização. Você pode conectar um repositório hospedado em github.com ou no host GitHub Enterprise da sua organização.

Os marketplaces sincronizados com GitHub suportam um conjunto mais restrito de tipos de source em marketplace.json do que o Claude Code. 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 dois casos: uma fonte github.com que compartilha o proprietário do repositório do seu marketplace, que a sincronização da organização busca através do Claude GitHub App, ou uma fonte no host GitHub Enterprise da sua organização com o GitHub Enterprise App da sua organização instalado naquele repositório. Todas as outras fontes são buscadas sem credenciais, portanto repositórios github.com sob um proprietário diferente e repositórios em outros hosts (como GitLab ou Bitbucket) devem ser públicos.

Se seu código de plugin reside em um repositório privado que não atende aos critérios acima, copie essas pastas de plugin para o repositório do 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 estrutura e formatação de plugins, consulte a documentação de referência de plugins.

Recursos adicionais:

Conecte o repositório

Seu token pessoal do GitHub é verificado para confirmar que você tem acesso, então 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. Depois disso, os proprietários da organização podem optar por atualizações automáticas contínuas por marketplace acessando Configurações da organização > Plugins, clicando no botão de menu no canto superior direito do marketplace e ativando "Sincronizar automaticamente":

Ativar a sincronização automática cria um webhook no repositório conectado. A pessoa que ativa a opção deve ter acesso de nível de administrador a esse repositório no GitHub. Isso é verificado através de sua conexão pessoal do GitHub, 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 & 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 da organização precisa aprovar.

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

Durante uma sincronização, o Cowork compara o commit mais recente em seu repositório com o commit sincronizado pela última vez. Se nada mudou, a sincronização é ignorada. Se houver alterações, o 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.

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 através do modal Procurar plugins. Os plugins instalados automaticamente aparecem em sua lista de instalados automaticamente. Os plugins disponíveis aparecem no catálogo para instalação de autoatendimento.

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

Os 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 em 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 no 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 grupos 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 de acesso personalizado do plugin.

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

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

Para remover um plugin, exclua-o do seu marketplace em Configurações da organização > Plugins.

Envie suas alterações para o repositório conectado, depois vá para Configurações da organização > Plugins, 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 tiver habilitado "Sincronizar automaticamente" para o marketplace, uma sincronização também será executada sempre que uma solicitação de pull com um bump de versão de plugin for mesclada ao branch padrão do repositório.

Para remover um plugin, exclua-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 do marketplace são reservados e não podem ser usados:

Nomes que se passam por marketplaces oficiais da Anthropic também são bloqueados.

Causas comuns: o arquivo excede 50 MB, não é um arquivo ZIP válido ou o marketplace atingiu o limite de 100 plugins. Verifique o tamanho e o formato do arquivo e remova plugins não utilizados se você 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 faça upload do 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. 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 documentação de referência de 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 dois casos: um repositório github.com compartilha o proprietário do seu repositório de marketplace, ou um repositório no host GitHub Enterprise da sua organização com seu GitHub Enterprise App instalado nele.

Para qualquer outra fonte privada, mova as pastas de plugin para o repositório do marketplace e altere a source de cada entrada para um caminho relativo (por exemplo, "./plugins/my-plugin"), depois envie e ressincronize. Alternativamente, faça upload dos plugins afetados individualmente via Configurações da Organização > Plugins > Adicionar plugins > Fazer upload de um arquivo, depois selecione "Adicionar a um marketplace existente." Os plugins enviados 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.

Uma sincronização falhada do GitHub pode remover temporariamente plugins do seu marketplace. Corrija o problema subjacente, ressincronize com sucesso e verifique se as preferências de instalação estão definidas corretamente, pois podem ter sido redefinidas.

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: