Este é um guia completo para enviar seu servidor MCP remoto ao Diretório MCP da Anthropic para distribuição e descoberta mais amplas.
Pré-requisitos
Antes do envio do servidor, você deve ter:
Um servidor MCP remoto funcional e totalmente testado
Autenticação OAuth 2.0 implementada (se autenticação for necessária)
Todas as ferramentas com anotações de segurança apropriadas
Implantação pronta para produção
Um canal de suporte dedicado (email ou web)
Conta de teste provisionada com dados de exemplo
Documentação abrangente
Novo no desenvolvimento de MCP remoto? Veja Introdução aos Conectores Personalizados Usando MCP Remoto primeiro. Para melhores práticas técnicas e detalhes do protocolo, veja Documentação do Protocolo MCP.
Nota: Este guia cobre servidores MCP remotos (hospedados em nuvem, HTTPS). Para extensões de desktop local, veja Guia de Envio de Servidor MCP Local.
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 MCP oficial da Anthropic acessível a partir de Claude.ai
Acessível aos usuários do Claude em todas as plataformas (web, desktop, mobile)
Visibilidade profissional para seu serviço
Experiência do usuário:
Conexão com um clique a partir do diretório
Integrado com a interface de conectores do Claude
Apresentação padronizada em todas as plataformas
Fluxo OAuth tratado perfeitamente
Suporte e credibilidade:
Revisão da Anthropic de qualidade, segurança e conformidade
Listado ao lado de outros conectores verificados
Visibilidade da comunidade e feedback
Canal de distribuição profissional
Quais plataformas Claude suportam servidores MCP remotos?
Todas as principais plataformas Claude:
Claude.ai (web) - Suporte completo com OAuth
Claude Desktop - Suporte completo com OAuth
Claude Code - Conexão direta da máquina do usuário (com suporte OAuth)
Claude API - Suporte de integração
Aplicativos Claude Mobile - Suporte de conectores
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ções de revisão.
As anotações de segurança são obrigatórias?
SIM - Cada ferramenta DEVE ter 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 - Anotações de Ferramentas para o esquema completo e detalhes de implementação.
Não é opcional. Este é um requisito obrigatório derivado da Política do Diretório MCP.
Como decidir qual anotação:
Comportamento da Ferramenta | Anotação | Exemplos |
Apenas lê dados | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
Escreve/modifica dados | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
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 |
Anotação adicional recomendada:
title - Nome da ferramenta legível para exibição na UI (melhora a experiência do usuário)
Preciso fornecer contas de teste?
SIM - Se seu servidor exigir autenticação.
O que fornecer:
Credenciais da conta de teste (nome de usuário/senha ou chaves de API)
Dados de exemplo na conta (necessário para testes funcionais)
Instruções de configuração para ambiente de teste
Limitações de acesso (se houver)
As contas de teste devem ter:
Acesso a todas as ferramentas sendo revisadas
Dados de exemplo representativos
Permissões apropriadas para testes de funcionalidade completa
Status ativo durante o período de revisão e além
Como fornecer:
Inclua credenciais no formulário de envio (idealmente compartilhadas via método seguro, como link 1Password)
Garanta que as contas permaneçam ativas durante e após a revisão para revisões periódicas pós-admissão
Forneça acesso suficiente para testes abrangentes
OAuth 2.0 é obrigatório?
SIM - Se seu servidor exigir autenticação.
Requisitos de implementação OAuth:
Deve usar fluxo de código de autorização OAuth 2.0
Certificados de autoridades reconhecidas
Adicione à lista de permissões URLs de callback do cliente MCP local (por exemplo, Claude Code, MCP Inspector):
http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
Adicione à lista de permissões URLs de callback do Claude:
Configuração apropriada de URI de redirecionamento
Problemas comuns de OAuth a evitar:
Erros de URI de redirecionamento inválido (garanta que ambas as URLs de callback estejam na lista de permissões)
Solicitações HEAD sem tokens (trate com elegância após fluxo OAuth)
Orientação de implementação: Veja Estrutura de Autorização OAuth 2.0 para detalhes completos de implementação OAuth.
Existem requisitos de firewall?
SIM - Deve adicionar à lista de permissões os endereços IP do Claude para compatibilidade com claude.ai
Para servidores atrás de firewalls, adicione à lista de permissões endereços IP de https://docs.claude.com/en/api/ip-addresses.
Obrigatório para: Claude.ai e Claude Desktop
Não obrigatório para: Claude Code (conecta diretamente da máquina do usuário)
Importante: A adição à lista de permissões de IP sozinha não é recomendada como medida de segurança. Use OAuth 2.0 para autenticação sempre que possível.
Qual documentação é obrigatória?
Documentação abrangente do servidor com seções específicas.
Seções recomendadas:
Descrição do Servidor - Explicação clara do que seu servidor faz
Recursos - Capacidades principais e casos de uso
Instruções de Configuração - Como os usuários se conectam e configuram
Autenticação - Configuração OAuth e requisitos (se aplicável)
Exemplos de Uso - Mínimo de 3 exemplos funcionais com prompts (obrigatório)
Política de Privacidade - Link para política de privacidade completa
Suporte - Como os usuários podem obter ajuda ou relatar problemas
Exemplo de estrutura de documentação:
# [Nome do Seu Serviço] Servidor MCP
## Descrição
[Breve descrição da integração de serviço e capacidades]
## Recursos
- Recurso 1: [descrição e valor]
- Recurso 2: [descrição e valor]
- Recurso 3: [descrição e valor]
## Configuração
1. Visite o [Diretório MCP da Anthropic](https://claude.com/connectors)
2. Encontre e conecte-se a [Seu Serviço]
3. Complete a autenticação OAuth
4. Configure as configurações necessárias
## Autenticação
Este servidor requer autenticação OAuth. Você precisará de:
- Conta válida de [Seu Serviço]
- [Quaisquer permissões específicas ou tipos de conta]
## Exemplos
[Veja seção de mínimo 3 exemplos abaixo]
## Política de Privacidade
Veja nossa política de privacidade: https://seu-dominio.com/privacy
## Suporte
- Email: [email protected]
- Documentação: https://seu-dominio.com/mcp-docs
- Problemas: https://github.com/suaempresa/mcp-server/issues
Quantos exemplos de uso são obrigatórios?
MÍNIMO de três exemplos funcionais demonstrando funcionalidade principal.
O que se qualifica como um bom exemplo:
Mostra prompt/solicitação realista do usuário
Demonstra funcionalidade real do servidor
Inclui saída esperada ou comportamento
Fluxo de trabalho claro e compreensível
Cobre diferentes capacidades
Formato de exemplo:
## Exemplos
### Exemplo 1: Pesquisar documentos
**Prompt do usuário:** "Encontre relatórios de projeto recentes em meu espaço de trabalho"
**O que acontece:**
- Servidor pesquisa seu espaço de trabalho
- Retorna documentos correspondentes com metadados
- Fornece links de acesso rápido
### Exemplo 2: Criar novo conteúdo
**Prompt do usuário:** "Crie uma nova lista de tarefas para a campanha de marketing"
**O que acontece:**
- Servidor cria nova lista de tarefas
- Adiciona estrutura inicial baseada no contexto
- Retorna link para lista recém-criada
### Exemplo 3: Atualizar dados existentes
**Prompt do usuário:** "Atualize o status do projeto para 'Em Progresso' e adicione o marco de hoje"
**O que acontece:**
- Servidor localiza o projeto
- Atualiza campo de status
- Adiciona marco com data atual
- Confirma alterações feitas
Requisitos:
Mínimo de 3 exemplos (sem máximo)
Cobrir diferentes ferramentas/capacidades
Mostrar interações realistas do usuário
Demonstrar proposta de valor
Incluir na documentação do servidor
Quais são os requisitos de prontidão para produção?
O servidor deve estar em status de Disponibilidade Geral (GA).
Pronto para produção significa:
Servidor é estável e confiável em produção
Não marcado como "beta", "alpha" ou "desenvolvimento"
Todos os recursos totalmente implementados e testados
Tratamento de erros apropriado e falhas elegantes
Infraestrutura escalável e monitoramento
Documentação completa e canais de suporte
Não pode ser incluído: Versões beta, servidores de desenvolvimento ou serviços de acesso limitado.
Quais requisitos técnicos devem ser atendidos?
Deve atender aos padrões de conformidade técnica principal.
Transporte e Desempenho:
Deve suportar transporte HTTP Streamable (suporte SSE pode ser descontinuado)
Tempos de resposta rápidos com alta disponibilidade
Tratamento de erros elegante com mensagens úteis
Respostas eficientes em tokens (máximo 25.000 tokens por resultado de ferramenta)
Segurança e Dados:
HTTPS/TLS com certificados válidos
CORS configurado adequadamente para clientes de navegador
Suporte para todas as origens de cliente Claude necessárias
Coletar apenas dados necessários para funcionalidade
Sem coleta de dados de conversa extraneous
Práticas de dados em conformidade com privacidade
3. Processo de Envio
Como envio meu servidor MCP remoto?
Siga este processo de envio passo a passo:
1. Lista de verificação pré-envio:
Verifique requisitos obrigatórios:
[ ] Todas as ferramentas têm anotações readOnlyHint OU destructiveHint
[ ] OAuth 2.0 implementado (se autenticação for necessária)
[ ] Servidor acessível via HTTPS
[ ] Endereços IP do Claude adicionados à lista de permissões (se atrás de firewall)
[ ] Documentação abrangente publicada
[ ] Política de privacidade publicada e acessível
[ ] Canais de suporte dedicados (email ou web)
[ ] Conta de teste pronta (se autenticação for necessária)
[ ] Servidor pronto para produção (status GA)
Teste seu servidor:
[ ] Funciona corretamente a partir de Claude.ai
[ ] Funciona corretamente a partir de Claude Desktop
[ ] Funciona corretamente a partir de Claude Code (se sem restrições de IP)
[ ] Fluxo OAuth é concluído com sucesso
[ ] Todas as ferramentas funcionam conforme documentado
[ ] Mensagens de erro são úteis e amigáveis ao usuário
[ ] Desempenho é aceitável sob carga
2. Preencha o formulário de envio:
Formulário de envio: Formulário de Revisão de Servidor do Diretório MCP
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 ferramenta ausentes
Problema: Ferramentas sem anotações de segurança obrigatórias
Solução: Adicione readOnlyHint ou destructiveHint a TODAS as ferramentas
Impacto: Rejeição imediata, requer alterações de código
Prevenção: Valide todas as ferramentas antes do envio
2. Problemas de implementação OAuth
Problema: Fluxo OAuth falha ou tem erros de configuração
Causas comuns:
URLs de callback ausentes no provedor OAuth
Configuração de URI de redirecionamento inválida
Configuração incorreta de firewall
Solução: Teste o fluxo OAuth completamente com MCP Inspector, Claude Code ou Claude.ai
Impacto: Não é possível concluir testes funcionais, atrasa aprovação
3. Documentação incompleta
Problema: Exemplos ausentes, instruções de configuração pouco claras ou seções obrigatórias ausentes
Solução: Forneça mínimo de 3 exemplos detalhados e complete todas as seções de documentação
Impacto: Solicitação de revisão, atrasa aprovação
Prevenção: Siga o modelo de documentação exatamente
4. Preocupações com prontidão para produção
Problema: Servidor marcado como "beta" ou mostra problemas de instabilidade
Solução: Garanta status GA e implantação de produção estável
Impacto: Não pode ser incluído até estar pronto para produção
Prevenção: Complete testes internos e validação de estabilidade
5. Problemas de política de privacidade/canal de suporte
Problema: URLs ausentes ou inacessíveis para política de privacidade/canais de suporte
Solução: Forneça política de privacidade apropriada e canais de suporte (email ou web)
Impacto: Rejeição imediata devido a requisito de política
Prevenção: Verifique acessibilidade de política de privacidade/canal de suporte antes do envio