A maioria das configurações MCP quebradas é JSON válido, e é justamente por isso que nada avisa que estão erradas. Escolha o seu cliente e descubra o que ele realmente vai fazer com o seu arquivo.
Consertar uma 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.
As verificações mudam conforme o cliente, porque o que conta como errado também muda conforme o cliente.
Analisada no seu navegador. Nada é enviado, o que importa quando configurações carregam tokens.
Cada problema vem com o que aquele cliente espera no lugar.
O MCP padroniza o protocolo, não a configuração. Estes dez clientes leem arquivos diferentes, em três formatos diferentes, com nomes de chave diferentes para a mesma coisa. A tabela abaixo reúne o problema inteiro em um só lugar — e explica por que uma configuração copiada de um cliente para outro normalmente é analisada sem erro e não conecta com nada.
| Cliente | Formato | Chave raiz | Endpoint remoto |
|---|---|---|---|
| Claude Desktop | JSON | mcpServers |
via ponte local |
| Claude Code | JSON | mcpServers |
url |
| Cursor | JSON | mcpServers |
url |
| VS Code | JSON | servers |
url |
| Windsurf | JSON | mcpServers |
serverUrl |
| Codex CLI | TOML | mcp_servers |
url |
| Gemini CLI | JSON | mcpServers |
httpUrl |
| Cline | JSON | mcpServers |
url |
| Zed | JSON | context_servers |
url |
| Continue | YAML | mcpServers |
url |
mcpServers. O VS Code lê
servers, o Zed lê context_servers, o Codex CLI lê
mcp_servers. Chave errada, arquivo válido, nenhum servidor, nenhum erro.url na maioria, serverUrl no
Windsurf, httpUrl no Gemini CLI quando o transporte é Streamable HTTP.mcp-remote, que
é um formato de configuração completamente diferente.Tudo aqui serve a quem já decidiu usar o seu servidor. O MCP Showcase é para quem ainda não decidiu: aponte-o para a mesma URL e ele produz um playground ao vivo com documentação para cada ferramenta, para que avaliar o seu servidor custe um clique em vez de um arquivo de configuração e um reinício.