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 Trabalho de Conhecimento é adicionado à sua organização por padrão.

Para adicionar um marketplace criado pela Anthropic:

Para remover o marketplace de Trabalho de Conhecimento se não for relevante para suas equipes:

Os marketplaces criados pela Anthropic mostram nomes legíveis, como "Trabalho de Conhecimento", 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ê fizer upload de um plugin com o mesmo nome de um existente, ele sobrescreve a versão anterior automaticamente. Você não precisa deletar a antiga 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.

Preparar seu repositório

Seu repositório deve ser privado ou interno—repositórios públicos não são permitidos para marketplaces de organização. Você pode conectar um repositório hospedado em github.com ou em uma instância auto-hospedada do GitHub Enterprise Server.

Os marketplaces sincronizados com GitHub suportam um conjunto mais restrito de tipos de source em marketplace.json do que a CLI do Claude Code. Caminhos relativos para pastas de plugins dentro do repositório conectado (por exemplo, "source": "./plugins/my-plugin") são totalmente suportados. Os tipos de source github, url e git-subdir são suportados apenas quando o repositório de destino é público. Os tipos de source npm e pip não são suportados. Se seu código de plugin reside em repositórios privados separados, copie essas pastas de plugins para o repositório do marketplace (um git submodule, git subtree ou uma etapa de CI funciona bem) e referencie-as com caminhos relativos.

Para detalhes sobre estrutura e formatação de plugins, consulte a documentação de referência de plugins.

Recursos adicionais:

Conectar 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 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 aviso "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 para o 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 último commit sincronizado. 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.

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 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 em 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 plugin 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 e 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 imitam 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 de capacidade.

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 o repositório de destino é privado. A sincronização da organização atualmente só pode buscar fontes externas de repositórios públicos. 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, carregue os plugins afetados individualmente via Personalizar > Adicionar plugin > Criar plugin > Carregar plugin.

Uma sincronização do GitHub com falha 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: