Portal de envio de plugins do Claude: guia passo a passo

Se você quer encontrar o portal de envio de plugins do Claude, o caminho é o portal de desenvolvedores da Anthropic: claude.ai/directory/manage. Hoje, a opção fica em Submit new → Plugin bundle. Para colocar a listagem no ar, porém, também é preciso ter um repositório público no GitHub, um plano e uma função elegíveis, além de passar pela análise.

Como funciona o envio de plugins do Claude

O processo oficial começa na documentação de envio de plugins da Anthropic — não no repositório público do marketplace no GitHub. Cada pasta de plugin é enviada separadamente, mesmo que vários plugins estejam no mesmo repositório.

Este guia trata da distribuição no diretório público, não do compartilhamento privado com uma equipe nem da instalação local de um plugin.

Prepare tudo antes de abrir o portal

Deixe o repositório pronto antes de começar o envio.

1. Coloque o plugin no GitHub

O diretório lê os plugins a partir do github.com, e a Anthropic informa que o repositório precisa ser público antes de a listagem entrar no ar. Se o plugin estiver dentro de uma subpasta, anote o caminho até ela.

Um plugin padrão do Claude Code costuma ter uma estrutura parecida com esta:

plugin-name/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json          # opcional
├── commands/          # opcional
├── agents/            # opcional
├── skills/            # opcional
└── README.md

O manifesto e o README fornecem boa parte das informações exibidas na listagem. Antes de enviar, confira também a licença do plugin e os serviços externos usados por ele.

2. Faça a validação local

A partir do diretório que contém a pasta do plugin, execute:

claude plugin validate ./<plugin-folder>

O comando identifica problemas de estrutura e formatação, mas a etapa Validate do portal faz verificações adicionais. Encare a validação local como uma primeira triagem, não como uma aprovação.

3. Envie o conector MCP separadamente, quando necessário

Se o plugin usar um servidor MCP remoto operado por você e esse servidor ainda não tiver sido enviado, o guia da Anthropic orienta fazer um envio separado como MCP connector. O pacote do plugin e o conector são listagens diferentes no diretório.

Como enviar um Plugin bundle passo a passo

1. Escolha Plugin bundle

Abra o portal de desenvolvedores e selecione Submit new. Quando o portal perguntar o que você quer enviar, escolha Plugin bundle. A opção MCP connector deve ser usada apenas quando o objetivo for cadastrar um servidor MCP remoto como uma listagem própria.

2. Informe o repositório, o caminho e a branch

Na etapa Source, informe:

• A URL do GitHub ou o formato owner/repo.
• Plugin path, caso .claude-plugin/plugin.json não esteja na raiz do repositório.
• Branch or tag, se o diretório precisar acompanhar algo diferente da branch padrão.

Uma tag permanece vinculada ao commit correspondente até que você altere a tag. Se o nome da branch contiver uma barra, informe-o explicitamente ou use o formato owner/repo@branch descrito no guia oficial de envio.

Selecione Validate. Se algum problema bloquear o envio, corrija o repositório, faça o push da alteração e valide novamente. O resultado da validação vale para um único commit.

3. Revise a listagem gerada

A etapa Listing details mostra como o plugin aparecerá no diretório. A Anthropic extrai essas informações do plugin.json e do README.

Quando precisar corrigir o nome ou a descrição curta, altere os arquivos de origem. O diretório oficial de plugins da Anthropic também alerta que o slug usado na instalação de um plugin publicado deve permanecer estável, pois os usuários podem encontrar o erro plugin-not-found. Para mudanças comuns no texto exibido, use um rótulo de apresentação; deixe o mapeamento de renomeação para migrações realmente necessárias.

4. Responda às perguntas sobre tratamento de dados

Na etapa Data handling, o portal pergunta se o plugin:

• Lê ou armazena dados pessoais.
• Envia dados para serviços além dos conectores declarados.
• Retém dados e por quanto tempo.
• É direcionado a pessoas menores de 18 anos.

Responda com base no funcionamento real da implementação. Inclua serviços remotos, acesso a arquivos, telemetria e políticas de retenção.

5. Complete as confirmações de conformidade

Em Compliance, confirme um e-mail de contato pelo qual a Anthropic possa falar com você e marque as confirmações exigidas. O plugin precisa estar de acordo com a política do Software Directory da Anthropic.

6. Envie o plugin e escolha como as atualizações serão entregues

Na etapa Review and submit, confira os dados e escolha como as novas versões serão identificadas:

• GitHub push webhook, selecionado por padrão no guia atual; quando configurado, pode disparar verificações após os pushes.
• Scheduled check only, que depende de verificações programadas da branch ou tag acompanhada.

Selecione Submit for review. É necessário ter acesso de administrador no GitHub para configurar o webhook. Atualmente, a Anthropic limita cada organização a 10 envios em qualquer período de 24 horas, e rascunhos salvos e envios retirados também entram nessa contagem. Esses limites e as configurações de atualização estão documentados no fluxo de envio.

O que acontece depois do envio

A Anthropic analisa o commit mais recente da branch ou tag acompanhada, executa novamente a validação do diretório e faz uma varredura de segurança. O guia oficial descreve os seguintes estados:

Uma versão aprovada não necessariamente fica disponível na hora. A configuração padrão pode exigir uma solicitação de publicação e a publicação por um avaliador; o portal também oferece opções de publicação automática para algumas versões posteriores que forem aprovadas.

Abra o plugin em Submissions e consulte Versions para acompanhar o andamento. Depois de fazer uma correção, use Check for new commits, quando essa opção estiver disponível. Para atualizar o plugin, faça push na branch acompanhada ou mova a tag monitorada — não é necessário preencher o formulário novamente. A última versão publicada continua disponível enquanto uma nova versão falha ou aguarda análise.

Verificações de segurança que não devem ser ignoradas

O diretório oficial da Anthropic alerta que os plugins podem incluir servidores MCP, arquivos e outros softwares que não estão sob controle da Anthropic. Antes de enviar, documente todos os serviços externos, permissões, períodos de retenção e ações executadas em segundo plano.

“Bom, eu pedi para ele auditar por que meus envios de plugins falharam e corrigir o problema.” — @tarasshyn, X, descrevendo uma falha no envio e o processo de auditoria.

Use esta lista de verificação:

1. Declare e documente todos os serviços acessados externamente.
2. Explique no README as permissões, a configuração, o fluxo de dados e a retenção.
3. Confirme que a referência acompanhada contém exatamente o código que você pretende publicar.
4. Faça uma nova validação depois de cada commit de correção.
5. Informe a existência de indexação em segundo plano, telemetria ou comportamentos automatizados que possam gerar custos.

FAQ: envio de plugins do Claude

O repositório do GitHub precisa ser público?

Sim. A documentação atual da Anthropic diz que o repositório precisa ser público antes de a listagem entrar no ar.

Posso enviar vários plugins do mesmo repositório?

Sim, mas cada pasta de plugin é um envio separado. Informe cada caminho relevante individualmente no portal.

Posso enviar o plugin por pull request para o repositório da comunidade?

Não. O README do marketplace da comunidade da Anthropic descreve esse repositório como um espelho somente para leitura e informa que pull requests diretos são fechados automaticamente. Use o portal de desenvolvedores.

Preciso enviar um servidor MCP remoto separadamente?

Se o plugin usar um servidor MCP remoto operado por você e esse servidor ainda não estiver listado, faça um envio separado como MCP connector.

O que acontece quando a validação falha?

Corrija o repositório, faça push da alteração e valide novamente. A validação se aplica a um commit específico. Depois do envio, use a verificação de novo commit do portal, quando ela estiver disponível.

Uma varredura aprovada publica o plugin automaticamente?

Nem sempre. Uma versão aprovada ainda pode exigir Publish e publicação por um avaliador. A configuração de publicação automática do portal define como as versões posteriores aprovadas serão tratadas.

Posso remover um plugin publicado do diretório?

Sim. Abra o plugin publicado no portal de desenvolvedores e solicite Delist plugin. A Anthropic informa que a alteração pode levar algum tempo para chegar a todos os aplicativos do Claude, e os usuários atuais podem deixar de receber atualizações.

Para publicar no diretório, o caminho mais curto é: tornar o repositório público, validar localmente, enviar como Plugin bundle, corrigir os problemas específicos do commit, concluir as etapas de dados e conformidade e publicar a versão aprovada. Quando o alcance do diretório não compensar a revisão e a manutenção públicas, mantenha o pacote restrito à equipe.