Tool overview
O que é Validador de Servidor MCP?
Validador de Servidor MCP é uma ferramenta que ajuda você a validar configurações JSON de clientes mcpServers.
Por que usar Validador de Servidor MCP?
Melhora a legibilidade e acelera seu fluxo quando você precisa validar configurações JSON de clientes mcpServers, sem enviar dados a um servidor.
Recursos principais
Privacidade no cliente, resultados instantâneos e cópia com um clique para validador de Servidor MCP. Validar configurações JSON de clientes mcpServers
Como usar
Siga estes passos para obter resultados precisos com a ferramenta acima.
- Cole sua configuração JSON do Cursor ou Claude Desktop com um objeto de nível superior "mcpServers".
- Revise o relatório de lint: erros (bloqueantes) e avisos (não bloqueantes) com caminhos JSON pointer.
- Corrija o transporte: stdio precisa de command (+ args); remoto precisa de url http/https válida.
- Garanta que env contenha só strings e que args seja um array de strings.
- Remova entradas dual command+url e chaves desconhecidas marcadas como aviso quando possível.
- Revalide até ok ser true — avisos sozinhos não falham, mas trate-os como dívida.
- Cole o JSON corrigido de volta no arquivo do cliente e recarregue os servidores MCP.
- Copie o relatório para um PR ou checklist de CI; mantenha segredos como placeholders.
Validador MCP — guia completo e casos de uso
Guia autoritativo: erros vs avisos, stdio vs HTTP, casos Cursor e Claude Desktop, regras env string, correções e higiene de segredos.
Guia do MCP Validator — comece aqui
Este guia explica como validar localmente uma configuração JSON mcpServers. Cole conteúdo sem segredos e corrija os problemas antes de usar Cursor ou Claude Desktop.
O que o MCP Validator faz
MCP Validator analisa no navegador as entradas mcpServers, seus transportes e tipos JSON para encontrar configurações que os clientes não conseguem iniciar.
Relatório local com caminhos JSON e problemas acionáveis
- Relatório local com caminhos JSON e problemas acionáveis
- Relatório local com caminhos JSON e problemas acionáveis: mcpServers, command, args, url, env
- Relatório local com caminhos JSON e problemas acionáveis: stdio, http, https
- Relatório local com caminhos JSON e problemas acionáveis: JSON, ok
Use antes de colar ou compartilhar uma configuração MCP
- Use antes de colar ou compartilhar uma configuração MCP
- Use antes de colar ou compartilhar uma configuração MCP: Cursor mcp.json
- Use antes de colar ou compartilhar uma configuração MCP: Claude Desktop
- Use antes de colar ou compartilhar uma configuração MCP: CI / PR
Use uma ferramenta relacionada para criar schemas ou prompts
- Use uma ferramenta relacionada para criar schemas ou prompts
- Use uma ferramenta relacionada para criar schemas ou prompts: AI Agent Builder
- Use uma ferramenta relacionada para criar schemas ou prompts: JSON Schema
Erros e avisos — o que bloqueia a colagem
Erro: a configuração bloqueia a validação
Guia de severidade
| Guia de severidade | Efeito em ok | Causas comuns |
|---|---|---|
| Erro: a configuração bloqueia a validação | Efeito em ok: ok = false | Causas comuns |
| Aviso: revise este detalhe antes da produção | Efeito em ok: ok | Causas comuns |
Aviso: revise este detalhe antes da produção
Passo a passo: colar, analisar, corrigir, colar de volta
Como esta ferramenta ajuda
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
- Escolha apenas um transporte por servidor.
- Use http:// ou https:// para servidores remotos.
- Converta valores env em strings.
- Valide novamente até ok ser true.
- Cole o JSON corrigido no cliente.
Caso de uso: corrigir Cursor mcp.json antes de recarregar
Erro: a configuração bloqueia a validação Cursor mcp.json.
Como esta ferramenta ajuda
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
- Escolha apenas um transporte por servidor.
Resultado: uma configuração MCP clara, validada e pronta para uso.
Caso de uso: URL MCP remota do Claude Desktop
Erro: a configuração bloqueia a validação Claude Desktop.
Como esta ferramenta ajuda
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
- Escolha apenas um transporte por servidor.
Resultado: uma configuração MCP clara, validada e pronta para uso.
Caso de uso: analisar templates MCP na revisão de PR
Erro: a configuração bloqueia a validação CI / PR.
Como esta ferramenta ajuda
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
- Escolha apenas um transporte por servidor.
Resultado: uma configuração MCP clara, validada e pronta para uso.
Caso de uso: higiene de segredos durante a depuração
Erro: a configuração bloqueia a validação env.
Como esta ferramenta ajuda
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
- Escolha apenas um transporte por servidor.
Resultado: uma configuração MCP clara, validada e pronta para uso.
Regras de transporte stdio versus HTTP/HTTPS
Formatos de transporte
Formatos de transporte
| Formatos de transporte | Campos obrigatórios | Observações |
|---|---|---|
| stdio | command; args | Observações |
| HTTP / HTTPS | url (http:// or https://) | Observações |
Observações: env, headers, disabled.
Valores env devem ser strings
env: Campos obrigatórios
- env: Campos obrigatórios
- Campos obrigatórios
- JSON
- mcpServers
Correção: command ou url ausente
Erro: a configuração bloqueia a validação: command or url.
Por que acontece
Por que acontece
Diagnóstico
Diagnóstico
Correções
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
Correção: valores env que não são strings
Erro: a configuração bloqueia a validação: env.
Por que acontece
Por que acontece
Diagnóstico
Diagnóstico
Correções
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
Aviso: revise este detalhe antes da produção
Correção: envelope raiz incorreto
Erro: a configuração bloqueia a validação: mcpServers.
Por que acontece
Por que acontece
Diagnóstico
Diagnóstico
Correções
- Cole o JSON com mcpServers.
- Corrija primeiro os erros.
- Verifique command, args, url e env.
Boas práticas de validação MCP
- Valide antes de colar no Cursor ou Claude Desktop.
- Use command ou url, nunca ambos.
- Mantenha args como array de strings.
- Mantenha env como strings.
- Use placeholders para segredos.
- Use caminhos absolutos de menor privilégio.
- Valide novamente após cada alteração.
- Resolva avisos antes da produção.
Perguntas frequentes
Respostas para problemas comuns e questões de privacidade de dados.
Ferramentas relacionadas
Explore outros utilitários relacionados que complementam esta ferramenta.
Documentação oficial e referências
Especificações e documentação da plataforma para esta utilidade.