Veja qual revisão do protocolo o seu servidor realmente negocia, e se um cliente que espera 2024-11-05 vai funcionar com ele.
Com o transporte resolvido, resta o problema de ninguém ver o que o seu servidor faz. O MCP Showcase transforma a mesma URL em um playground ao vivo com documentação para cada ferramenta.
Qualquer endpoint MCP publicado.
A troca initialize informa a revisão em que o seu servidor para, que nem sempre é aquela contra a qual você desenvolveu.
Junto com o transporte, as capacidades e a lista completa de ferramentas.
As revisões do MCP são datadas em vez de numeradas, e cliente e servidor negociam uma comum durante o handshake initialize. Isso significa que a revisão que importa não é a do seu arquivo de dependências: é aquela em que as duas pontas concordam em tempo de execução, que é a que esta verificação informa.
Servidores construídos com um SDK mais novo do que aquele com que foram testados, ou presos a um antigo por uma dependência transitiva, negociam rotineiramente algo diferente do que o autor espera.
Raramente o núcleo: ferramentas, resources e prompts têm sido estáveis o tempo todo. As diferenças que doem estão na negociação de capacidades, na autorização e, acima de tudo, nos transportes. A virada para Streamable HTTP acompanhou as revisões mais novas, e uma divergência de transporte causa muito mais falhas reais do que uma divergência de revisão. Se um cliente não vê o seu servidor, verifique o transporte antes da revisão.
A que o seu SDK suporta, mantida razoavelmente em dia. Correr atrás de revisões à frente do seu SDK não traz nada. Ficar várias atrás é como um servidor deixa de funcionar aos poucos com os clientes novos; e como a negociação degrada em silêncio em vez de falhar com estardalhaço, isso costuma aparecer como «algumas pessoas dizem que não funciona» e não como uma queda.
Depois que um cliente consegue alcançar o seu servidor, resta o problema de ninguém conseguir dizer o que ele faz. Uma lista de ferramentas não é uma demonstração, e um prospect não vai instalar um cliente para descobrir. O MCP Showcase aponta para a mesma URL e produz um playground ao vivo com documentação gerada para cada ferramenta, para que avaliar o seu servidor custe um clique.