Claude Code가 파일을 압축하고 변환하게 하기 (MCP)

AI 어시스턴트가 그 자리에서 지어내는 스크립트 대신 실제 도구로 파일을 처리하게 하세요. 1FileTool의 AI Access는 64개 작업 — 압축, 변환, 추출, 가리기 — 을 MCP 서버로 노출해 Claude Code나 Gemini가 호출할 수 있게 하며, 모든 파일은 머신에 남습니다.

$ claude
Claude Code v2.x

> Compress every image in ~/Desktop/sample-photos and put the results in
  ~/Desktop/sample-photos/compressed

● I'll use the 1FileTool MCP bridge running on this Mac.

● filetool_compress_images(paths: ["~/Desktop/sample-photos"], quality: 82,
    output_dir: "~/Desktop/sample-photos/compressed")
  ⎿  Compressed 12 images
     38.2 MB → 6.9 MB (saved 81.9%)
     Results in ~/Desktop/sample-photos/compressed

● Done — 12 images compressed from 38.2 MB to 6.9 MB. The originals are
  untouched; the compressed copies are in the compressed/ subfolder.

Note: MCP runs count toward the daily total — 12 files exceeds the free
tier's 8 files/day, so a batch this size needs Pro.

위 캡처는 실제 Claude Code 세션입니다: 평이한 프롬프트 하나, filetool_compress_images 호출 한 번, 12장의 이미지가 38.2MB에서 6.9MB로 줄었습니다.

필요한 것

• 1FileTool 1.10.0 이상 — macOS(Apple Silicon 또는 Intel), Windows 또는 Linux.
• 같은 머신에 설치된 Claude Code 또는 Gemini CLI. 원클릭 설정은 이 두 클라이언트만 커버합니다.
• 어시스턴트 자체를 위한 인터넷 연결 — 파일은 절대 머신을 떠나지 않지만 AI CLI는 자기 클라우드 모델과 통신합니다.

ZIP에는 합성 JPG 사진 다섯 장(hero-photo.jpg, team-photo.jpg, product-shot.jpg, banner.jpg, cover.jpg)이 들어 있습니다 — 어시스턴트에게 가리킬 안전한 이미지 폴더입니다.

그 경고는 앱 UI용입니다 — MCP에서는 filetool_compress_images 같은 작업이 *_compressed 사본을 출력 폴더에 쓰고 원본은 건드리지 않습니다. 그리고 기억해 두세요: 에이전트 실행은 파일 하나씩 무료 플랜의 하루 8개 파일에 계산되므로, 12개 배치는 Pro나 더 작은 폴더가 필요합니다.

단계

1. AI Access 설정 열기

1FileTool을 실행하고 Settings를 연 뒤 AI Access 탭을 클릭하고 MCP 섹션을 선택합니다.

2. AI access 켜기

Allow AI assistant access를 켭니다. 상태 배지가 Listening으로 바뀌고 문구가 경계를 정확히 알려 줍니다: "Accepting local requests on 127.0.0.1:<port>. Nothing is exposed to the network." 브리지는 실행마다 토큰이 있는 loopback 전용입니다 — 열린 포트도, 계정도, 업로드도 없습니다.

3. CLI 연결

Connect를 클릭합니다. 1FileTool은 발견한 지원 클라이언트 전부에 onefiletool MCP 서버로 자신을 등록합니다:

• Claude Code — ~/.claude.json에 씁니다
• Gemini CLI — ~/.gemini/settings.json에 병합합니다

배지가 각 클라이언트("Claude Code", "Gemini CLI")를 보여 주고, 설치되지 않은 것 옆에는 "— not found"가 붙습니다. 확인 메시지는 "Connected. Restart Claude Code to pick up the new tools."입니다 — 서버를 로드하도록 CLI를 재시작하세요.

다른 것을 쓰고 있나요? Set up another client manually가 붙여넣기 준비된 config 블록을 펼쳐 줍니다.

4. 작업 요청

Claude Code나 Gemini 세션에서 평이한 말로 요청하세요 — 설정 페이지가 문구를 추천합니다:

use 1filetool mcp to compress these images

폴더를 가리켜 보세요 — 샘플 ZIP을 풀고 "use 1filetool mcp to compress the images in this folder"를 시도하세요. 어시스턴트가 알맞은 filetool_* 작업을 고르고, 작업은 1FileTool을 통해 로컬에서 실행되며, 결과는 출력 폴더에 저장됩니다.

결과

샘플 폴더 압축을 요청받으면 어시스턴트는 filetool_compress_images를 실행하고 *_compressed.jpg 사본이 ~/Documents/1FileTool(또는 출력 폴더로 설정된 곳)에 나타납니다. 원본은 그대로입니다.

압축 외에도 어시스턴트는 64개 작업에 닿을 수 있습니다 — filetool_list_operations가 나열합니다: 이미지(12), PDF(20), 비디오(9), 오디오(7), 파일·데이터(6), 프라이버시(4), 기기 내 AI(4), 그리고 검사와 상태. 두 작업은 Pro가 필요하고 나머지는 앱의 무료 일일 할당량을 공유합니다.

작동하지 않을 때

• CLI가 도구를 전혀 보지 못함. Connect 클릭 후 재시작하세요 — 서버는 config에 등록되지만 새로 실행해야 로드됩니다.
• 도구 출력의 "PRO_REQUIRED". 두 작업 — auto-redact와 watch-folder 자동화 — 는 Pro 전용입니다. 어시스턴트에게 알려지고 메시지를 전달할 수 있습니다.
• "Daily free limit reached". 에이전트 실행은 프롬프트가 아니라 파일당 계산되므로 12장 배치가 8개 무료 할당량을 통째로 쓸 수 있습니다. 내일 리셋되고 Pro는 제한을 없앱니다.
• 1FileTool 앱이 실행 중이 아님. MCP 서버는 앱으로 가는 브리지입니다 — 앱이 닫혀 있으면 어시스턴트의 호출이 갈 곳이 없습니다.
• Codex 설정. Codex 행은 UI에 있지만 자동 설정은 Codex가 읽지 않는 파일을 씁니다 — config 블록에서 수동으로 설정하거나 Claude Code나 Gemini를 쓰세요.

다음으로 시도

어시스턴트가 호출하는 압축 작업을 브라우저에서 바로 보세요:

관련 항목

• AI Access와 MCP 레퍼런스
• Free vs Pro
• 1FileTool 설치
• Compress Images 및 Compress Video