AI Access — các công cụ file MCP cho trợ lý của bạn
Phơi các công cụ file MCP cho Claude Code hoặc Gemini qua một server local — trợ lý gửi chỉ thị, các công cụ của app làm việc trên đĩa.
AI Access biến 1FileTool thành một MCP server local để trợ lý AI có thể chạy các công cụ file MCP của nó — nén, chuyển đổi, đổi tên, che giấu và phần còn lại — bằng ngôn ngữ tự nhiên, không bao giờ tải file lên. Trợ lý gửi chỉ thị tới 127.0.0.1; mọi tác vụ chạy bên trong app trên máy của bạn.
Bật nó lên
Settings › AI Access chứa toàn bộ phần thiết lập:
- Gạt Allow AI assistant access. Huy hiệu trạng thái chuyển sang Listening — server chỉ bind
127.0.0.1, nên không có gì truy cập được từ mạng. - Dưới Your AI tools, bấm Connect. 1FileTool tự ghi vào config của các client phát hiện được dưới tên MCP server
onefiletool— một cú nhấp cho Claude Code (~/.claude.json) và Gemini CLI (~/.gemini/settings.json). - Khởi động lại CLI để nó nhận server mới.
File config của Codex CLI không được các bản Codex hiện tại tôn trọng theo cùng cách, nên với Codex — và mọi client có khả năng MCP khác — mở Set up another client manually, bấm Copy, và tự dán đoạn JSON vào config MCP của client đó.
Rồi cứ hỏi — ví dụ của chính app: use 1filetool mcp to compress these images.
Trợ lý nhận được gì
Mười công cụ, tất cả có tiền tố filetool_:
| Công cụ | Mục đích |
|---|---|
filetool_status | Trạng thái app và giới hạn gói |
filetool_list_operations | Khám phá cả 64 operation và tham số của chúng |
filetool_run | Chạy bất kỳ operation nào theo id — công cụ đa dụng |
filetool_inspect | Đọc metadata của file mà không sửa nó |
filetool_extract_text | Lấy text từ PDF và tài liệu |
filetool_compress_images / filetool_convert_images | Tác vụ ảnh |
filetool_compress_pdf / filetool_pdf_convert | Tác vụ PDF |
filetool_compress_video | Tác vụ video |
Các công cụ tiện ích phủ các lời gọi phổ biến trong một lượt; filetool_run với tới mọi thứ khác — kể cả workflow recipe qua workflow_run_recipe.
Các rào chắn
- Các operation phá hủy phải hỏi trước. Những operation như đổi tên theo pattern hay tiêu hủy file mang huy hiệu Asks first — trợ lý phải truyền
confirm: true, nên agent không thể tiêu hủy hay đổi tên hàng loạt vì một prompt bị hiểu nhầm. - Giới hạn của app vẫn áp dụng. Các lượt chạy MCP chia sẻ cùng hạn ngạch như bấm nút: gói free là 8 file mỗi ngày, một vài operation chỉ dành cho Pro (theo dõi thư mục, chẳng hạn), và AI trên thiết bị chạy ở dạng preview. Trợ lý của bạn được báo khi chạm giới hạn.
- App phải đang chạy. Server sống bên trong 1FileTool — thoát app là kết nối đi cùng.
Vị trí so với AI Chat
AI Chat là một cửa sổ chat bên trong app để nói về file. AI Access là chiều ngược lại: bạn ở lại trong terminal hoặc editor của mình, và trợ lý với vào app để chạy công cụ của nó. Chỉ thị đi qua đường truyền; file thì không bao giờ.