Claude Code: el servidor MCP no arranca o no conecta — causas y soluciones
¿Hay una caída ahora mismo?
El estado oficial de Claude Code es operativo. Si este error persiste, probablemente sea un problema de implementación o de tu entorno.
Ver el estado de Claude Code →Qué significa este error
Un servidor MCP (Model Context Protocol) configurado no pudo arrancar o conectarse (p. ej. "MCP server '…' failed to connect"). Suele ser un problema de configuración del lado del servidor MCP —comando, argumentos, runtime o variables de entorno— no de Claude Code en sí.
Causas comunes
- •Ruta de comando o argumentos incorrectos en .mcp.json / la configuración
- •Runtime requerido (node / python / uvx) no instalado o fuera del PATH
- •Faltan variables de entorno necesarias (claves de API, etc.)
- •El proceso del servidor MCP falla al arrancar o se bloquea
- •Tipo stdio / SSE o URL incorrectos
- •Permisos de ejecución insuficientes
Cómo solucionarlo
- 1.Revisa `claude mcp list` y el estado de conexión con `/mcp`
- 2.Revisa el comando, los argumentos y el env de tu configuración
- 3.Instala el runtime requerido y añádelo al PATH
- 4.Ejecuta el comando por separado para ver si arranca
- 5.Configura las variables de entorno necesarias (claves de API, etc.)
- 6.Revisa los logs para identificar el error del servidor
- 7.Corrige la configuración y reinicia Claude Code
Cuándo conviene esperar (y cuándo no)
Los problemas de MCP suelen ser de configuración/entorno: esperar no ayuda. Revisa la configuración y el runtime. Es independiente de las caídas de Anthropic, así que MCP puede fallar aunque el servicio principal esté bien.
Alternativas cuando Claude Code está caído
Errores relacionados
Preguntas frecuentes
¿Qué es MCP server failed?
Un servidor MCP (Model Context Protocol) configurado no pudo arrancar o conectarse (p. ej. "MCP server '…' failed to connect"). Suele ser un problema de configuración del lado del servidor MCP —comando, argumentos, runtime o variables de entorno— no de Claude Code en sí.
¿Cómo soluciono MCP server failed?
Revisa `claude mcp list` y el estado de conexión con `/mcp` / Revisa el comando, los argumentos y el env de tu configuración / Instala el runtime requerido y añádelo al PATH / Ejecuta el comando por separado para ver si arranca / Configura las variables de entorno necesarias (claves de API, etc.) / Revisa los logs para identificar el error del servidor / Corrige la configuración y reinicia Claude Code