Muita empresa configura o MCP Server, publica o ai-catalog.json e acha que terminou a parte técnica.
Na prática, falta um arquivo essencial: o server.json.
Ele atua como o "manifesto oficial" do seu servidor, registrando o MCP no ecossistema e permitindo que agentes de IA o descubram e entendam corretamente.
Neste artigo você vai entender o que é o server.json, para que ele serve de verdade e por que ele completa o trio de arquivos essenciais.
O que é o server.json
O server.json é o arquivo de manifesto que descreve o seu MCP Server de forma padronizada para o ecossistema.
Enquanto o ai-catalog.json traz os dados concretos (produtos/serviços), o server.json informa quem é o servidor, qual é seu propósito e como deve ser usado.
É como a "carteira de identidade" oficial do seu MCP.
Por que ele existe (e o que os outros arquivos não resolvem)
O llms.txt dá contexto geral e o ai-catalog.json entrega os dados.
Mas nenhum dos dois informa aos agentes:
- Quem é o responsável pelo servidor
- Qual protocolo está sendo usado
- Quais capacidades estão disponíveis
- Como o servidor deve ser descoberto e integrado
O server.json resolve exatamente essa camada de registro e padronização.
O que costuma ir dentro do arquivo
Um server.json bem estruturado geralmente contém:
- Nome da empresa e identificação
- Versão do protocolo MCP
- Descrição do servidor
- Informações do proprietário (nome, CNPJ, site)
- Endpoints disponíveis (catalog, query etc.)
- Capabilities (produtos, serviços, preços, disponibilidade)
- Data da última atualização
Como ele registra seu MCP no ecossistema
Quando um agente encontra a URL do seu MCP Server, ele lê o server.json primeiro.
Com essas informações, o agente consegue:
- Validar a fonte
- Entender o escopo
- Registrar no MCP Registry oficial
- Integrar de forma confiável com outros agentes
Isso transforma seu servidor de "um endpoint qualquer" em uma fonte oficial reconhecida no ecossistema.
Diferença entre server.json, ai-catalog.json e llms.txt
- llms.txt: Índice curado do site. Tipo de informação: Orientação em Markdown.
- ai-catalog.json: Catálogo/serviços estruturados. Tipo de informação: Dados consultáveis.
- server.json: Manifesto e registro do servidor. Tipo de informação: Metadados e capacidades.
Os três se complementam. Nenhum substitui o outro.
Exemplos práticos de uso
E-commerce:
Pergunta: "Quais produtos da Empresa X estão disponíveis?"
- Com server.json: O agente reconhece o servidor oficial e consulta o catálogo com confiança.
- Sem ele: O agente pode não reconhecer a fonte ou ignorar o servidor.
Empresa de serviços:
Pergunta: "Quais planos a consultoria oferece?"
- Com server.json: O agente identifica as capabilities e retorna informações padronizadas.
- Sem ele: O agente pode não saber que tipo de dados pode consultar.
Erros comuns que prejudicam o arquivo
- Dados desatualizados: Perda de confiança do agente. Como evitar: Atualização automática.
- Campos obrigatórios faltando: Integração falha. Como evitar: Seguir o schema oficial.
- Informações inconsistentes: Agente ignora ou desconfia. Como evitar: Padronizar todos os campos.
- Não registrar no MCP Registry: Descoberta limitada. Como evitar: Completar o registro oficial.
- Achar que só o catálogo basta: Servidor fica invisível no ecossistema. Como evitar: Usar os três arquivos.
O próximo passo
O server.json só entrega valor quando está completo, consistente e integrado com o resto do MCP Server.
Antes de avançar, vale medir o ponto de partida atual do seu site.
O diagnóstico gratuito da Scrypta analisa em segundos:
- Rastreabilidade
- Dados estruturados
- Qualidade dos arquivos MCP (llms.txt, ai-catalog.json e server.json)
- Legibilidade geral para agentes de IA
Leva cerca de 15 segundos e mostra objetivamente o que falta para sua empresa ser bem registrada no ecossistema.