Ferramenta gratuita

Validador de configuração MCP para Windsurf

Cole a sua configuração e veja o que Windsurf 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.

Cole a configuração JSON. Remova o token antes, se preferir: as verificações não precisam dele.
Roda inteiramente no seu navegador. Nada do que você colar é enviado, armazenado ou registrado.

Enfim conectado. Agora mostre a alguém o que ele faz.

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.

Comece Gratuitamente Explore o diretório de servidores MCP

Como funciona

link
Cole a sua configuração

Nada é enviado. A verificação roda inteiramente no seu navegador.

play_circle
Nós a lemos como Windsurf leria

Chave raiz, chave do endpoint, tipo de transporte e os campos específicos que Windsurf trata de forma diferente de todos os outros.

checklist
Corrija o que for encontrado

Cada problema vem com o que Windsurf espera no lugar, então é uma mudança que você pode fazer, e não um sintoma para procurar.

Por que uma configuração válida mesmo assim não faz nada

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 Windsurf inicia normalmente e nenhum servidor aparece. Não há erro para procurar. Esse silêncio é o motivo de esses enganos durarem tanto.

O que é verificado para o Windsurf

  • Chave raiz — o Windsurf lê mcpServers. Qualquer outra coisa é analisada e ignorada.
  • Campo de endpoint — servidores remotos precisam usar serverUrl.
  • Forma das entradas — cada servidor precisa de um comando para iniciar ou de um endpoint ao qual se conectar.
  • HTTP sem criptografia — sinalizado, porque qualquer token bearer enviado a esse servidor trafega em claro.
  • Campos próprios do Windsurf — 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.

Sua configuração não é enviada

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.

Se a configuração está certa mas o servidor está vazio

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.

Ferramentas relacionadas

Quando conecta, começa a parte difícil

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.

Perguntas frequentes

Porque os clientes ignoram o que não reconhecem. Uma configuração com a chave raiz errada, ou com um endpoint remoto sob o nome de campo errado, é analisada perfeitamente e resulta num cliente que não vê servidor nenhum e não relata nada. O silêncio é o modo de falha normal aqui.

Que a chave raiz seja a que Windsurf lê; que servidores remotos usem o nome de campo que Windsurf espera; que cada entrada tenha um comando ou um endpoint; que nada seja servido por HTTP sem criptografia; e as peculiaridades que valem especificamente para Windsurf.

Não. Ela é analisada no seu navegador e nunca sai da sua máquina, o que importa porque configurações MCP frequentemente contêm tokens de API. Nenhuma requisição de rede é feita.

Depende inteiramente do cliente, e é por isso que tanta gente cai nessa. Claude, Cursor, Windsurf e Cline usam mcpServers; VS Code usa servers; Zed usa context_servers; Codex CLI usa mcp_servers em TOML. O resultado abaixo nomeia a que Windsurf precisa.

Então o problema é do servidor e não do arquivo. Passe o endpoint pelo MCP Inspector para confirmar que ele completa um handshake e ver o que expõe.

Mais ferramentas MCP gratuitas

MCP Inspector online

Cole a URL de um servidor MCP e veja todas as ferramentas, recursos e prompts expostos, com esquemas completos e o log de requisições. Nada para instalar.
Testador de servidor MCP

Confirme que o seu servidor MCP funciona de verdade. Cole a URL e receba um relatório de aprovado/reprovado sobre a conexão, o handshake, o transporte e as ferramentas anunciadas.
Scanner de segurança MCP

Antes de apontar um agente para um servidor MCP, veja o que ele está pedindo. Nota de A a F em transporte, autenticação, indícios de tool poisoning e parâmetros perigosos.
Calculadora de tokens MCP

Definições de ferramentas são enviadas em toda requisição, não uma única vez. Cole a URL do seu servidor MCP e veja quantos tokens são, quais ferramentas pesam mais e quanto custa.
Ver todas as ferramentas gratuitas