PruneoServidor MCP de Pruneo: limpia tu Mac desde Claude Code o Codex
Pruneo trae un servidor MCP (Model Context Protocol) en el mismo programa. Lo conectas con un comando y tu agente de IA puede ver cuánto ocupa cada sección, listar lo que se puede limpiar, mover lo seguro a la cuarentena y restaurarlo. Lo que pide confirmación, lo protegido y la Papelera los decides tú en la app.
Si ya trabajas con un agente de IA en la terminal, no tienes que abrir otra app para liberar espacio. Le pides «¿qué ocupa espacio en mi Mac?» o «limpia las cachés de Node que se puedan borrar», y el agente usa Pruneo para hacerlo, con las mismas reglas de seguridad que la app.
Qué es el servidor MCP de Pruneo
pruneo mcp es un servidor MCP que viene dentro de Pruneo: no se instala nada aparte. Habla por stdio (JSON-RPC 2.0), corre en tu Mac y no usa la red.
Las cinco herramientas
| Herramienta | Qué hace |
|---|---|
get_disk_overview |
Espacio del disco y, por sección, cuánto es seguro, cuánto pide revisión, cuánto está protegido y cuánto puede limpiar el agente |
list_section_items |
Lo que hay en una sección: nombre, ruta con ~, tamaño, riesgo y si el agente lo puede limpiar |
get_quarantine |
Lo que está en la cuarentena: cada lote, su tamaño, sus rutas y cuándo vence |
clean_safe_items |
Mueve lo seguro de una sección a la cuarentena. Con paths eliges qué, con dry_run simulas. Devuelve qué movió, cuánto liberó y cómo deshacerlo |
restore_from_quarantine |
Devuelve un lote a su lugar |
Cómo conectarlo
Con Pruneo instalado en Aplicaciones:
pruneo mcp --install claudeEso agrega Pruneo a Claude Code para todos tus proyectos. Para Codex:
pruneo mcp --install codexSin argumentos, pruneo mcp --install muestra cómo conectarlo en Claude Code, Codex, Claude Desktop, Cursor y otros. Para cualquier cliente que lea la configuración en JSON:
{
"mcpServers": {
"pruneo": {
"command": "/Applications/Pruneo.app/Contents/Helpers/pruneo",
"args": ["mcp"]
}
}
}Si todavía no tienes el comando pruneo en la terminal, instálalo desde la app, en Programadas › «Desde la terminal» › «Instalar comando». O usa la ruta completa: /Applications/Pruneo.app/Contents/Helpers/pruneo mcp --install claude.
Qué puede y qué no puede hacer el agente
El agente puede mirar todo y limpiar solo lo seguro: lo que en la app aparece en verde y entra en «Limpiar lo seguro». Siempre a la cuarentena, nunca borrado directo.
Rechaza, aunque se lo pidas:
- Lo que pide confirmación (amarillo) y lo protegido (candado).
- La Papelera y las copias locales de Time Machine.
- Las carpetas desconocidas que identificó un agente de IA.
- Lo que se limpia con un comando oficial sin posibilidad de deshacer, como
docker system prune.
Eso lo decides tú, en la app, mirando cada elemento.
Ejemplos para pedirle a tu agente
- «¿Cuánto espacio puedo liberar en mi Mac sin riesgo?»
- «Muéstrame qué ocupa la sección de Node y limpia solo lo seguro.»
- «Simula una limpieza de Xcode y dime cuánto liberaría.»
- «Restaura lo último que limpiaste.»
Preguntas frecuentes
¿Qué es MCP?
MCP (Model Context Protocol) es un estándar abierto para que los agentes de IA usen herramientas externas. Claude Code, Codex, Claude Desktop y Cursor, entre otros, lo admiten.
¿Cómo conecto Pruneo a Claude Code?
Con Pruneo en Aplicaciones, ejecuta pruneo mcp --install claude en la terminal. Pruneo agrega el servidor a Claude Code por ti. Para Codex, pruneo mcp --install codex.
¿El agente puede borrar archivos?
No borra nada: solo mueve a la cuarentena lo que Pruneo marca como seguro (verde). Lo que pide confirmación, lo protegido, la Papelera, Time Machine y las carpetas desconocidas se rechazan.
¿Puedo deshacer lo que hizo el agente?
Sí. Cada limpieza devuelve el lote de la cuarentena y cómo restaurarlo. El agente puede restaurarlo con restore_from_quarantine, y tú desde la app o con pruneo quarantine restore.
¿El servidor MCP se conecta a internet?
No. Corre en tu Mac, por stdio, y no nos envía nada. Lo que el agente lee del análisis (rutas y tamaños) llega al proveedor de ese agente, según sus condiciones.