Cole a URL do seu servidor MCP e receba uma configuração que Gemini CLI vai realmente ler: o arquivo certo, a chave raiz certa, o transporte certo. Nada é enviado.
Um arquivo de configuração conecta o seu servidor. Ele não mostra a um cliente para que serve. O MCP Showcase transforma a mesma URL em um playground ao vivo com documentação para cada ferramenta.
Tudo acontece no seu navegador. A sua URL e qualquer token ficam na sua máquina.
O arquivo certo, a chave raiz certa e a forma certa de expressar um endpoint remoto, que varia entre clientes mais do que se imagina.
Cole o resultado no seu arquivo de configuração, reinicie Gemini CLI e o servidor aparece na lista de ferramentas.
~/.gemini/settings.json (global) or .gemini/settings.json (per project)
Acertar o local importa tanto quanto o conteúdo. Uma configuração correta no arquivo errado não faz absolutamente nada, e nenhum cliente relata erro por um arquivo que nunca abriu — por isso o sintoma habitual é «simplesmente não aparece» e não uma mensagem que você possa pesquisar.
mcpServers.httpUrl, com conexão direta.
O Gemini CLI distingue os dois: "httpUrl" é Streamable HTTP e "url" é HTTP+SSE. Usar "url" para um servidor Streamable HTTP é uma divergência de transporte, e ela aparece como uma conexão que abre e depois não leva a lugar nenhum, em vez de um erro claro.
Porque os dez clientes que as pessoas realmente usam discordam nos quatro pontos acima, e cada
discordância falha em silêncio. A chave raiz é mcpServers na maioria, mas
servers no VS Code e context_servers no Zed. O endpoint remoto é
url na maioria, serverUrl no Windsurf e httpUrl no Gemini
CLI. Dois clientes não usam JSON de jeito nenhum. Uma configuração copiada entre dois deles
normalmente será analisada e não vai conectar com nada.
Reinicie o Gemini CLI — a maioria dos clientes lê a configuração MCP apenas na inicialização. Se o servidor aparecer mas não listar ferramentas, o problema saiu do arquivo de configuração e foi para o servidor, e o MCP Inspector vai mostrar se ele completa um handshake e em qual transporte responde.
Tudo nesta página existe para fazer uma máquina conversar com um servidor. Não faz nada pela pessoa que decide se vale a pena conectar o seu servidor: ela também não consegue ler um arquivo de configuração. O MCP Showcase transforma a mesma URL em um playground ao vivo com documentação gerada para cada ferramenta, para que avaliar o seu servidor custe um clique em vez de um arquivo de configuração e um reinício.