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.
Proprietários e Proprietários Primários de planos Team e Enterprise podem gerenciar plugins da organização em Configurações da organização > Plugins e skills. Em planos Enterprise, membros com uma função personalizada que inclui gerenciar as bibliotecas da organização também podem.
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.
Observação: Desativar Skills para sua organização também interrompe a sincronização de skills e plugins com o Claude Code e remove os que já foram sincronizados. Desativar Cowork não afeta a sincronização com o Claude Code. Para manter skills e plugins no Claude mas interromper apenas a sincronização, defina syncClaudeAiSkills e syncClaudeAiPlugins como false nas configurações gerenciadas do Claude Code. Saiba mais sobre configuração de administrador do Claude Code.
Observação: Marketplaces são como proprietários distribuem plugins para sua organização. Os usuários também podem compartilhar um plugin que criaram com colegas ou grupos específicos, ou enviá-lo para ser publicado na biblioteca da sua organização. O compartilhamento e a publicação são controlados pelas configurações em Configurações da organização > Plugins e skills na aba "Policy", e os envios de plugins são revisados lá na aba "Requests". Saiba mais sobre usar plugins no Claude e permitir que usuários publiquem skills e plugins em sua organização.
Veja o que há em sua organização
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:
Origem: Sua organização, biblioteca da organização ou um marketplace específico
Público: Quem pode usar o item
Tipo: Skills ou plugins
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.
Use marketplaces construídos pela Anthropic
A Anthropic fornece marketplaces integrados de plugins para diferentes funções, como jurídica e finanças. Um marketplace Knowledge Work é adicionado à sua organização por padrão.
Para adicionar um marketplace construído pela Anthropic:
Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".
Clique em "Add", depois selecione "Add marketplace".
Selecione "Browse Anthropic sources".
Clique em "Add" em cada um que você deseja que apareça para todos na sua organização.
Para remover o marketplace Knowledge Work se não for relevante para suas equipes:
Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".
Encontre Knowledge Work.
Clique no botão de menu no canto superior direito.
Selecione "Remove".
Marketplaces construídos pela Anthropic mostram nomes legíveis, como "Knowledge Work", em vez do slug do repositório subjacente.
Crie seu próprio marketplace
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:
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 mantêm plugins em um repositório Git.
Sincronização de repositório: Conecte um repositório privado do GitHub ou GitLab e o Claude sincroniza plugins dele. Melhor quando múltiplos desenvolvedores colaboram em plugins ou você deseja atualizações controladas por versão.
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.
Configure um marketplace manual
Clique em "Add", depois selecione "Upload a plugin".
Se esta é sua primeira vez configurando um marketplace, "Upload to a new marketplace" é selecionado automaticamente. Você poderá escolher "Add to an existing marketplace" ao fazer upload de plugins depois.
Digite um nome para seu marketplace.
Arraste seus arquivos ou clique no prompt de upload e selecione seu arquivo. O arquivo deve ser um .zip válido com menos de 200 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. Você não precisa deletar o antigo primeiro.
Configure um marketplace sincronizado com GitHub
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 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:
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.
Uma fonte no GitHub Enterprise da sua organização com o Claude GitHub Enterprise App instalado nesse repositório.
Uma fonte url ou git-subdir no mesmo host GitLab que seu repositório de marketplace. No gitlab.com, a fonte também deve estar sob o mesmo grupo de nível superior ou namespace de usuário que o repositório de marketplace.
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 está 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 estrutura e formatação de plugins, consulte a referência de manifesto de plugin.
Recursos adicionais:
Conectar o repositório
Certifique-se de que Cowork e Skills estão habilitados para sua organização.
Vá para Configurações da organização > Plugins e skills e clique na aba "Marketplaces".
Clique em "Adicionar plugins" e selecione "Sincronizar do GitHub".
Digite o repositório no formato
owner/repo(por exemplo,acme-corp/claude-plugins).
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 de 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 em 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.
Importante: Se uma sincronização falhar, os membros mantêm a última versão sincronizada de cada plugin. Verifique a mensagem de falha, corrija o repositório e re-sincronize.
Configurar um marketplace sincronizado com GitLab
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.
O suporte ao GitLab está em beta e se aplica apenas à sincronização de marketplace de plugin. Claude Code na web ainda não suporta repositórios GitLab.
Antes de começar
Função. Você precisa da função Proprietário ou Proprietário Primário para adicionar uma configuração GitLab.
Visibilidade do projeto. No gitlab.com, o projeto de marketplace deve ser privado ou interno. Em uma instância auto-gerenciada, qualquer visibilidade funciona.
Token de acesso. Crie um token de acesso GitLab para Claude ler o projeto de marketplace e qualquer projeto de fonte de plugin no mesmo host. Tokens de acesso pessoal, de grupo e de projeto funcionam. O usuário do token precisa ter pelo menos a função Reporter nesses projetos.
Token legado (com escopo): pelo menos o escopo
read_api.Token de acesso pessoal refinado: as permissões Projeto: Leitura, Branch: Leitura e Repositório: Leitura.
Opcional, para configuração automática de webhook (etapa 3): a função Maintainer no projeto de marketplace mais o escopo
api(legado) ou a permissão Webhook: Criar e Excluir (refinada). Sem isso, você adiciona o webhook manualmente uma vez (etapa 4).
Apenas instâncias auto-gerenciadas.
O nome do host da instância deve ser resolvido para um endereço IP público, e a instância deve aceitar conexões HTTPS de endereços IP de saída da Anthropic.
Se uma autoridade de certificado privada emitiu seu certificado TLS, tenha o certificado da CA (PEM) pronto.
As entregas de webhook para sincronização automática vêm de sua instância para api.anthropic.com, portanto a instância deve ser capaz de fazer solicitações HTTPS de saída para esse host.
Etapa 1: Adicionar uma configuração GitLab
Para adicionar uma configuração GitLab:
Em Infraestrutura auto-hospedada, encontre GitLab e clique em "Adicionar configuração".
Digite um nome de exibição, o nome do host (gitlab.com ou o nome do host da sua instância, como gitlab.example.com), o token de acesso e, para uma instância auto-gerenciada com uma CA privada, o certificado da CA.
Clique em "Adicionar configuração". Claude executa um teste de conexão imediatamente e mostra os resultados em um diálogo Teste de conexão GitLab.
(Opcional) Para verificar que o token pode ler seu projeto de marketplace, digite seu caminho (por exemplo,
platform/claude-plugins) em Caminho do projeto e clique em "Testar acesso de sincronização".
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:
Acesse Configurações da organização > Plugins e skills e clique na aba "Marketplaces".
Clique em "Adicionar" e selecione "Sincronizar do GitLab".
Em URL do repositório GitLab, insira a URL HTTPS do projeto, por exemplo
https://gitlab.example.com/platform/claude-plugins. Projetos em subgrupos aninhados funcionam.Deixe Sincronizar automaticamente ativado se desejar que pushes disparem uma sincronização (veja Etapa 3).
Escolha o Acesso padrão para os plugins que o marketplace contém.
Clique em "Criar".
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 (veja 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 mais tarde 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.
No seu projeto GitLab, abra Configurações > Webhooks e adicione um novo webhook com a URL da mensagem.
Cole o token no campo.
Se a mensagem mostrar um Token secreto, cole-o no campo Token secreto do GitLab.
Se a mensagem mostrar um Token de assinatura (gitlab.com e versões auto-gerenciadas 19.1 ou posterior), selecione "Gerar token de assinatura" no GitLab e substitua o valor gerado pelo do Claude.
Ative Eventos de push e salve.
(Opcional) Use Teste > Eventos de push no novo webhook no GitLab e confirme que ele relata HTTP 200.
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.
Escolha entre upload manual e sincronização de repositório
Cenário | Abordagem recomendada |
Plugins mantidos em controle de versão com CI/CD | Sincronização GitHub ou GitLab |
Múltiplos desenvolvedores colaboram em plugins | Sincronização GitHub ou GitLab |
Você deseja propagação automática de atualizações | Sincronização GitHub ou GitLab |
Prototipagem rápida ou ferramentas pontuais | Upload manual |
Plugins criados por equipes não técnicas | Upload manual |
Ambientes sem acesso ao GitHub ou GitLab | Upload manual |
Testar um plugin antes de adicioná-lo a um repositório sincronizado | Upload manual |
Controlar distribuição 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:
Preferência | O que faz | O que os membros veem |
Instalado por padrão | Pré-instala o plugin para todos os membros da organização | O plugin aparece em sua lista sem nenhuma ação. Os membros podem desativá-lo se desejarem. |
Disponível para instalar | Listado na aba Descobrir | Os usuários o veem na aba Descobrir e podem adicioná-lo por conta própria. |
Não disponível | Oculto completamente | Os utilizadores não conseguem ver nem adicionar o plugin. Útil para preparação ou descontinuação de plugins. |
Obrigatório | Pré-instala o plugin para todos os membros da organização sem a opção de o remover | O plugin aparece na sua lista sem qualquer ação, marcado como "Este plugin é obrigatório na sua organização." Os utilizadores não conseguem desativá-lo nem removê-lo. Também permanece ativo nas sessões do Claude Code que sincronizam os plugins da conta do membro. |
Importante: Os plugins definidos como "Instalado por predefinição" ou "Obrigatório" também são instalados no Claude Code para utilizadores que iniciam sessão com a sua conta Claude. No Claude Code, os hooks, sub-agentes e servidores MCP do plugin são executados no computador do utilizador, e um plugin "Obrigatório" não pode ser desativado lá. Reveja os hooks de um plugin antes de o definir como "Obrigatório." Saiba mais sobre plugins sincronizados na documentação do Claude Code.
Definir preferências
Em Definições da organização > Plugins e competências, clique no separador "Inventário".
Localize o plugin e clique no botão de menu no final da sua linha.
Clique em "Acesso predefinido" e, em seguida, selecione uma opção em Instalar.
As alterações entram em vigor na próxima sessão ou atualização de plugin de cada membro.
O que os membros experienciam
Os membros procuram plugins disponíveis no separador Descobrir em Personalizar > Plugins. Os plugins que define como "Instalado por predefinição" ou "Obrigatório" aparecem na sua lista automaticamente. Os plugins que define como "Disponível para instalar" aparecem em Descobrir para os membros adicionarem por si próprios.
Os membros não conseguem editar plugins geridos pela organização, o que evita alterações conflituosas nas ferramentas partilhadas.
Personalizar o acesso ao plugin por grupo
Os administradores empresariais podem substituir a preferência de instalação de um plugin em toda a organização para grupos específicos. Por exemplo, pode instalar automaticamente um plugin para o grupo de Engenharia, disponibilizá-lo para o Departamento Jurídico instalar por sua conta e ocultá-lo de todos os outros.
O acesso ao plugin ao nível do grupo está disponível nos planos Enterprise. Pode defini-lo na mesma página Definições da organização > Plugins e competências, que requer um Proprietário ou uma função personalizada que inclua a gestão das bibliotecas da organização.
Como funcionam as substituições de grupo
Cada plugin no seu marketplace tem uma preferência de instalação em toda a organização (Instalado por predefinição, Disponível para instalar, Obrigatório ou Não disponível). Por predefinição, cada grupo herda essa definição em toda a organização.
Quando define uma substituição ao nível do grupo para um plugin, esta substitui a definição em toda a organização para os membros desse grupo. A ordem de resolução é: definição de grupo, depois definição em toda a organização, depois predefinição do marketplace.
Definir o acesso ao plugin para um grupo
Em Definições da organização > Plugins e competências, clique no separador "Inventário".
Localize o plugin que pretende personalizar e clique no botão de menu no final da sua linha.
Clique em "Acesso de grupo...".
Clique em "Adicionar grupos" junto a Direcionamento de instalação.
Selecione o grupo e escolha uma das preferências de instalação listadas acima.
Os grupos criados manualmente e os grupos aprovisionados por SCIM do seu fornecedor de identidade aparecem no seletor de grupos e funcionam da mesma forma.
O que acontece quando um membro está em vários grupos
Se um membro pertence a dois ou mais grupos com definições diferentes para o mesmo plugin, a definição mais permissiva aplica-se. A ordem da mais para a menos permissiva é: Obrigatório > Instalado por predefiniçã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 predefinição", um membro em ambos os grupos obtém o plugin instalado por predefinição.
Nota: Isto difere da forma como os limites de gastos de grupo se resolvem. Os limites de gastos aplicam o valor de grupo superior ou inferior dependendo da sua definição de Limite de gastos de vários grupos. O acesso ao plugin aplica o valor mais permissivo, porque os grupos aqui se destinam a permitir o acesso para equipas que precisam de uma ferramenta, não para atuar como limite de segurança. Se precisar de bloquear completamente um plugin, defina a sua preferência em toda a organização como "Não disponível" e conceda acesso apenas aos grupos que devem tê-lo.
O que acontece quando um grupo é eliminado
Se um grupo for removido (por exemplo, eliminado do seu fornecedor de identidade), a substituição permanece na interface de administração mas é marcada como órfã. Não tem efeito nos membros (uma vez que ninguém pertence a um grupo eliminado) e não conta para o crachá de acesso personalizado. Pode limpar as substituições órfãs nas definições "Acesso de grupo..." do plugin.
As definições de grupo persistem entre ressincronizações do marketplace?
Sim. As substituições ao nível do grupo persistem quando ressincroniza um marketplace ligado a GitHub ou GitLab. São removidas apenas se o próprio plugin for eliminado do marketplace.
Atualizar e remover plugins
Marketplaces manuais
Para atualizar um plugin, carregue um novo ficheiro ZIP com o mesmo nome de plugin. A nova versão substitui a existente automaticamente. Os nomes de plugin são o identificador único, portanto legal sempre substituirá legal.
Para remover um plugin, elimine-o do seu marketplace em Definições da organização > Plugins e competências no separador "Inventário".
Marketplaces sincronizados com GitHub
Envie as suas alterações para o repositório ligado, depois aceda a Definições da organização > Plugins e competências e clique no separador "Marketplaces", localize o seu marketplace e clique em "Atualizar" para ativar 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 pedido de pull com uma atualização de versão de plugin é intercalado no ramo predefinido do repositório.
Para marketplaces sincronizados com GitLab, consulte Configurar um marketplace sincronizado com GitLab.
Para remover um plugin, elimine-o do repositório e ative uma sincronização.
Limites
Limite | Valor | Notas |
Tamanho máximo de ZIP de plugin (carregamento) | 200 MB | Aplicado tanto no lado do cliente como no lado do servidor |
Máximo de plugins por marketplace (manual) | 1000 | Por marketplace |
Máximo de plugins por marketplace (sincronização GitHub ou GitLab) | 1000 | 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 sincronizado | Apenas privado ou interno no github.com e gitlab.com | Hospedado em github.com, GitHub Enterprise Server, gitlab.com ou uma instância GitLab auto-gerenciada. Hosts GitLab (incluindo gitlab.com) exigem uma configuração GitLab em Configurações da organização > Claude Code. |
Regras de nomenclatura
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:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Nomes que imitam marketplaces oficiais da Anthropic também são bloqueados.
Nota: Os autores de plugins podem definir um displayName para que um plugin mostre um nome legível no catálogo em vez de seu slug. Se um autor não definir um, o plugin mostra seu slug (por exemplo, deployment-tools).
Solução de problemas
Upload rejeitado
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 faça upload do plugin novamente.
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 ativados 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. 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.
Falha na sincronização do GitHub com erro de conteúdo
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 de plugin.
Falha na sincronização com "Tipo de fonte de plugin externo não suportado. Tipos suportados: git-subdir, github, url" ou plugins são ignorados com "Repositório não encontrado em gitlab.com. Verifique a URL e certifique-se de que o repositório é público."
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 namespace de grupo ou usuário de nível superior).
Para qualquer outra fonte privada, mova as pastas de plugin para o repositório de 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 & skills Clique em "Adicionar", "Fazer upload de um plugin" e 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, embora os membros possam compartilhar plugins com colegas ou grupos específicos se o compartilhamento estiver ativado.
Não consigo ver um repositório GitHub ao conectar
Certifique-se de que o Claude GitHub App está instalado nesse repositório. Seu token GitHub pessoal é verificado primeiro para confirmar o acesso, mas a sincronização em si usa o token de instalação do GitHub App.
"Não é possível acessar o repositório" ao ativar "Sincronizar automaticamente"
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:
Você não tem acesso de administrador ao repositório. Ativar a sincronização automática cria um webhook, que requer acesso de nível de administrador ao repositório através de sua conexão GitHub pessoal. Peça a um administrador do repositório para ativar a alternância ou faça com que seu acesso GitHub seja atualizado.
A permissão de Webhooks do Claude GitHub App não foi aprovada. Em instalações mais antigas, o GitHub mostra um prompt "Claude está solicitando permissões atualizadas". Um administrador de repositório ou organização precisa aprovar a permissão Webhooks (Leitura & Escrita) na instalação.
"Nenhuma instância GitLab está configurada para sua organização ainda. Adicione uma nas configurações do Claude Code e volte aqui" ao adicionar um marketplace
Se você vir esta mensagem ao adicionar um marketplace no GitLab, certifique-se de ter adicionado a configuração GitLab primeiro. Consulte Etapa 1: Adicionar uma configuração GitLab em Configurar um marketplace sincronizado com GitLab.
"Esta URL não está em uma instância GitLab configurada"
Certifique-se de que o nome do host da URL corresponde exatamente a um nome do host GitLab configurado.
Adicionar um projeto gitlab.com falha com "Falha ao criar marketplace. Tente novamente."
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.
O teste de conexão falha em Reach host (por exemplo "O nome do host não pôde ser resolvido," "A conexão foi recusada," ou "GitLab não respondeu a tempo"), ou adicionar um marketplace em uma instância auto-gerenciada falha com um erro genérico
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.
Erros que começam com "Falha na autenticação para …" ou "Acesso negado"
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).
