Como Publicar um Servidor MCP: Guia Completo para Mantenedores
Aprenda a publicar um servidor MCP listando-o no registro oficial, enviando para Wellknown e reivindicando a propriedade.
Publicar um servidor MCP envolve tornar seu servidor descobrível e verificável por aplicações de IA e índices como o Wellknown. Para isso, você deve publicar seu servidor como um pacote ou expô-lo como um endpoint remoto, listá-lo no registro oficial MCP, enviá-lo diretamente para o Wellknown e, opcionalmente, reivindicar a propriedade para verificar o controle.
Principais pontos
- Um servidor MCP pode ser publicado como um pacote local (npm, PyPI) ou um endpoint HTTP remoto.
- Listar seu servidor no registro oficial MCP em registry.modelcontextprotocol.io é a principal forma de torná-lo encontrável.
- O Wellknown indexa servidores MCP de múltiplas fontes, incluindo o registro MCP, npm, PyPI e envios diretos.
- Você pode enviar seu servidor MCP diretamente para o Wellknown via o endpoint de submissão em
/api/v1/submit. - Reivindicar seu registro de servidor envolve provar o controle usando provas de reivindicação como registros DNS TXT ou arquivos em URLs well-known.
O que é um servidor MCP e por que publicá-lo?
Um servidor MCP é um programa que utiliza o Model Context Protocol (MCP), expondo ferramentas, recursos e prompts para aplicações de IA. Publicar seu servidor MCP o torna descobrível por clientes e índices de IA, permitindo maior uso e integração. Servidores podem ser pacotes locais instalados via npm ou PyPI, ou endpoints HTTP remotos acessíveis pela rede.
Formas de publicar um servidor MCP
1. Publique como pacote ou exponha um endpoint remoto
- Pacotes locais: Publique seu servidor MCP como um pacote npm ou PyPI. O Wellknown indexa 26.163 pacotes npm e 19.956 pacotes PyPI que são servidores MCP.
- Endpoints remotos: Exponha seu servidor MCP como um endpoint HTTP remoto usando protocolos como Streamable HTTP ou SSE. O Wellknown observa 29.969 servidores MCP usando Streamable HTTP.
2. Liste no registro oficial MCP
O registro MCP em registry.modelcontextprotocol.io é o local autoritativo onde os mantenedores listam seus servidores com um documento server.json. Este registro é a maior fonte para o Wellknown, fornecendo 46.271 registros. Listar seu servidor aqui garante sua inclusão no principal ecossistema de descoberta.
3. Envie diretamente para o Wellknown
O Wellknown oferece um endpoint API de submissão em /api/v1/submit onde mantenedores podem enviar seus registros de servidores MCP diretamente. Isso é útil se seu servidor ainda não estiver listado em outras fontes ou se quiser garantir inclusão imediata.
4. Reivindique seu registro de servidor
Reivindicar seu registro de servidor MCP prova seu controle sobre o domínio ou repositório, tornando seu registro verificado e confiável. O Wellknown suporta três provas de reivindicação:
- Adicionar um registro DNS TXT em
_wellknown.SEU-DOMÍNIO - Hospedar um arquivo em
https://SEU-DOMÍNIO/.well-known/wellknown-verify.txt - Colocar um arquivo
.wellknown-verifyna raiz do repositório
Tokens de reivindicação são válidos por 7 dias, portanto as reivindicações devem ser renovadas periodicamente.
Como o Wellknown indexa servidores MCP
O Wellknown é um índice ativo de agentes de IA, servidores MCP e ferramentas. Ele separa metadados declarados do status observado verificando endpoints ativamente. Coleta registros de servidores MCP de várias fontes:
- Registro MCP (46.271 registros)
- Pacotes npm (20.823 registros)
- Pacotes PyPI (19.900 registros)
- Cartões de agentes A2A (2.646 registros)
- Catálogos ARD e repositórios GitHub
- Envios diretos (79 registros)
- Reivindicações (147 registros)
De 73.518 servidores MCP indexados, 22.087 estão ativos (live), ou seja, com verificação bem-sucedida nas últimas 24 horas.
Status observado e confiabilidade
Publicar seu servidor MCP não é apenas listá-lo, mas também manter sua disponibilidade. O Wellknown mede o status dos servidores como ativo (live), recentemente observado, indisponível ou desconhecido, baseado no sucesso e na atualidade das verificações. Servidores ativos têm verificações bem-sucedidas em até 24 horas, o que é crucial para descoberta e confiança.
Resumo
Para publicar um servidor MCP de forma eficaz:
- Empacote-o para npm ou PyPI ou exponha como endpoint HTTP remoto.
- Liste-o no registro oficial MCP com um
server.json. - Envie-o diretamente para o Wellknown usando a API.
- Reivindique seu registro para verificar a propriedade.
- Mantenha o uptime para manter seu servidor ativo e descobrível.
Este guia reflete dados e práticas até 2026-10-28.