PruneoServidor MCP do Pruneo: limpe o seu Mac pelo Claude Code ou Codex
O Pruneo traz um servidor MCP (Model Context Protocol) no mesmo programa. Você conecta com um comando, e o seu agente de IA consegue ver quanto ocupa cada seção, listar o que pode ser limpo, mover o que é seguro para a quarentena e restaurar. O que pede confirmação, o que é protegido e a Lixeira ficam com você, no app.
Se você já trabalha com um agente de IA no terminal, não precisa abrir outro app para liberar espaço. Pergunte “o que está ocupando espaço no meu Mac?” ou peça “limpe os caches do Node que podem ser apagados”, e o agente usa o Pruneo para fazer isso, com as mesmas regras de segurança do app.
O que é o servidor MCP do Pruneo
pruneo mcp é um servidor MCP que vem dentro do Pruneo: não tem nada a mais para instalar. Ele se comunica via stdio (JSON-RPC 2.0), roda no seu Mac e não usa a rede.
As cinco ferramentas
| Ferramenta | O que faz |
|---|---|
get_disk_overview |
Espaço em disco e, por seção, quanto é seguro, quanto pede revisão, quanto está protegido e quanto o agente pode limpar |
list_section_items |
O que tem em uma seção: nome, caminho com ~, tamanho, risco e se o agente pode limpar |
get_quarantine |
O que está na quarentena: cada lote, o tamanho, os caminhos e quando expira |
clean_safe_items |
Move o que é seguro de uma seção para a quarentena. Com paths você escolhe o quê, com dry_run você simula. Devolve o que moveu, quanto liberou e como desfazer |
restore_from_quarantine |
Coloca um lote de volta onde estava |
Como conectar
Com o Pruneo instalado em Aplicativos:
pruneo mcp --install claudeIsso adiciona o Pruneo ao Claude Code para todos os seus projetos. Para o Codex:
pruneo mcp --install codexSem argumentos, pruneo mcp --install mostra como conectar no Claude Code, Codex, Claude Desktop, Cursor e outros. Para qualquer cliente que leia uma configuração em JSON:
{
"mcpServers": {
"pruneo": {
"command": "/Applications/Pruneo.app/Contents/Helpers/pruneo",
"args": ["mcp"]
}
}
}Se você ainda não tem o comando pruneo no terminal, instale pelo app, em Programadas › “Pelo terminal” › “Instalar comando”. Ou use o caminho completo: /Applications/Pruneo.app/Contents/Helpers/pruneo mcp --install claude.
O que o agente pode e não pode fazer
O agente pode ver tudo e limpar só o que é seguro: o que aparece em verde no app e entra em “Limpar o que é seguro”. Sempre para a quarentena, nunca apagado direto.
Ele recusa, mesmo se você pedir:
- O que pede confirmação (amarelo) e o que é protegido (cadeado).
- A Lixeira e os snapshots locais do Time Machine.
- Pastas desconhecidas identificadas por um agente de IA.
- O que é limpo com um comando oficial que não dá para desfazer, como
docker system prune.
Isso você decide no app, olhando cada item.
Pedidos para fazer ao seu agente
- “Quanto espaço eu posso liberar no meu Mac sem risco?”
- “Mostre o que a seção do Node ocupa e limpe só o que é seguro.”
- “Simule uma limpeza do Xcode e me diga quanto liberaria.”
- “Restaure a última coisa que você limpou.”
Perguntas frequentes
O que é MCP?
MCP (Model Context Protocol) é um padrão aberto que permite que agentes de IA usem ferramentas externas. Claude Code, Codex, Claude Desktop e Cursor, entre outros, suportam.
Como eu conecto o Pruneo ao Claude Code?
Com o Pruneo em Aplicativos, rode pruneo mcp --install claude no terminal. O Pruneo adiciona o servidor ao Claude Code para você. Para o Codex, pruneo mcp --install codex.
O agente pode apagar arquivos?
Ele não apaga nada: só move para a quarentena o que o Pruneo marca como seguro (verde). O que pede confirmação, o que é protegido, a Lixeira, o Time Machine e as pastas desconhecidas são recusados.
Posso desfazer o que o agente fez?
Sim. Cada limpeza devolve o lote da quarentena e como restaurá-lo. O agente pode restaurar com restore_from_quarantine, e você pode fazer isso pelo app ou com pruneo quarantine restore.
O servidor MCP se conecta à internet?
Não. Ele roda no seu Mac, via stdio, e não envia nada para a gente. O que o agente lê da análise (caminhos e tamanhos) chega ao provedor desse agente, conforme os termos dele.