Lo que te llevarás: una rutina calmada de 4 comprobaciones para el momento
en que un MCP se pone rojo o «failed to connect» — para que el punto exacto donde los usuarios casuales
abandonan se convierta en un fix de 60 segundos para ti.
Instalas un MCP, ejecutas /mcp, y en vez de verde sale rojo / failed. El casual
asume que rompió algo y se rinde. El builder serio sabe: el rojo casi siempre significa una de cuatro
cosas aburridas y arreglables.
Primero: lee lo que te está diciendo
Ejecuta /mcp — lista cada servidor y su estado. Uno en rojo suele mostrar una línea de
error. No la pases por alto; esa línea es la respuesta el 80% de las veces. Si no la entiendes,
pégasela a Claude: «¿qué me dice este error de MCP y cómo lo arreglo?».
Las 4 comprobaciones (en orden — para cuando se ponga verde)
- API key ausente o incorrecta. La causa nº 1. La mayoría de MCP necesitan una key o token en la config. ¿La pegaste entera, sin espacios ni comillas de más, en el campo correcto? Vuélvela a pegar con cuidado.
- El servidor no está instalado de verdad. Algunos MCP necesitan su paquete presente antes de correr. El error suele decir «command not found» — instala el servidor según sus docs y reintenta.
- No reiniciaste tras editar la config. La config del MCP se lee al arrancar. Si añadiste o cambiaste un servidor, cierra del todo y reabre Claude Code — esto solo ya arregla una gran parte de los «rojos».
- Un typo en la config. Un carácter mal en el comando o la ruta, o una coma que falta, rompe la entrada entera. Haz que Claude revise el formato de tu archivo de config MCP.
🤝 El meta-movimiento: no tienes que diagnosticar solo. Pega el error rojo en
Claude y di: «Mi MCP [nombre] sale rojo con este error — guíame para arreglarlo paso a paso». Puede leer
tu config, detectar el problema y arreglarlo contigo.
El rojo no es «lo rompiste». El rojo es una checklist: lee el error → key →
instalado → reinicia → typo. Recórrela de arriba abajo y se pone verde. Este es el momento exacto en
que casi todos abandonan — no lo hagas. Es un fix de 60 segundos.
✅ Hecho cuando: puedes leer el estado de un MCP en /mcp, y has
trabajado la rutina de 4 comprobaciones (key → instalado → reinicia → typo) sobre un servidor rojo hasta
que conecta.
📋 Prompt (traducido)
Depurar un MCP en rojo
Mi MCP [nombre] sale rojo / failed en /mcp. Este es el error: [pega el
error]. Guíame para arreglarlo UN paso a la vez — comprueba primero la API key, luego si el servidor
está instalado, luego si necesito reiniciar, luego mi config por typos. Lee mi archivo de config MCP y
dime exactamente qué cambiar.
Fuente: Claude Code Club · Aula · Etapa 5 «Skills & MCPs» — lección «Cuando un MCP se pone en rojo (el fix del "ha fallado")».
Nota: lección de texto, sin infografía. · Añadido al cuaderno: 7 de julio de 2026. Traducción al español para estudio personal.