Configuração MCP: entenda a estrutura, a conexão e as permissões
Organizar o MCP em três etapas facilita o diagnóstico: revise a estrutura, teste a conexão e avalie o servidor e as permissões solicitadas. A verificação de estrutura cobre a primeira etapa; conectividade e confiança precisam de verificações próprias.
São 3 perguntas diferentes
O aplicativo consegue ler a configuração? A conexão funciona? A origem e as permissões são adequadas aos seus dados? Um sim à primeira pergunta não responde às demais.
O MCP conecta um cliente a um servidor que oferece recursos. Pode ser um programa local via stdio ou um serviço via HTTP; o transporte muda o que precisa ser revisado.
Referências: Model Context Protocol — Clients, servers and transports
Confira o formato aceito pelo seu cliente
O ToolRoof verifica um subconjunto JSON sob mcpServers: command com args e env opcionais, ou url com headers opcionais. Ter command e url na mesma entrada é erro; campos desconhecidos geram avisos.
Esse não é o formato de todos os aplicativos MCP. Consulte a documentação do cliente antes de excluir opções válidas que o verificador não cobre. A ferramenta não executa comandos, visita endereços nem testa autenticação.
Aviso não é detecção completa de segredos
Argumentos, variáveis de ambiente e cabeçalhos podem conter dados sensíveis. Destacar esses locais não prova que cada valor seja secreto nem que um arquivo sem avisos esteja livre de segredos.
Não publique uma configuração real em um chamado público. Use um exemplo sem dados sensíveis e revise origem e permissões ao conectar. HTTPS e JSON válido não estabelecem confiança por si só.
Exemplo: resultado válido, significado limitado
{"mcpServers":{"notes":{"url":"https://example.com/mcp","type":"http"}}} descreve um servidor no subconjunto aceito. Passar confirma somente a estrutura; example.com é ilustrativo, não um servidor MCP testado.
Adicionar command à mesma entrada falha por transporte ambíguo. Já headers com {"X-Mode":"demo"} mantém a estrutura válida, mas gera um aviso para revisão. Isso não significa que demo seja uma credencial secreta.