Tool overview
¿Qué es Validador de Servidor MCP?
Validador de Servidor MCP es una herramienta que le permite validar configuraciones JSON de clientes mcpServers.
¿Por qué usar Validador de Servidor MCP?
Mejora la legibilidad y agiliza su flujo cuando necesita validar configuraciones JSON de clientes mcpServers, sin enviar datos a un servidor.
Funciones clave
Privacidad en el cliente, resultados instantáneos y copia con un clic para validador de Servidor MCP. Validar configuraciones JSON de clientes mcpServers
Cómo usar
Siga estos pasos para obtener resultados precisos con la herramienta de arriba.
- Pegue su configuración JSON de Cursor o Claude Desktop con un objeto de nivel superior "mcpServers".
- Revise el informe de lint: errores (bloqueantes) y advertencias (no bloqueantes) con rutas JSON pointer.
- Corrija el transporte: stdio necesita command (+ args); remoto necesita url http/https válida.
- Asegúrese de que env solo tenga strings y que args sea un array de strings.
- Elimine entradas duales command+url y claves desconocidas marcadas como advertencias cuando pueda.
- Revalide hasta que ok sea true — las advertencias solas no fallan, pero trátelas como deuda.
- Pegue el JSON corregido en el archivo de config del cliente y recargue los servidores MCP.
- Copie el informe a un PR o checklist de CI; mantenga los secretos como placeholders.
Validador MCP — guía completa y casos de uso
Guía autoritativa: errores frente a advertencias, stdio frente a HTTP, casos Cursor y Claude Desktop, reglas env string, guías de corrección e higiene de secretos.
Guía de MCP Validator — empiece aquí
Esta guía explica cómo validar localmente la configuración JSON de mcpServers. Pegue contenido sin secretos y corrija los problemas antes de usar Cursor o Claude Desktop.
Qué hace MCP Validator
MCP Validator analiza en el navegador las entradas mcpServers, sus transportes y tipos JSON para detectar configuraciones que los clientes no pueden iniciar.
Informe local con rutas JSON y problemas accionables
- Informe local con rutas JSON y problemas accionables
- Informe local con rutas JSON y problemas accionables: mcpServers, command, args, url, env
- Informe local con rutas JSON y problemas accionables: stdio, http, https
- Informe local con rutas JSON y problemas accionables: JSON, ok
Úselo antes de pegar o compartir una configuración MCP
- Úselo antes de pegar o compartir una configuración MCP
- Úselo antes de pegar o compartir una configuración MCP: Cursor mcp.json
- Úselo antes de pegar o compartir una configuración MCP: Claude Desktop
- Úselo antes de pegar o compartir una configuración MCP: CI / PR
Use una herramienta relacionada cuando necesite crear schemas o prompts
- Use una herramienta relacionada cuando necesite crear schemas o prompts
- Use una herramienta relacionada cuando necesite crear schemas o prompts: AI Agent Builder
- Use una herramienta relacionada cuando necesite crear schemas o prompts: JSON Schema
Errores y advertencias — qué bloquea el pegado
Error: la configuración bloquea la validación
Guía de severidad
| Guía de severidad | Efecto en ok | Causas habituales |
|---|---|---|
| Error: la configuración bloquea la validación | Efecto en ok: ok = false | Causas habituales |
| Advertencia: revise este detalle antes de producción | Efecto en ok: ok | Causas habituales |
Advertencia: revise este detalle antes de producción
Paso a paso: pegar, analizar, corregir y volver a pegar
Cómo ayuda esta herramienta
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
- Elija un solo transporte por servidor.
- Use http:// o https:// para servidores remotos.
- Convierta los valores env en cadenas.
- Vuelva a validar hasta que ok sea true.
- Pegue el JSON corregido en el cliente.
Caso de uso: corregir Cursor mcp.json antes de recargar
Error: la configuración bloquea la validación Cursor mcp.json.
Cómo ayuda esta herramienta
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
- Elija un solo transporte por servidor.
Resultado: una configuración MCP clara, validada y lista para usar.
Caso de uso: URL MCP remota de Claude Desktop
Error: la configuración bloquea la validación Claude Desktop.
Cómo ayuda esta herramienta
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
- Elija un solo transporte por servidor.
Resultado: una configuración MCP clara, validada y lista para usar.
Caso de uso: analizar plantillas MCP en la revisión de PR
Error: la configuración bloquea la validación CI / PR.
Cómo ayuda esta herramienta
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
- Elija un solo transporte por servidor.
Resultado: una configuración MCP clara, validada y lista para usar.
Caso de uso: higiene de secretos durante la depuración
Error: la configuración bloquea la validación env.
Cómo ayuda esta herramienta
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
- Elija un solo transporte por servidor.
Resultado: una configuración MCP clara, validada y lista para usar.
Reglas de transporte stdio frente a HTTP/HTTPS
Formas de transporte
Formas de transporte
| Formas de transporte | Campos obligatorios | Notas |
|---|---|---|
| stdio | command; args | Notas |
| HTTP / HTTPS | url (http:// or https://) | Notas |
Notas: env, headers, disabled.
Los valores env deben ser cadenas
env: Campos obligatorios
- env: Campos obligatorios
- Campos obligatorios
- JSON
- mcpServers
Corrección: falta command o url
Error: la configuración bloquea la validación: command or url.
Por qué ocurre
Por qué ocurre
Diagnóstico
Diagnóstico
Correcciones
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
Corrección: valores env que no son cadenas
Error: la configuración bloquea la validación: env.
Por qué ocurre
Por qué ocurre
Diagnóstico
Diagnóstico
Correcciones
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
Advertencia: revise este detalle antes de producción
Corrección: envelope raíz incorrecto
Error: la configuración bloquea la validación: mcpServers.
Por qué ocurre
Por qué ocurre
Diagnóstico
Diagnóstico
Correcciones
- Pegue el JSON con mcpServers.
- Corrija primero los errores.
- Compruebe command, args, url y env.
Buenas prácticas de validación MCP
- Valide antes de pegar en Cursor o Claude Desktop.
- Use command o url, nunca ambos.
- Mantenga args como una matriz de cadenas.
- Mantenga env como cadenas.
- Use marcadores de posición para secretos.
- Use rutas absolutas con privilegios mínimos.
- Vuelva a validar después de cada cambio.
- Revise las advertencias antes de producción.
Preguntas frecuentes
Respuestas sobre depuración habitual y privacidad de sus datos.
Herramientas relacionadas
Explore otras utilidades relacionadas que complementan esta herramienta.
Documentación oficial y referencias
Especificaciones y documentación de plataforma para esta utilidad.