Desktop Commander (MCP)

claude mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander

claude mcp list

Desktop Commander le da al agente control real de tu ordenador: ejecutar comandos en la terminal, leer y escribir archivos, mover cosas y manejar procesos del sistema. Es uno de los MCP más potentes para trabajo local y, justamente por eso, uno de los que más cuidado piden. Con esto el agente puede operar tu máquina casi como lo harías tú desde una consola.

La diferencia con el MCP de filesystem es de grado y de naturaleza. Filesystem se limita a operaciones sobre archivos dentro de las carpetas que tú listas; Desktop Commander añade ejecutar comandos arbitrarios, lo que abre la puerta a instalar dependencias, correr scripts, lanzar tests, comprimir archivos, mover servicios y, en general, hacer todo lo que harías tú en un terminal. Para usuarios técnicos es una herramienta brutalmente útil; para usuarios poco familiarizados con la línea de comandos, es mejor empezar por filesystem.

La filosofía del servidor es la misma que la del resto del ecosistema MCP: el agente propone y tú apruebas. Ninguna acción se ejecuta sin tu permiso explícito. Pero en este caso el contenido de lo que apruebas importa más que en otros, porque la consecuencia de un comando mal entendido puede ser real.

Qué te abre

La función más vistosa es ejecutar comandos. El agente puede proponer un git pull, un npm install, un pytest, un docker compose up o cualquier otro comando que tú podrías teclear, y, con tu permiso, ejecutarlo. Cuando trabajas en proyectos donde te pasas el día encadenando comandos repetitivos, esto cambia mucho la dinámica: describes lo que quieres y el agente arma la secuencia.

La gestión de archivos llega más lejos que en filesystem. Puede copiar entre carpetas, comprimir y descomprimir, sincronizar, generar tarjetas de archivos a partir de plantillas, renombrar en lote con patrones complejos. Cualquier flujo que normalmente harías con un script de bash o de PowerShell pasa a ser una conversación.

El manejo de procesos también está disponible: arrancar un servidor local, ver qué procesos están corriendo, parar uno que se quedó colgado. Para desarrollo web, donde a menudo tienes varios servicios en paralelo, esto evita saltar entre ventanas. El agente puede comprobar si el dev server está vivo, reiniciarlo si hace falta y volver al hilo.

Donde realmente brilla es en encadenar todo eso. Pídele “clona este repo, instala dependencias, corre los tests y dime qué falló”. El agente ejecuta los comandos en orden, lee la salida de cada uno y te entrega un diagnóstico. Lo que era media hora de ir y venir entre la terminal y el chat se convierte en una sola instrucción.

Cómo conectarlo

El flujo es directo si ya usas Claude Code. Primero verifica que tienes Node.js instalado con node --version. La mayoría de servidores MCP corre con npx y este no es la excepción.

Después, desde un terminal, ejecuta el comando que aparece en el frontmatter:

claude mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander

Eso registra el servidor en la configuración de Claude Code. Confirma que ha quedado bien con:

claude mcp list

Si ves desktop-commander en la lista, está listo. El comando es el mismo en Windows y en Mac. Lo que cambia, una vez en uso, son las rutas y los comandos de terminal propios de cada sistema (dir frente a ls, Get-ChildItem frente a find, separadores de ruta, etc.).

Si trabajas en Claude Desktop en lugar de Claude Code, el camino pasa por editar claude_desktop_config.json a mano y añadir un bloque dentro de mcpServers con command igual a npx y args con -y y el nombre del paquete. La ficha ¿Qué es un MCP? explica el flujo general.

La primera vez que el agente quiera usar el MCP te pedirá permiso, igual que con cualquier otro. A partir de ahí, cada comando que proponga ejecutar te llegará como una propuesta que tú apruebas o rechazas. No automatices este paso: en este MCP, leer antes de aprobar es la mitad de la seguridad.

Seguridad y permisos

Este es el MCP más sensible de toda la biblioteca. El servidor corre con tus permisos de usuario, así que cualquier cosa que tú podrías hacer desde una terminal, el agente puede proponerla. Eso incluye borrar archivos, modificar configuraciones del sistema y, dependiendo de tu cuenta, tocar instalaciones globales. Conviene usarlo solo en máquinas donde estés cómodo con ese alcance.

Algunas reglas prácticas: no lo uses en máquinas con datos críticos o de producción si no entiendes exactamente qué hace cada comando que apruebas; revisa con calma los comandos que toquen rutas del sistema, borrados (rm, Remove-Item), sobrescrituras o redirecciones (>); evita aprobar cadenas largas con && sin haberlas leído entera; y, si la tarea requiere credenciales, usa placeholders y nunca dejes secretos en comandos que queden en el historial. En entornos compartidos o corporativos, asegúrate de que tu admin esté al tanto de que tienes este MCP activo: estás equipando al agente con una shell.

Una buena costumbre es probarlo primero en una máquina virtual o en una cuenta limitada antes de soltarlo en tu equipo principal. No por miedo a “que se rebele”, sino para entender en qué tipo de propuestas piensa el agente y ajustar tus reflejos a la hora de aprobar.

Casos de uso reales

Una desarrolladora le pide al agente “ve a la carpeta de mi proyecto, mira por qué los tests están en rojo y arréglalo si es obvio”. El agente entra al directorio, corre los tests, lee la traza, identifica un import roto y propone el cambio. Ella revisa, aprueba y queda hecho.

Un técnico de sistemas necesita un script puntual para extraer logs de varios servicios, comprimirlos y enviarlos a una carpeta de soporte. Le describe la tarea y el agente compone el flujo: lista los archivos, los filtra por fecha, los empaqueta, los mueve. Lo que era media hora de bash sale en cinco minutos de conversación.

Una persona poco técnica usa el MCP para ordenar su carpeta de descargas: “junta todos los PDFs de la carpeta Downloads, ordénalos por mes según su fecha de descarga y muévelos a Documentos/Recibos”. El agente propone los comandos paso a paso y los ejecuta tras su aprobación.

Errores comunes y cómo evitarlos

• No aparece en claude mcp list. Casi siempre falta Node.js o el claude mcp add se ejecutó con un error que pasaste por alto. Repítelo y lee la salida con atención.
• Aprobar comandos sin leerlos. El riesgo número uno. Si el comando es largo, pide al agente que lo explique antes de aprobar; el coste es cinco segundos y el beneficio enorme.
• Borrados a ciegas. Cualquier comando con rm -rf, Remove-Item -Recurse o equivalentes merece una pausa. Comprueba la ruta exacta antes de pulsar permitir.
• Comandos que dependen del directorio actual. Si el agente arranca en una carpeta que no esperas, un git pull o un npm install puede caer en el sitio equivocado. Confirma el directorio en cada propuesta crítica.
• Diferencias entre Windows y Mac. Si el agente propone ls en una PowerShell que no lo entiende, o dir en una Mac, recuérdale qué sistema estás usando. Suele adaptarse rápido pero conviene afinarlo.
• Procesos colgados. Si un comando se queda esperando entrada (típico de instaladores interactivos), el flujo se bloquea. Cancélalo y vuelve a lanzarlo con flags no interactivos (-y, --yes o equivalentes).

Combinarlo con otros MCPs y skills

Desktop Commander es la “shell” que muchos otros flujos necesitan por debajo. Se complementa con el MCP de GitHub (clonar, hacer commits, abrir PRs) y con filesystem (cuando quieres restringir el alcance a unas pocas carpetas concretas). Con las skills de desarrollo de Claude Code, sirve para que el agente no solo proponga cambios sino que también los ejecute y los valide.

Mini-ejercicio

Conecta el MCP y, en una carpeta de prueba, pide al agente “lista los archivos, indícame los más grandes y propón cómo organizarlos en subcarpetas por tipo”. Apruébale los comandos uno a uno y observa cómo razona. Sabrás que está bien si los archivos quedan reorganizados según tu criterio y tú entendiste cada paso antes de aprobarlo.