Este é um guia completo para enviar seu servidor local (MCPB) para o diretório público da Anthropic para distribuição e descoberta mais amplas.
Pré-requisitos
Antes de ler este guia, você deve ter:
Um MCPB funcionando
Código portável usando substituição de variáveis
Boas mensagens de erro e experiência do usuário
Dependências limpas e agrupadas
Novo no desenvolvimento de MCPB? Veja Building MCPB Extensions primeiro. Para as melhores práticas técnicas (testes, mensagens de erro, portabilidade), veja MCPB Repository.
Nota: Este guia cobre servidores MCP locais. Para extensões de desktop remotas, veja Remote MCP Server Submission Guide.
1. Visão Geral do Diretório
Quais são os benefícios da inclusão no diretório?
Descoberta e confiança:
Listado no diretório oficial da Anthropic dentro do Claude Desktop
Pesquisável por usuários individuais do Claude Desktop
Visível para usuários de Teams/Enterprise quando adicionado à lista de permissões por administradores
A revisão da Anthropic constrói confiança do usuário
Experiência do usuário:
Instalação com um clique a partir do diretório
Integrado com a interface de configurações do Claude Desktop
Apresentação padronizada
Suporte e credibilidade:
Revisão da Anthropic de qualidade e segurança
Listado junto com outras extensões revisadas
Visibilidade da comunidade e feedback
Canal de distribuição profissional
2. Requisitos Obrigatórios
Todos os requisitos nesta seção são obrigatórios para aprovação no diretório. A falta de qualquer um deles resultará em rejeição ou solicitação de revisão.
Nota: Estes são requisitos específicos do diretório da Anthropic.
Para as melhores práticas gerais de desenvolvimento de MCPB (testes, tratamento de erros, portabilidade), veja o MCPB Repository README.
As anotações de ferramentas são obrigatórias?
SIM. Cada ferramenta DEVE ter e manter anotações de segurança precisas.
Obrigatório em cada ferramenta:
readOnlyHint: true - Para ferramentas que apenas leem dados
destructiveHint: true - Para ferramentas que modificam dados ou têm efeitos colaterais
Veja MCP Protocol - Tool Annotations para o esquema completo e detalhes de implementação.
Não é opcional. Este é um requisito obrigatório derivado da MCP Directory Policy.
Como decidir qual anotação:
Comportamento da Ferramenta | Anotação | Exemplos |
Apenas lê dados | readOnlyHint: true | search, get, list, fetch, read |
Escreve/modifica dados | destructiveHint: true | create, update, delete, send, write |
Cria arquivos temporários | destructiveHint: true | Até mesmo escritas temporárias contam |
Envia solicitações externas | destructiveHint: true | Emails, notificações, webhooks |
Armazena em cache apenas internamente | readOnlyHint: true | Otimização interna OK |
Detalhes de implementação: Veja MCP Protocol - Tools para:
Esquema completo de ferramentas com anotações
Estrutura de definição de ferramentas
Especificações de esquema de entrada/saída
Propriedades adicionais de ferramentas (incluindo campo de título opcional)
Validação antes do envio:
# Verificar se todas as ferramentas têm anotações
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# Verificar se cada ferramenta tem exatamente uma anotação
Impacto: A primeira coisa que verificamos e a razão mais comum para uma solicitação de revisão.
Anotação adicional recomendada:
title - Nome da ferramenta legível para exibição na interface (melhora a experiência do usuário)