~/tools / MCP Config Checker
MCP Config Checker — Confira erros em um arquivo de config MCP
Confira um arquivo de configuração de servidores MCP (.mcp.json ou claude_desktop_config.json) em busca de erros: type ausente, chave de nível superior errada, nomes reservados ou inválidos, caminhos relativos, variáveis não definidas e segredos escritos no arquivo. Nada sai do seu navegador.
Regras conferidas com a documentação em 2026-10-23.
Documentação: Claude Code / Model Context Protocol / VS Code
Não verificado: se um comando existe, se um pacote é instalado, se um servidor remoto responde e configurações que outros aplicativos leem de outra forma.
Tudo roda no seu navegador. A configuração não é enviada.
Os servidores MCP são configurados em um arquivo JSON, e um pequeno erro pode fazer um servidor simplesmente não aparecer, sem nenhum aviso. Uma entrada de servidor com url mas sem type é ignorada, um arquivo que usa a chave servers do VS Code não é lido pelo Claude Code nem pelo Claude Desktop, e uma variável de ambiente que não está definida é repassada como texto simples. Esta ferramenta lê a configuração que você cola e lista o que a documentação diz que não vai funcionar, o que vale a pena conferir e o que é apenas uma observação. Ela também avisa quando um token parece estar escrito direto no arquivo, onde pode acabar no controle de versão. As regras vêm da documentação do Claude Code, do Model Context Protocol e do VS Code, conferida na data exibida abaixo da ferramenta.
Casos de uso
- Descobrir por que um servidor MCP não aparece depois que você edita o .mcp.json ou o claude_desktop_config.json
- Conferir uma configuração copiada de um README antes de adicioná-la a um projeto compartilhado
- Encontrar tokens e senhas escritos em um arquivo de configuração antes de fazer o commit
Como usar
- Cole o conteúdo do seu arquivo de configuração MCP ou carregue o exemplo.
- Leia os servidores encontrados e o tipo de cada um, depois a lista de achados. Corrigir significa que a documentação diz que a entrada não vai funcionar, Verificar significa que vale a pena dar uma olhada, e Nota é apenas informação.
- Edite o arquivo, cole-o de novo e reinicie o aplicativo que o lê.
FAQ
Quais arquivos e aplicativos ele cobre?
O formato mcpServers usado pelo arquivo de projeto .mcp.json no Claude Code e pelo claude_desktop_config.json no Claude Desktop. Outros aplicativos podem ler campos diferentes ou outra chave de nível superior, então consulte a documentação deles. O VS Code, por exemplo, usa uma chave de nível superior chamada servers.
Minha entrada tem url mas não tem type. Por que isso é um problema?
O Claude Code lê uma entrada sem type como um servidor stdio, então uma entrada que tem url mas não tem type é um erro de configuração e o servidor é ignorado. Adicione um type igual a http, sse ou ws.
O que acontece com uma variável como ${API_KEY} que não está definida?
O Claude Code expande ${VAR} e ${VAR:-default} em command, args, env, url e headers. Se uma variável não está definida e não tem valor padrão, a configuração ainda é carregada, o Claude Code mostra um aviso e usa o texto ${VAR} tal como está escrito. Adicione um valor padrão com ${VAR:-default} quando isso for seguro.
Por que ele avisa sobre um token no arquivo?
Um token escrito diretamente em um arquivo de configuração pode ser compartilhado quando o arquivo passa por commit ou é enviado a alguém. A verificação é uma heurística baseada em formatos de token conhecidos e em nomes como api-key, token e password, então ela pode deixar passar um segredo ou apontar um valor inofensivo. Usar ${VAR} mantém o valor fora do arquivo.
Ele inicia o servidor ou testa a conexão?
Não. Ele apenas lê o texto. Não consegue saber se um comando existe, se um pacote pode ser instalado ou se um servidor remoto está acessível, então teste o servidor no aplicativo depois que o arquivo passar na verificação.
Minha configuração é enviada para algum servidor?
Não. A verificação roda no seu navegador.