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)
As políticas de privacidade são obrigatórias?
Sim, as políticas de privacidade são obrigatórias em dois locais:
Local 1: README.md
Adicione uma seção "Privacy Policy" ao seu README com link para sua política de privacidade completa para que os usuários estejam cientes de suas práticas:
## Privacy Policy
This extension collects [describe data types]. For complete privacy information, see our privacy policy: https://your-domain.com/privacy-policy
### Data Collection
- [List what data is collected]
- [How it's used]
- [Whether it's shared with third parties]
- [Retention period]
Local 2: manifest.json
Adicione array privacy_policies com URLs HTTPS acessíveis publicamente:
Implementação completa: Veja MCPB Manifest Spec - Privacy Policies para:
Estrutura do campo de política de privacidade
Requisitos de versão do manifesto (0.3+)
Suporte a múltiplas URLs de política
Requisitos de validação
A política de privacidade deve cobrir:
Quais dados seu MCPB coleta
Como os dados são usados e armazenados
Se os dados são compartilhados com terceiros
Políticas de retenção de dados do usuário
Informações de contato para perguntas sobre privacidade
Requisitos:
Deve ser uma URL HTTPS acessível publicamente
Deve ser do seu domínio (não hospedagem de terceiros)
Deve ser atual e preciso
Deve estar no README E manifest.json
Deve usar manifest_version "0.3" ou superior
Erros comuns:
Política de privacidade no manifesto mas não no README
Política de privacidade no README mas não no manifesto
Usando manifest_version "0.2" ou anterior
URLs inválidas ou inacessíveis
Política de privacidade hospedada em site de terceiros
Impacto: Uma das causas mais comuns de rejeição - simples de corrigir mas frequentemente negligenciada.
Quantos exemplos são obrigatórios?
MÍNIMO de três exemplos funcionais demonstrando funcionalidade principal.
O que se qualifica como um bom exemplo:
Mostra caso de uso realista
Inclui entrada/prompt esperado do usuário
Mostra saída/comportamento esperado
Demonstra uso real de ferramentas
Fluxo de trabalho claro e compreensível
Formato de exemplo (em README.md):
## Examples
### Example 1: Search for files
**User prompt:** "Find all JavaScript files in my project"
**Expected behavior:**
- Extension searches workspace directory
- Returns list of .js files with paths
- Shows file count in summary
### Example 2: Read file contents
**User prompt:** "Show me the contents of config.json"
**Expected behavior:**
- Extension reads config.json
- Returns formatted JSON content
- Handles file not found gracefully
### Example 3: Create new file
**User prompt:** "Create a new file called notes.txt with 'Hello World'"
**Expected behavior:**
- Extension creates notes.txt
- Writes content to file
- Confirms creation with file path
O que incluir:
Prompts de usuário realistas (como os usuários interagirão)
Chamadas de ferramentas esperadas (o que acontece nos bastidores)
Saídas esperadas (o que os usuários verão)
Exemplos de tratamento de erros (opcional mas recomendado)
Requisitos:
Mínimo 3 exemplos (sem máximo)
Cobrir funcionalidade principal
Mostrar diferentes ferramentas/capacidades
Demonstrar proposta de valor
Incluir em README.md
Impacto: Uma fonte frequente de atrasos ou rejeições - os revisores precisam de documentação completa para avaliar adequadamente os envios.
Preciso fornecer credenciais de teste?
Se seu MCPB requer autenticação ou acesso a serviço externo, então SIM.
Obrigatório quando:
Seu MCPB se conecta a APIs externas
Autenticação é necessária para funcionalidade
O usuário do MCPB deve ter uma conta para usar recursos
Integração de serviço externo de outra forma presente
Não obrigatório quando:
MCPB puramente local (apenas operações de sistema de arquivos)
Sem conexões externas
Sem autenticação necessária
Completamente autossuficiente
O que fornecer:
Credenciais de conta de teste (nome de usuário/senha ou chaves de API)
Dados de amostra na conta (útil para testes funcionais)
Instruções de configuração (como configurar e usar conta de teste)
Limitações ou restrições de acesso (se houver)
Data de expiração da conta (se temporária)
Como fornecer:
Incluir no formulário de envio
Enviar via método seguro se altamente sensível
Garantir que a conta permaneça ativa durante o período de revisão
Fornecer nível de acesso suficiente para testes completos
Melhor prática: Criar conta de teste dedicada separada da produção para:
Evitar expor dados de produção
Controlar o que os revisores podem acessar
Revogar acesso facilmente após aprovação
Rastrear uso da conta de teste
Impacto: Atrasa o processo de revisão se faltando quando necessário
Qual documentação é obrigatória?
Documentação abrangente em README.md com seções mínimas obrigatórias.
Seções mínimas obrigatórias:
Description - Explicação clara do que seu MCPB faz
Features - Capacidades principais e casos de uso
Installation - Como instalar (tipicamente: "Install from Anthropic Directory")
Configuration - Configurações obrigatórias e etapas de configuração
Usage Examples - Mínimo 3 exemplos (veja seção acima)
Privacy Policy - Link para política de privacidade completa
Support - Como os usuários podem obter ajuda ou relatar problemas
Estrutura de exemplo README.md:
# My MCPB Extension
## Description
Brief description of what this extension does and why it's useful.
## Features
- Feature 1: [description]
- Feature 2: [description]
- Feature 3: [description]
## Installation
Install from the Anthropic Directory in Claude Desktop Settings → Extensions.
## Configuration
1. Open Settings → Extensions → [Extension Name]
2. Add API key (if required)
3. Select workspace directory
4. Configure optional settings
## Examples
[See minimum 3 examples section above]
## Privacy Policy
See our privacy policy: https://your-domain.com/privacy
## Support
For issues or questions: [email protected]
GitHub Issues: https://github.com/your-username/your-extension/issues
Seções adicionais recomendadas:
Troubleshooting - Problemas comuns e soluções
Version compatibility - Quais versões do Claude Desktop são suportadas
Changelog - Histórico de versões e mudanças
Contributing - Como outros podem contribuir (para código aberto)
Melhores práticas:
Escrita clara e concisa
Screenshots (opcional mas muito útil)
Instruções passo a passo
Links para recursos adicionais
3. Processo de Envio
Como envio para o diretório?
Antes de enviar para o diretório, complete este processo de envio passo a passo:
1. Lista de verificação pré-envio:
Teste seu MCPB:
Passa em todas as 4 fases de teste (desenvolvimento, ambiente limpo, multiplataforma, Claude Desktop)
Funciona em ambiente limpo sem ferramentas de desenvolvimento
Portável entre macOS e Windows
Dependências atuais e agrupadas
Mensagens de erro são úteis e acionáveis
Desempenho é aceitável
Verificar requisitos obrigatórios:
Todas as ferramentas têm anotações readOnlyHint OU destructiveHint
Política de privacidade presente em README.md
Política de privacidade presente em array privacy_policies do manifest.json
Usar versão de Manifesto mais recente para melhor compatibilidade
Mínimo 3 exemplos funcionais documentados em README
Credenciais de teste fornecidas (se aplicável)
Preparar documentação:
README.md completo com todas as seções obrigatórias
Arquivo LICENSE incluído
Ícone incluído (recomendado, PNG 512×512px)
CHANGELOG.md (opcional mas recomendado)
2. Empacotar versão final:
# Clean build
rm -rf node_modules/.cache
npm install --production
# Package
mcpb pack
# Verify package
mcpb info your-extension.mcpb
3. Enviar via formulário oficial:
Formulário de envio: https://forms.gle/tyiAZvch1kDADKoP9
Informações obrigatórias: Detalhes do servidor, links de documentação, credenciais de teste, exemplos (mínimo 3) e informações de contato. O formulário fornece uma lista completa.
Embora nos esforcemos para revisar cada envio o mais rápido possível, devido ao volume de interesse não podemos prometer que aceitaremos seu envio ou responderemos a ele individualmente.
4. Problemas Comuns
Quais são as razões mais comuns para solicitações de revisão?
Estes são os principais problemas com base em dados de envio:
1. Anotações de ferramentas faltando
Problema: Ferramentas sem anotações obrigatórias readOnlyHint ou destructiveHint
Solução: Adicionar anotações a TODAS as ferramentas em sua implementação de servidor
Impacto: Rejeição imediata, requer mudanças de código
Prevenção: Executar comando de validação antes do envio
2. Problemas de portabilidade
Problema: Funciona em ambiente de desenvolvedor mas falha para usuários finais
Causas comuns: Caminhos codificados, dependências faltando, suposições de plataforma
Solução: Testar em ambiente limpo, usar substituição de variáveis, agrupar dependências
Impacto: Atraso de 1-2 semanas para solução de problemas e reenvio
Prevenção: Fase de teste em ambiente limpo
3. Política de privacidade faltando
Problema: Política de privacidade faltando em README.md ou manifest.json (ou ambos)
Solução: Adicionar seção de política de privacidade ao README e array privacy_policies ao manifesto
Impacto: Rejeição imediata
Prevenção: Usar lista de verificação pré-envio
4. Documentação incompleta
Problema: Menos de 3 exemplos, instruções de configuração pouco claras, seções faltando
Solução: Adicionar exemplos abrangentes (mínimo 3