AI Access — tool file MCP untuk asisten Anda
Buka tool file mcp untuk Claude Code atau Gemini lewat server lokal — asisten Anda mengirim instruksi, tool aplikasi bekerja di disk.
AI Access mengubah 1FileTool menjadi server MCP lokal agar asisten AI bisa menjalankan tool file mcp-nya — kompres, konversi, rename, redaksi, dan lainnya — dalam bahasa biasa, tanpa pernah mengunggah file. Asisten mengirim instruksi ke 127.0.0.1; setiap pekerjaan berjalan di dalam aplikasi di mesin Anda.
Aktifkan
Settings › AI Access memuat seluruh pengaturan:
- Aktifkan Allow AI assistant access. Badge status berubah menjadi Listening — server hanya bind ke
127.0.0.1, jadi tidak ada yang bisa dijangkau dari jaringan. - Di bawah Your AI tools, klik Connect. 1FileTool menulis dirinya ke config klien yang terdeteksi sebagai server MCP
onefiletool— satu klik untuk Claude Code (~/.claude.json) dan Gemini CLI (~/.gemini/settings.json). - Restart CLI agar mengenali server baru.
File config Codex CLI tidak dihormati dengan cara sama oleh rilis Codex saat ini, jadi untuk Codex — dan klien MCP lain — buka Set up another client manually, tekan Copy, dan tempel cuplikan JSON ke config MCP klien itu sendiri.
Lalu tinggal minta — contoh dari aplikasinya: use 1filetool mcp to compress these images.
Apa yang didapat asisten
Tiga belas tool, semua berprefix filetool_:
| Tool | Tujuan |
|---|---|
filetool_status | Status aplikasi dan batas plan |
filetool_list_operations | Temukan semua 76 operasi dan parameternya |
filetool_run | Jalankan operasi apa pun by id — tool serbaguna |
filetool_inspect | Baca metadata file tanpa mengubahnya |
filetool_extract_text | Teks dari PDF dan dokumen |
filetool_compress_images / filetool_convert_images | Pekerjaan gambar |
filetool_compress_pdf / filetool_pdf_convert | Pekerjaan PDF |
filetool_compress_video | Pekerjaan video |
filetool_to_markdown | Dokumen apa pun (Office, PDF, HTML, EPUB, CSV) sebagai Markdown yang mudah dibaca model |
filetool_count_tokens | Jumlah token dan context window mana yang muat untuk file |
filetool_pack_context | Sebuah folder, atau hanya perubahan Git-nya, dikemas menjadi satu bundle dengan secret disamarkan |
Tool praktis mencakup panggilan umum dalam satu tembakan; filetool_run menjangkau semua lainnya — termasuk workflow recipe lewat workflow_run_recipe dan, sejak 1.11.1, dua belas pekerjaan Office dan AI Context seperti office_to_pdf, office_to_csv, office_strip_metadata, dan context_chunk (lihat Tool Word, Excel, dan PowerPoint dan AI Context).
Pagar pembatas
- Operasi destruktif bertanya dulu. Operasi seperti rename file berpola atau penghancuran membawa badge Asks first — asisten harus mengirim
confirm: true, jadi agen tidak bisa menghancurkan atau rename massal dari prompt yang salah paham. - Batas aplikasi tetap berlaku. Run MCP berbagi kuota yang sama dengan mengklik tombol: plan gratis 8 file per hari, beberapa operasi khusus Pro (folder watching salah satunya), dan AI di perangkat berjalan sebagai pratinjau. Asisten Anda diberi tahu saat batas tercapai.
- Aplikasi harus berjalan, atau diizinkan untuk mulai sendiri. Server hidup di dalam 1FileTool. Aktifkan Start when your assistant needs it di Settings › AI Access dan permintaan dari asisten Anda akan membuka 1FileTool di latar belakang, hanya dengan ikon di menu bar atau system tray. Selama AI Access aktif, menutup jendela membuat aplikasi tetap berjalan di sana; Quit tetap keluar dan membawa koneksinya ikut hilang.
Perbandingan dengan AI Chat
AI Chat adalah jendela chat di dalam aplikasi untuk berbicara tentang file. AI Access adalah arah sebaliknya: Anda tetap di terminal atau editor sendiri, dan asisten menjangkau ke dalam aplikasi untuk menjalankan toolnya. Instruksi yang melintasi kabel; file tidak pernah melintas.