Cole a sua configuração e veja o que Zed 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 Zed trata de forma diferente de todos os outros.
Cada problema vem com o que Zed 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 Zed inicia normalmente e nenhum servidor aparece. Não há erro para procurar. Esse silêncio é o motivo de esses enganos durarem tanto.
context_servers.
Qualquer outra coisa é analisada e ignorada.url.
A chave raiz do Zed é "context_servers", não "mcpServers", e esse nome atravessa a interface e a documentação. Nada copiado da configuração de outro cliente será lido. O Zed também fixou esse nome antes de o ecossistema se padronizar, então guias antigos podem não bater com o que a sua versão espera.
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.