Referencia de comandos · Claude Code
/mcp
Gestiona las conexiones de servidores MCP y la autenticación OAuth.
Sin argumento, abre una lista interactiva de todos los servidores MCP configurados con el estado de conexión y el número de herramientas de cada servidor. Desde ahí también se puede iniciar o renovar la autenticación OAuth de un servidor (Re-authenticate), por ejemplo cuando una llamada falla con 401 Unauthorized o 403 Forbidden y el servidor queda marcado como pendiente de autenticación.
Con argumentos, el comando controla servidores individuales de forma específica: /mcp reconnect <server> restablece la conexión con un servidor desconectado, /mcp enable/disable <server> (o all) activa o desactiva servidores sin borrar su configuración — un servidor desactivado sigue visible en la lista, pero marcado como deshabilitado. En servidores HTTP o SSE, Claude Code intenta primero restablecer automáticamente una conexión interrumpida (hasta cinco intentos con tiempo de espera creciente); solo después es necesaria la intervención manual mediante /mcp.
Desde la versión 2.1.205 también se puede usar de forma no interactiva (-p); sin argumento, el comando entonces devuelve un resumen de texto del estado de los servidores en lugar de la lista interactiva. Los servidores nuevos no se configuran aquí, sino mediante claude mcp add.
🔄 LA MISMA TAREA («GESTIONAR SERVIDORES MCP») EN OTRAS PLATAFORMAS
✅ ¿CUÁNDO USARLO?
Reparar el estado de conexión de un servidor MCP
Un servidor MCP deja de responder → ejecutar /mcp reconnect <server> para restablecer la conexión.
Desactivar servidores MCP individuales de forma selectiva
Usar /mcp disable <server> para desactivar temporalmente un servidor poco usado sin perder su configuración.
Renovar la autenticación OAuth de un servidor
Si /mcp muestra un servidor como pendiente de autenticación tras un error 401, seleccionar 'Re-authenticate' en el menú del servidor.
⛔ ¿CUÁNDO MEJOR NO?
Configurar un nuevo servidor MCP por primera vez
/mcp solo administra conexiones existentes (reconnect, enable, disable) y la autenticación OAuth; no crea una nueva configuración de servidor.
Mejor: Agregar primero el servidor con claude mcp add, antes de usar /mcp para su administración.
Evaluar el estado del servidor de forma automatizada en un script
De forma interactiva, /mcp abre un diálogo de selección que no es adecuado para comprobaciones automatizadas.
Mejor: Ejecutar /mcp de forma no interactiva con -p (desde v2.1.205) para obtener un resumen de texto, o usar claude mcp list para la lista de configuración.
FUENTES
- documentación de Claude Code (oficial) ↗ code.claude.com
MÁS COMANDOS · Claude Code