AI 에이전트의 Mac 정리, 승인과 기록부터 설정하세요
Mint Direct의 로컬 MCP는 저장 공간을 읽고, 스캔 계획의 적합한 항목을 휴지통으로 옮기며 처리 기록을 반환합니다. 매번 사람이 승인해야 한다면 에이전트 클라이언트에서 mint_execute 실행 전 확인을 설정하세요. Mint 연결 자체가 모든 호출에 별도 확인 창을 추가하거나 다른 shell 명령을 막지는 않습니다.
핵심 요약
- 먼저 읽기. 읽기 도구로 범위와 대상을 확인합니다.
- 승인은 별도 설정. 에이전트의 실행 권한에서 매번 확인하도록 설정합니다.
- 복구 조건 확인. 기록이 있어도 모든 작업을 되돌릴 수 있는 것은 아닙니다.
Mint Direct 연결하기
CLI와 MCP는 공식 웹사이트에서 받는 Direct 배포판에 포함됩니다. Mac App Store와 Setapp 배포판에는 포함되지 않습니다. MCP는 Mac에서 표준 입출력으로 동작하며 스캔과 정리는 Mint 앱에 요청합니다.
- Mint Direct를 설치하고 직접 한 번 실행합니다.
- 터미널에서 mint-cli status가 저장 공간 요약을 보여 주는지 확인합니다.
- 에이전트의 MCP 설정에 명령 mint-cli, 인수 mcp를 추가합니다.
- 연결 후 도구 목록에서 실제 이름과 읽기/실행 범위를 확인합니다.
읽기 도구와 실행 도구 구분
mint_status와 mint_why는 디스크 상태와 증가 원인을 읽습니다. mint_scan은 읽기 전용 정리 스캔을 실행하고 대상·이유·실행 가능 여부와 계획 ID를 반환합니다.
mint_recent와 mint_activity는 기록을, mint_agents는 최근 AI 도구 스캔을 읽습니다. mint_rules는 규칙을 나열하거나 시험 실행합니다. 이 읽기 도구들은 파일을 정리하지 않습니다.
매번 실행 전 승인이 필요하다면
mint_execute에 유효한 요청을 보내면 별도의 Mint 확인 창 없이 원래 정리 흐름으로 전달될 수 있습니다. 에이전트의 권한 설정에서 실행 전 확인을 요구하고 전체 MCP 서버를 일괄 허용하지 마세요. Mint는 다른 shell 도구 사용을 차단하지 않습니다.
- 스캔 결과에서 선택한 항목 ID, 범위, 예상량, 재생성 가능성과 남길 데이터를 설명하게 합니다.
- Claude Code에서는 /permissions를 열고 실제 표시된 전체 MCP 도구 이름으로 실행 전 확인을 설정합니다. 플러그인 이름은 다를 수 있습니다.
- 검토한 계획과 항목만 승인합니다. 계획이 바뀌거나 만료되면 새로 스캔하고 검토합니다.
- 반환된 기록 ID·실패 항목·휴지통 이동량을 mint_recent와 비교합니다.
실행할 수 있는 작업의 경계
mint_execute는 최근 스캔의 planId와 선택한 itemIds, 처리 이유를 받으며 임의 파일 경로를 받지 않습니다. 계획은 15분 뒤 만료되고 한 번만 사용할 수 있습니다. 실제 처리 직전에 대상의 상태와 권한을 다시 확인합니다.
MCP는 적합한 항목을 휴지통으로 옮길 수 있으며 영구 삭제를 실행하지 않습니다. Needs Review 항목은 앱에서 확인합니다. 대화 이미지 최적화, 미디어 제거, 중복 파일 저장 공간 공유, 폴더 규칙 편집은 현재 MCP 실행 범위에 포함되지 않습니다.
기록은 전체 백업이 아닙니다
결과에는 처리 기록의 배치 ID와 처리량·휴지통 이동량이 포함됩니다. 휴지통으로 이동한 파일은 비우기 전까지 공간을 차지합니다. 알 수 없는 실제 확보량을 절감량으로 간주하지 마세요.
적합한 이동은 필요한 파일과 기록이 남아 있을 때 복구할 수 있습니다. 기록은 최대 90일 또는 5,000개 배치입니다. 중요한 작업은 별도로 백업하세요.
Claude Code checkpoint도 모든 shell 작업을 되돌리는 장치가 아닙니다. Bash만 수정한 파일은 추적되지 않습니다. 승인 설정, 계획 제한, 처리 기록과 백업은 각각 다른 역할입니다.
검증된 근거와 남은 범위
10월 27일 개발팀은 실제 MCP 프로토콜 코드에 테스트용 원래 앱 응답을 주입해 검사했습니다. 원시 경로와 영구 작업의 거부, 선택 ID 전달, 기록과 바이트 필드의 보존 검사가 통과했습니다.
실제 정리나 외부 에이전트의 승인 창을 실행한 검증은 아닙니다. 전체 파일 작업의 안전성이나 모든 Mac의 절감 효과를 입증하지 않습니다. 대화 보존 실측과 외부 사용기는 별도의 근거입니다.
자주 묻는 질문
Mint 연결만 하면 모든 작업이 승인 대기하나요?
아닙니다. 사용하는 에이전트에서 실행 전 확인을 설정해야 합니다. Mint는 다른 shell 도구를 차단하는 sandbox가 아닙니다.
MCP로 대화 Optimize나 영구 삭제를 실행할 수 있나요?
현재 실행 도구는 스캔 계획의 적합한 항목을 휴지통으로 옮깁니다. 대화 Optimize와 영구 작업은 앱에서 별도로 검토하세요.
먼저 저장 공간을 읽고 계획을 검토하세요
Direct 무료 스캔으로 필요한 대상을 확인하고 실행 범위와 복구 조건을 읽은 뒤 결정하세요.