Cómo solucionar el error en Claude Desktop acerca: Server disconnected. For troubleshooting guidance, please visit our debugging documentation

El error "Server disconnected" significa que Claude Desktop logró lanzar el proceso pero se cerró casi nmediatamente (crash al iniciar). Vamos a diagnosticarlo paso a paso.

Consideraciones para las rutas relativas: Donde [tu-unidad] puede ser C:, D: o E: si el servicio esta desde un localhost.

Paso 1: Revisa el log específico del servidor

Este es el diagnóstico más rápido — te dirá el error exacto de Python:

notepad "%APPDATA%\Claude\logs\mcp-server-MiServidorPython.log"

Busca las últimas líneas, casi siempre ahí está el traceback real (ej. ModuleNotFoundError, FileNotFoundError, etc).

Paso 2: Prueba el comando exacto que corre Claude Desktop

Abre una terminal nueva (no la de VS Code con el venv activado) y ejecuta literalmente lo que está en el JSON:

# powershell
python D:\Hadson.TECH\LEARNING\MCP-Learning\server-py.py

Causas más comunes de "disconnected":

Cuando fastmcp no está instalado en el Python que ve Claude Desktop. Las apps GUI de Windows no siempre usan el mismo python que tu terminal/.venv. Verifica cuál python se está ejecutando realmente:

# bash
where python

Solución

Si tienes varias instalaciones o un .venv, el python del PATH global puede no tener fastmcp instalado. Solución: usa la ruta absoluta al Python donde sí instalaste fastmcp (idealmente tu venv):

"MiServidorPython": {
    "command": "[tu-unidad]\\Hadson.TECH\\LEARNING\\MCP-Learning\\.venv\\Scripts\\python.exe",
    "args": ["[tu-unidad]\\Hadson.TECH\\LEARNING\\MCP-Learning\\server-py.py"]
}

Paso 3: Confirma con MCP Inspector

Si el paso 2 lanza el servidor sin errores (se queda "colgado" esperando, eso es correcto para stdio), prueba con Inspector para confirmar el handshake:

# bash
npx -y @modelcontextprotocol/inspector "[tu-unidad]\Hadson.TECH\LEARNING\MCP-Learning\.venv\Scripts\python.exe" [tu-unidad]\Hadson.TECH\LEARNING\MCP-Learning\server-py.py

Si Inspector conecta bien pero Claude Desktop sigue fallando, el problema es 100% de configuración (rutas o PATH), no del código.

Verifica antes de reiniciar Claude Desktop

Confirma que ese python.exe específico sí tiene fastmcp:

# powershell
D:\Hadson.TECH\LEARNING\MCP-Learning\venv\Scripts\python.exe -c "import fastmcp; print(fastmcp.__version__)"

Si imprime una versión sin error, ya está listo. Guarda el config, cierra Claude Desktop desde la bandeja del sistema y vuelve a abrirlo — debería conectar sin problema esta vez.

Paso 4: Reinicia completamente

Después de cualquier cambio al JSON: cierra Claude Desktop desde el ícono de la bandeja del sistema (no solo la ventana) y vuelve a abrirlo.