• Server MCP
  • aktar v0.6.0

Biarkan agen AI Anda membagikan file dari bucket Anda sendiri

aktar mcp menghubungkan Claude, Cursor, VS Code, Codex, dan agen lain ke app Aktar. Minta tautan, dan agen mengunggah file ke bucket S3, Cloudflare R2, atau Backblaze B2 milik Anda, lalu memberikan URL atau Markdown-nya. Kunci penyimpanan Anda tidak pernah keluar dari Aktar.

Lalu jalankan aktar login sekali. Cursor, VS Code, Codex, dan lainnya ada di bawah.

Unggah tangkapan layar bug checkout di Desktop saya dan beri saya tautan Markdown untuk issue-nya.

Memanggil Aktar · upload_file

Sudah diunggah ke tujuan Screenshots Anda. Ini Markdown untuk issue-nya:

![checkout-bug.png](https://files.example.com/2026/10/7f3c2a91.png)

Siapkan dalam dua langkah

Aktar untuk Mac atau Windows yang melakukan pengunggahan, jadi ia harus berjalan di komputer yang sama dengan agen Anda.

LANGKAH 01

Pasang perintah aktar dan hubungkan ke Aktar. Di Aktar, buka Pengaturan > Integrasi, nyalakan Izinkan koneksi lokal dan salin tokennya, lalu tempelkan ke aktar login.

npm install -g @getaktar/cli
aktar login
LANGKAH 02

Tambahkan Aktar ke agen Anda, dengan folder tempat ia boleh mengunggah file setelah --root (ulangi untuk folder lain). Agen menjalankan aktar mcp sendiri saat membutuhkannya.

Claude Code

Satu perintah, untuk semua proyek. Ganti ~/Projects dengan folder tempat Anda bekerja. Periksa dengan /mcp di Claude Code.

claude mcp add --scope user aktar -- aktar mcp --root ~/Projects

Jika sebuah app mengatakan tidak menemukan aktar, isi command dengan path lengkap dari which aktar; app desktop tidak selalu memuat PATH shell Anda. Tanpa pemasangan global, pakai npx sebagai command dan ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] sebagai argumen. Ganti /Users/you/Projects dengan folder Anda sendiri (di Windows, seperti C:\\Users\\you\\Projects). Tanpa --root, file hanya diambil dari folder tempat agen menjalankan server, dan tidak ada sama sekali jika itu folder home Anda atau root disk, seperti yang sering terjadi pada app desktop. Agen lain yang menjalankan server MCP lewat stdio bekerja dengan cara yang sama.

Apa yang bisa Anda minta

Ucapkan seperti Anda bicara dengan rekan kerja. Agen memilih alatnya, Aktar melakukan unggahan dengan pengaturan milik tujuan itu sendiri, dan tautannya muncul langsung di percakapan.

  • Bagikan file dari sebuah sesi

    “Zip hasil build-nya dan beri saya tautan yang bisa saya kirim ke QA.”

    Agen membuat file lalu mengunggahnya. Tanpa menyebut tujuan, Aktar memilih satu berdasarkan jenis file (Gunakan untuk pada tiap tujuan), seperti saat file dijatuhkan ke bilah menu.

    Alat:upload_file

  • Gambar untuk README atau issue

    “Tambahkan tangkapan layar baru di docs/images ke README.”

    Ia mengunggah gambar lalu menulis Markdown di tempat yang tepat. Konversi WebP dan penghapusan lokasi dilakukan di Aktar, sesuai pengaturan tujuan.

    Alat:upload_file

  • Perbarui file, pertahankan tautannya

    “Ganti PDF onboarding yang saya bagikan minggu lalu dengan versi baru ini.”

    Ia menemukan unggahan di riwayat dan menimpanya dengan file baru. Semua orang yang punya tautan melihat versi baru; tidak perlu mengirim ulang apa pun. Mengganti berarti menimpa file lama, jadi perlu --allow-replace.

    Alat:search_uploadsreplace_file

  • Temukan yang pernah Anda unggah

    “Apa tautan faktur yang saya unggah hari Senin?”

    Ia mencari di riwayat Aktar berdasarkan nama dan tanggal, dan bisa melihat thumbnail untuk membedakan tangkapan layar, foto, dan dokumen.

    Alat:search_uploadsget_thumbnail

  • Tautan yang kedaluwarsa

    “Buatkan tautan 30 menit ke kontrak di bucket Legal.”

    Tautan presigned ke file mana pun di bucket, untuk bucket pribadi atau berbagi dalam waktu terbatas. Tidak ada yang berubah di bucket.

    Alat:create_temporary_link

  • Lihat-lihat isi bucket Anda

    “Apa isi folder releases di bucket Builds saya?”

    Ia menampilkan folder dan file, termasuk yang tidak diunggah lewat Aktar, dan tahu tujuan mana yang dipakai untuk jenis file apa.

    Alat:list_bucketlist_destinations

Langkah demi langkah untuk alat AI Anda

Plugin siap pakai atau konfigurasi yang bisa Anda salin, beserta apa yang bisa diminta setelah terpasang.

Terdaftar di:Official MCP RegistryGlamamcpservers.org

Alat yang didapat agen Anda

Mencari, menampilkan daftar, tautan sementara, dan thumbnail hanya melihat. Mengunggah mengubah bucket Anda, dan agen Anda bertanya dulu sebelum memakainya kecuali Anda mengizinkannya. Mengganti dan menghapus hanya ditawarkan jika Anda menyalakannya.

ToolFungsinya
upload_fileMengunggah file dan mengembalikan tautan, Markdown, dan HTML-nya. Tujuan, nama, folder, dan masa berlaku bersifat opsional. short meminta tautan pendek, atau tidak sama sekali.
upload_clipboardMengunggah file atau gambar yang ada di clipboard. short meminta tautan pendek, atau tidak sama sekali. Tidak tersedia jika --root diberikan.
replace_fileMenimpa unggahan atau file apa pun di bucket dengan file baru dan mempertahankan tautannya. Hanya dengan --allow-replace atau --allow-delete. Memerlukan Aktar untuk Mac 0.14.0 atau Windows 0.7.0.
create_short_linkMembuat tautan pendek untuk unggahan dengan pemendek tautan milik tujuannya, atau mengembalikan yang sudah ada. Tidak tersedia dengan --read-only. Butuh Aktar untuk Mac 0.17.0 atau Windows 0.10.0.
search_uploadsMencari di riwayat unggahan.
list_destinationsMenampilkan daftar tujuan dan jenis file yang digunakan untuk masing-masing.
list_bucketMenampilkan folder dan file di bucket, termasuk file yang tidak diunggah lewat Aktar.
create_temporary_linkMembuat tautan yang berhenti berfungsi setelah beberapa waktu (presigned URL). Sampai saat itu, siapa pun yang memilikinya bisa mengunduh file tersebut, bahkan dari bucket privat. Paling lama 60 menit kecuali --max-link-minutes mengizinkan lebih.
get_thumbnailMenampilkan pratinjau sebuah unggahan kepada agen. Memerlukan Aktar untuk Mac 0.13.0 atau Windows 0.6.0.
list_watched_foldersMenampilkan daftar folder yang dipantau beserta statusnya.
get_statusMemeriksa koneksi ke Aktar.
delete_uploadMenghapus unggahan dari bucket-nya. Hanya dengan --allow-delete.

Anda yang menentukan apa yang boleh disentuh

Unggahan bisa dibuka siapa pun yang punya tautannya, jadi server mulai dengan sedikit kemampuan dan Anda yang menentukan apa yang ditambahkan.

  • Mengunggah berarti mempublikasikan

    Agen diperintahkan hanya mengunggah apa yang Anda minta untuk dibagikan, dan agen bertanya dulu sebelum memanggil alat yang mengunggah. --log mencatat setiap panggilan alat, jadi nanti Anda bisa melihat apa yang dilakukan agen.
  • Hanya dari folder Anda, tanpa rahasia

    File hanya diambil dari folder yang Anda sebut dengan --root, atau folder tempat agen menjalankan server, tidak pernah seluruh folder home Anda secara tidak sengaja. Kunci SSH dan kunci privat, file .env, kredensial cloud, profil browser, dan database kata sandi ditolak di mana pun letaknya, termasuk lewat symlink.
  • Tidak ada yang ditimpa tanpa izin Anda

    Mengganti file hanya ditawarkan dengan --allow-replace, dan menghapus dengan --allow-delete. --read-only membuang semua alat yang menulis. Tautan sementara berlaku paling lama 60 menit kecuali --max-link-minutes mengizinkan lebih.
  • Kunci Anda tetap di Aktar

    Server berkomunikasi dengan Aktar di 127.0.0.1, dan memeriksa bahwa itu memang Aktar sebelum mengirim token Anda. Agen tidak pernah melihat kunci akses Anda, dan tidak ada yang melewati server kami.
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

Tidak pakai MCP? Gunakan skill

Untuk agen yang memakai skill tetapi tidak MCP, aktar skill mencetak SKILL.md yang mengajarkan perintah aktar kepada mereka: apa yang dijalankan, cara membaca --json, dan hanya mengunggah apa yang Anda minta. Semua perintah ada di dokumentasi CLI.

mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.md

Persyaratan

  • Aktar untuk Mac atau Windows, sedang berjalan, dengan setidaknya satu tujuan
  • Perintah aktar 0.4.0 atau lebih baru (Node.js 18 atau lebih baru). aktar 0.6.0 dan yang lebih baru memerlukan Aktar untuk Mac 0.18.0 atau Windows 0.11.0
  • Agen yang menjalankan server MCP lewat stdio
  • Mengganti file: Aktar untuk Mac 0.14.0 atau Windows 0.7.0. Thumbnail: Mac 0.13.0 atau Windows 0.6.0
  • Open source (MIT) di GitHub, terdaftar di MCP Registry resmi

Pertanyaan

Apakah bisa dipakai dengan ChatGPT atau agen lain di browser?

Belum. Server berjalan di komputer Anda di samping Aktar dan berkomunikasi dengan agen lewat stdio, jadi ia cocok untuk agen yang berjalan di komputer Anda: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, dan lainnya.

Bisakah agen mengunggah file yang tidak saya minta?

Ia hanya bisa memanggil alat yang Anda izinkan, dan agen bertanya dulu sebelum memanggil alat yang mengunggah kecuali Anda menyatakan sebaliknya. File hanya diambil dari folder yang Anda berikan dengan --root (atau folder tempat agen menjalankannya), dan rahasia seperti kunci SSH dan file .env tidak pernah diunggah. --read-only mematikan pengunggahan, dan --log menunjukkan kepada Anda apa saja yang dipanggil.

Ia mengunggah ke bucket yang mana?

Sama seperti saat file dijatuhkan ke bilah menu Aktar: tujuan yang Gunakan untuk-nya cocok dengan jenis file, atau tujuan yang sedang dipilih. Sebut sebuah tujuan dalam permintaan Anda dan agen memakai tujuan itu.

Apakah ini berbayar?

Tidak. Aktar, CLI, dan server MCP gratis. Anda membayar penyedia penyimpanan Anda untuk bucket, seperti biasa.

Apakah bisa dipakai di Windows?

Ya. Perintah aktar bekerja dengan Aktar untuk Windows dengan cara yang sama, begitu juga semua agen di atas.