Để Claude Code nén và chuyển đổi file của bạn (MCP)

Để trợ lý AI chạy file của bạn qua những công cụ thật, thay vì những script nó tự bịa ra ngay lúc đó. AI Access của 1FileTool mở 64 thao tác — nén, chuyển đổi, trích xuất, che giấu — dưới dạng MCP server mà Claude Code hoặc Gemini có thể gọi, trong khi mọi file vẫn nằm trên máy của bạn.

$ 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.

Ảnh chụp phía trên là một phiên Claude Code thật: một prompt bằng lời nói thường, một lời gọi filetool_compress_images, mười hai bức ảnh từ 38.2 MB còn 6.9 MB.

Bạn cần gì

• 1FileTool 1.10.0 trở lên trên macOS (Apple Silicon hoặc Intel), Windows, hoặc Linux.
• Claude Code hoặc Gemini CLI đã cài trên cùng máy. Cài đặt một chạm chỉ hỗ trợ hai client này.
• Kết nối internet cho chính trợ lý — file của bạn không bao giờ rời khỏi máy, nhưng AI CLI cần nói chuyện với model cloud của nó.

ZIP chứa năm ảnh JPG tổng hợp (hero-photo.jpg, team-photo.jpg, product-shot.jpg, banner.jpg, cover.jpg) — một thư mục ảnh an toàn để chỉ cho trợ lý vào.

Cảnh báo đó dành cho giao diện app — qua MCP, các thao tác như filetool_compress_images ghi các bản *_compressed vào thư mục output và không động vào file gốc. Và nhớ điều này: chạy qua agent tính theo từng file cho hạn mức 8-file-mỗi-ngày của gói free, nên một batch 12 file sẽ cần Pro hoặc thư mục nhỏ hơn.

Các bước

1. Mở cài đặt AI Access

Mở 1FileTool, vào Settings, bấm tab AI Access, rồi chọn mục MCP.

2. Bật quyền truy cập AI

Gạt Allow AI assistant access. Badge trạng thái chuyển sang Listening và phần mô tả nói rõ ranh giới: "Accepting local requests on 127.0.0.1:<port>. Nothing is exposed to the network." Bridge này chỉ loopback với token sinh mỗi lần mở app — không port mở, không tài khoản, không upload.

3. Kết nối CLI của bạn

Bấm Connect. 1FileTool tự đăng ký là MCP server onefiletool với mọi client được hỗ trợ mà nó tìm thấy:

• Claude Code — ghi vào ~/.claude.json
• Gemini CLI — gộp vào ~/.gemini/settings.json

Các badge hiển thị từng client ("Claude Code", "Gemini CLI"), kèm "— not found" bên cạnh client chưa cài. Thông báo xác nhận ghi "Connected. Restart Claude Code to pick up the new tools." — khởi động lại CLI để nó nạp server.

Dùng client khác? Set up another client manually sẽ mở ra một khối config sẵn sàng để dán.

4. Đặt việc cho nó

Trong phiên Claude Code hoặc Gemini, hỏi bằng ngôn ngữ thường — trang cài đặt gợi ý sẵn câu:

use 1filetool mcp to compress these images

Chỉ cho nó một thư mục — giải nén ZIP mẫu và thử "use 1filetool mcp to compress the images in this folder". Trợ lý sẽ chọn đúng thao tác filetool_*, job chạy local qua 1FileTool, và kết quả nằm trong thư mục output của bạn.

Kết quả

Khi được yêu cầu nén thư mục mẫu, trợ lý chạy filetool_compress_images và các bản *_compressed.jpg xuất hiện trong ~/Documents/1FileTool — hoặc bất cứ đâu bạn đặt thư mục output. File gốc không bị động vào.

Ngoài nén, trợ lý của bạn tiếp cận được 64 thao tác — filetool_list_operations liệt kê tất cả: ảnh (12), PDF (20), video (9), audio (7), file & dữ liệu (6), riêng tư (4), AI on-device (4), cộng thêm kiểm tra và trạng thái. Hai thao tác cần Pro; phần còn lại dùng chung hạn mức free hằng ngày của app.

Nếu không hoạt động

• CLI không thấy tool nào. Khởi động lại nó sau khi bấm Connect — server đã đăng ký vào config, nhưng chỉ phiên mới mới nạp nó.
• "PRO_REQUIRED" trong output của tool. Hai thao tác — auto-redact và automation theo dõi thư mục — chỉ dành cho Pro. Trợ lý được báo điều này và có thể chuyển lại cho bạn.
• "Daily free limit reached". Chạy qua agent tính theo file chứ không theo prompt, nên một batch 12 ảnh có thể ăn hết 8-file miễn phí. Ngày mai sẽ reset; Pro bỏ giới hạn.
• App 1FileTool không chạy. MCP server là cầu nối tới app — nếu app đóng, các lời gọi của trợ lý không có nơi để đi tới.
• Cài đặt Codex. Hàng Codex có trong UI, nhưng phần auto-setup ghi một file mà Codex không đọc — hãy cài client đó thủ công từ khối config, hoặc dùng Claude Code hay Gemini.

Thử tiếp

Xem ngay thao tác nén mà trợ lý của bạn gọi, ngay trong trình duyệt:

Liên quan

• Tài liệu AI Access và MCP
• Free vs Pro
• Cài đặt 1FileTool
• Compress Images và Compress Video