Cole a sua configuração e veja o que VS Code realmente vai fazer com ela. A maioria das configurações MCP quebradas é JSON válido, e é justamente por isso que nada avisa que estão erradas.
Acertar a configuração é a metade chata. O MCP Showcase pega o mesmo servidor e produz um playground ao vivo que seus clientes podem experimentar, com documentação para cada ferramenta.
Nada é enviado. A verificação roda inteiramente no seu navegador.
Chave raiz, chave do endpoint, tipo de transporte e os campos específicos que VS Code trata de forma diferente de todos os outros.
Cada problema vem com o que VS Code espera no lugar, então é uma mudança que você pode fazer, e não um sintoma para procurar.
Quase toda configuração MCP quebrada é JSON válido. Os clientes ignoram chaves que não reconhecem, então um arquivo com a chave raiz errada ou o campo de endpoint errado é analisado sem problemas, o VS Code inicia normalmente e nenhum servidor aparece. Não há erro para procurar. Esse silêncio é o motivo de esses enganos durarem tanto.
servers.
Qualquer outra coisa é analisada e ignorada.url.
Esta é a que pega quase todo mundo: o VS Code usa "servers", enquanto Claude, Cursor e Windsurf usam todos "mcpServers". Uma configuração copiada de qualquer um deles é JSON válido e não faz absolutamente nada. O VS Code também suporta um array "inputs" para que um token seja solicitado e guardado no chaveiro do sistema em vez de ir para o repositório.
A verificação roda inteiramente no seu navegador e não faz nenhuma requisição de rede. Isso é deliberado e não acidental: configurações MCP contêm tokens de API rotineiramente, e «cole a sua configuração neste site» é um pedido razoável de se recusar. Você pode confirmar na aba de rede do seu navegador.
Então o problema saiu do arquivo. Um cliente que mostra o servidor mas nenhuma ferramenta está conectando e falhando no handshake ou no transporte, não lendo a sua configuração errado. O MCP Inspector mostra em qual transporte o servidor responde e o log bruto de requisições, e o MCP Server Tester reduz a mesma coisa a uma lista de aprovado/reprovado.
Uma configuração que funciona é o mínimo. O que ela não faz é ajudar alguém a entender para que o seu servidor serve — e se você publica um servidor MCP, é isso que decide se alguém chega a configurá-lo. O MCP Showcase transforma o mesmo endpoint em um playground ao vivo com documentação por ferramenta, para que avaliá-lo custe um clique em vez de um arquivo de configuração e um reinício.