Os marketplaces de plugins permitem que proprietários de planos Team e Enterprise distribuam plugins curados para todos na sua organização através do Cowork. Você cria um marketplace, adiciona plugins a ele e controla exatamente quais plugins seus membros da equipe podem ver e usar.
Proprietários e Proprietários Primários de planos Team e Enterprise podem gerenciar plugins da organização no Claude Desktop.
Requisitos: Cowork e Skills devem estar ambos habilitados para sua organização antes de você poder usar marketplaces de plugins.
Existem duas maneiras de adicionar plugins a um marketplace:
Upload manual—Faça upload de arquivos ZIP de plugins individuais através da interface de administração. Melhor para iteração rápida, ferramentas pontuais ou equipes que não usam GitHub para desenvolvimento de plugins.
Sincronização com GitHub—Conecte um repositório privado do GitHub e o Cowork sincroniza automaticamente plugins dele. Melhor quando múltiplos desenvolvedores colaboram em plugins ou você quer atualizações com controle de versão.
Você pode usar ambas as abordagens em paralelo—por exemplo, um marketplace sincronizado com GitHub para seus plugins principais e um marketplace manual separado para ferramentas ad-hoc.
Configurar um marketplace manual
Abra Claude Desktop e vá para Configurações da Organização > Plugins.
Clique em "Adicionar plugins" e selecione "Fazer upload de um arquivo" como a fonte.
Se esta é sua primeira vez configurando um marketplace, "Fazer upload para um novo marketplace" será selecionado automaticamente.
Você poderá escolher "Adicionar a um marketplace existente" ao fazer upload de plugins no futuro.
Digite um nome para seu marketplace.
Arraste seus arquivos ou clique no prompt de upload e selecione seu arquivo.
Nota: O arquivo deve ser um .zip válido com menos de 50 MB.
Repita para cada plugin que você deseja adicionar.
Clique em "Upload" para adicionar seus plugins a um novo marketplace.
Se você fizer upload de um plugin com o mesmo nome de um existente, ele sobrescreve a versão anterior automaticamente—não é necessário deletar a antiga primeiro.
Configurar um marketplace sincronizado com GitHub
A sincronização com 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.
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. Repositórios hospedados em instâncias personalizadas do GitHub Enterprise Server não são suportados. Seu repositório deve estar hospedado em github.com.
Para detalhes sobre estrutura de plugins e formatação, consulte a documentação de referência de plugins.
Recursos adicionais:
Conectar o repositório
Certifique-se de que Cowork e Skills estão ambos habilitados para sua organização.
Vá para Configurações da Organização > Plugins.
Clique em "Adicionar plugin" e selecione "GitHub" como a fonte.
Digite o repositório no formato
proprietário/repositório(por exemplo,acme-corp/claude-plugins).
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 GitHub App do Cowork está instalado nesse repositório.
Como a sincronização funciona
Uma sincronização inicial é executada automaticamente quando você conecta um repositório. Depois disso, você pode disparar sincronizações manualmente clicando em "Verificar atualizações" em seu marketplace em Configurações da Organização > Plugins.
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.
Importante: Se uma sincronização falhar, os plugins podem ser temporariamente removidos para seus membros da equipe. Se isso acontecer, verifique a mensagem de falha, corrija o problema em seu repositório, faça push da atualização e dispare a sincronização novamente. Depois que a sincronização for bem-sucedida, verifique se suas preferências de instalação ainda estão definidas corretamente — elas podem ter sido redefinidas durante a falha.
Controlar a distribuição de plugins
Depois que seu marketplace tem plugins, você controla como eles são distribuídos usando preferências de instalação. Para cada plugin, você pode definir uma de três opções:
Preferência
|
O que faz
|
O que os membros veem
|
Auto-instalar
|
Instalado automaticamente para todos os membros da organização
|
O plugin aparece em sua lista de instalados sem nenhuma ação. Os membros podem desinstalar se escolherem.
|
Disponível
|
Listado no catálogo de plugins
|
Os membros o veem ao navegar plugins e podem instalá-lo por conta própria.
|
Não disponível
|
Oculto do catálogo completamente
|
Os membros não conseguem ver ou instalar o plugin. Útil para preparar ou descontinuar plugins.
|
Definir preferências
Em Configurações da Organização > Plugins, navegue até seu marketplace.
Selecione a preferência de instalação para cada plugin.
As alterações entram em vigor na próxima sessão ou atualização de plugin de cada membro.
O que os membros experimentam
Os membros navegam plugins disponíveis através do modal Procurar plugins no Cowork. Os plugins auto-instalados 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.
Atualizar e remover plugins
Marketplaces manuais
Para atualizar um plugin, faça upload de um novo arquivo ZIP com o mesmo nome de plugin. A nova versão sobrescreve a existente automaticamente. Os nomes de plugins são o identificador único — legal sempre substituirá legal.
Para remover um plugin, delete-o de seu marketplace em Configurações da Organização > Plugins.
Marketplaces sincronizados com GitHub
Faça push de suas alterações para o repositório conectado, depois vá para Configurações da Organização > Plugins, encontre seu marketplace e clique em "Verificar atualizações" para disparar uma sincronização. Cada sincronização substitui todos os plugins pelo estado atual do repositório.
Para remover um plugin, delete-o do repositório e dispare uma sincronização.
Limites
Limite
|
Valor
|
Notas
|
Tamanho máximo de ZIP de plugin (upload)
|
50 MB
|
Aplicado tanto no lado do cliente quanto no lado do servidor
|
Máximo de plugins por marketplace (manual)
|
100
|
Por marketplace
|
Máximo de plugins por marketplace (sincronização GitHub)
|
500
|
Por marketplace
|
Comprimento máximo do nome do plugin
|
64 caracteres
|
Deve usar palavras em minúsculas separadas por hífens
|
Tempo limite de sincronização
|
30 minutos
|
Por operação de sincronização
|
Visibilidade do repositório GitHub
|
Apenas privado ou interno
|
Deve estar hospedado em github.com. Repositórios públicos e instâncias do GitHub Enterprise Server não são suportados.
|
Regras de nomenclatura
Os nomes de 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:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Nomes que imitam marketplaces oficiais do Anthropic também são bloqueados.
Escolher entre upload manual e sincronização com GitHub
Cenário
|
Abordagem recomendada
|
Plugins são mantidos em controle de versão com CI/CD
|
Sincronização com GitHub
|
Múltiplos desenvolvedores colaboram em plugins
|
Sincronização com GitHub
|
Você quer propagação automática de atualizações
|
Sincronização com GitHub
|
Você precisa de mais de 100 plugins em um marketplace
|
Sincronização com GitHub
|
Prototipagem rápida ou ferramentas pontuais
|
Upload manual
|
Plugins construídos por equipes não-técnicas
|
Upload manual
|
Ambientes sem acesso ao GitHub
|
Upload manual
|
Testar um plugin antes de adicioná-lo a um repositório sincronizado
|
Upload manual
|
Solução de problemas
Upload rejeitado
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 formato do arquivo e remova plugins não utilizados se estiver na capacidade máxima.
Plugin não aparecendo para membros
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 habilitados para sua organização.
Plugin atualizado não refletindo para membros
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 em seu marketplace.
Sincronização com GitHub falha com erro de conteúdo
Um ou mais plugins em seu repositório provavelmente estão formatados incorretamente. Corrija o problema de formatação, faça push da atualização para o GitHub e dispare a sincronização novamente. Para requisitos de estrutura de plugins, consulte a documentação de referência de plugins.
Plugins desapareceram após uma sincronização falhada
Uma sincronização falhada com GitHub pode remover temporariamente plugins de seu marketplace. Corrija o problema subjacente, sincronize novamente com sucesso e depois verifique se as preferências de instalação estão definidas corretamente—elas podem ter sido redefinidas.
Não consegue ver um repositório GitHub ao conectar
Certifique-se de que o GitHub App do Cowork 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.
