Conversor de configuração MCP para Windsurf

O que realmente muda ao trocar de cliente

O MCP padroniza o protocolo, não a configuração. Mover um servidor entre dois clientes significa mudar até quatro coisas, e cada uma delas falha em silêncio se você deixar passar: o arquivo é analisado, o cliente inicia, e o servidor simplesmente não está lá.

• O arquivo e o formato dele — o Windsurf lê ~/.codeium/windsurf/mcp_config.json, em JSON.
• A chave raiz — mcpServers aqui, mas mcpServers, servers, context_servers ou mcp_servers dependendo de onde você vem.
• O campo de endpoint — serverUrl para o Windsurf.
• Se um servidor remoto é alcançável sequer — veja abaixo.

Servidores remotos usam serverUrl, não url

O Windsurf lê "serverUrl" para um endpoint hospedado. Uma configuração que diz "url", que é o que todo outro cliente em JSON usa, é aceita sem reclamar e o servidor nunca conecta. Uma diferença de uma palavra que não produz nenhuma mensagem de erro.

O que é levado sem mudanças

Servidores stdio locais são em boa parte portáveis: o comando e os argumentos significam a mesma coisa em todo lugar. O que muda é o invólucro — a chave raiz e, em clientes de JSON, toda a sintaxe do arquivo. Cabeçalhos e variáveis de ambiente vão como estão, então se a sua configuração contém um token, ele estará na saída. Tudo acontece no seu navegador e nada é enviado, mas remova antes se preferir.

Ferramentas relacionadas

• Validar o resultado — vale a pena depois de qualquer conversão.
• Gerar uma configuração do Windsurf do zero
• Conversores para todos os outros clientes
• MCP Inspector — confirmar que o servidor funciona antes de culpar a configuração.

Dez configurações, um servidor, e ainda nada para mostrar

Portar uma configuração entre clientes é trabalho que só beneficia quem já usa o seu servidor. Não faz nada pela pessoa que decide se vai experimentá-lo. O MCP Showcase dá a essa pessoa um playground ao vivo na mesma URL: cada ferramenta documentada e executável no navegador, sem arquivo para editar e nada para reiniciar.