~/tools / MCP Config Checker
MCP Config Checker — Revisa errores en un archivo de configuración MCP
Revisa un archivo de configuración de servidores MCP (.mcp.json o claude_desktop_config.json) en busca de errores: un type que falta, la clave de nivel superior equivocada, nombres reservados o no válidos, rutas relativas, variables sin definir y secretos escritos en el archivo. Nada sale de tu navegador.
Reglas comprobadas con la documentación el 2026-10-23.
Documentación: Claude Code / Model Context Protocol / VS Code
No se comprueba: si un comando existe, si un paquete se instala, si un servidor remoto responde ni los ajustes que otras aplicaciones leen de forma distinta.
Todo se ejecuta en tu navegador. La configuración no se sube.
Los servidores MCP se configuran en un archivo JSON, y un error pequeño puede hacer que un servidor no aparezca sin avisar. Una entrada de servidor con url pero sin type se omite, un archivo que usa la clave servers de VS Code no lo leen ni Claude Code ni Claude Desktop, y una variable de entorno que no está definida se pasa como texto sin más. Esta herramienta lee la configuración que pegues y enumera lo que, según la documentación, no funcionará, lo que conviene revisar y lo que es solo una nota. También avisa cuando parece que un token está escrito directamente en el archivo, donde puede acabar en el control de versiones. Las reglas proceden de la documentación de Claude Code, del Model Context Protocol y de VS Code, comprobadas en la fecha que aparece debajo de la herramienta.
Casos de uso
- Averiguar por qué un servidor MCP no aparece después de editar .mcp.json o claude_desktop_config.json
- Revisar una configuración copiada de un README antes de añadirla a un proyecto compartido
- Detectar tokens y contraseñas escritos en un archivo de configuración antes de hacer commit
Cómo usarlo
- Pega el contenido de tu archivo de configuración MCP o carga el ejemplo.
- Lee los servidores encontrados y de qué tipo es cada uno, y después la lista de hallazgos. Corregir significa que la documentación dice que la entrada no funcionará, Revisar que conviene echarle un vistazo y Nota que es solo información.
- Edita el archivo, pégalo de nuevo y reinicia la aplicación que lo lee.
FAQ
¿Qué archivos y aplicaciones cubre?
El formato mcpServers que usan el archivo de proyecto .mcp.json en Claude Code y claude_desktop_config.json en Claude Desktop. Otras aplicaciones pueden leer campos distintos o una clave de nivel superior diferente, así que consulta su propia documentación. VS Code, por ejemplo, usa una clave de nivel superior llamada servers.
Mi entrada tiene url pero no type. ¿Por qué es un problema?
Claude Code interpreta una entrada sin type como un servidor stdio, así que una entrada que tiene url pero no type es un error de configuración y el servidor se omite. Añade un type con el valor http, sse o ws.
¿Qué ocurre con una variable como ${API_KEY} que no está definida?
Claude Code expande ${VAR} y ${VAR:-default} en command, args, env, url y headers. Si una variable no está definida y no tiene valor por defecto, la configuración se carga igualmente, Claude Code muestra una advertencia y usa el texto ${VAR} tal como está escrito. Añade un valor por defecto con ${VAR:-default} cuando sea seguro hacerlo.
¿Por qué avisa de un token en el archivo?
Un token escrito directamente en un archivo de configuración puede compartirse cuando el archivo se sube al repositorio o se envía a otra persona. La comprobación es una heurística basada en formatos de token conocidos y en nombres como api-key, token y password, por lo que puede pasar por alto un secreto o señalar un valor inofensivo. Usar ${VAR} mantiene el valor fuera del archivo.
¿Inicia el servidor o prueba la conexión?
No. Solo lee el texto. No puede saber si un comando existe, si un paquete se puede instalar ni si un servidor remoto está accesible, así que prueba el servidor en la aplicación cuando el archivo pase la revisión.
¿Se envía mi configuración a algún servidor?
No. La comprobación se ejecuta en tu navegador.