Server MCP
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.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpLalu 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.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Sudah diunggah ke tujuan Screenshots Anda. Ini Markdown untuk issue-nya:
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 yang baru saja saya salin ke README.”
Ia mengunggah gambar, atau isi clipboard, lalu menulis Markdown di tempat yang tepat. Konversi WebP dan penghapusan lokasi dilakukan di Aktar, sesuai pengaturan tujuan.
Alat:
upload_file,upload_clipboard -
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.
Alat:
search_uploads,replace_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_uploads,get_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_bucket,list_destinations
Siapkan dalam dua langkah
Aktar untuk Mac atau Windows yang melakukan pengunggahan, jadi ia harus berjalan di komputer yang sama dengan agen Anda.
Pasang perintah
aktardan hubungkan ke Aktar. Di Aktar, buka Pengaturan > Integrasi, nyalakan Izinkan koneksi lokal dan salin tokennya, lalu tempelkan keaktar login.npm install -g @getaktar/cli aktar loginTambahkan Aktar ke agen Anda. Agen menjalankan
aktar mcpsendiri saat membutuhkannya.Claude Code
Satu perintah, untuk semua proyek. Periksa dengan
/mcpdi Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Satu perintah; hasilnya masuk ke
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude Desktop
Buka Settings > Developer > Edit Config, tambahkan ini, lalu mulai ulang Claude Desktop.
Di claude_desktop_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }Cursor
Tambahkan ini ke file tersebut, atau ke
.cursor/mcp.jsondi satu proyek.Di ~/.cursor/mcp.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }VS Code
Satu perintah menambahkannya ke profil VS Code Anda. Mode agen Copilot lalu menampilkan alat-alat Aktar.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'Windsurf
Tambahkan ini ke file tersebut, lalu segarkan server MCP di pengaturan Windsurf.
Di ~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }
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"] sebagai argumen. Agen lain yang menjalankan server MCP lewat stdio bekerja dengan cara yang sama.
Alat yang didapat agen Anda
Mencari, menampilkan daftar, tautan sementara, dan thumbnail hanya melihat. Mengunggah dan mengganti mengubah bucket Anda, dan agen Anda bertanya dulu sebelum memakainya kecuali Anda mengizinkannya.
| Tool | Fungsinya |
|---|---|
upload_file | Mengunggah file dan mengembalikan tautan, Markdown, dan HTML-nya. Tujuan, nama, folder, dan masa berlaku bersifat opsional. |
upload_clipboard | Mengunggah file atau gambar yang ada di clipboard. |
replace_file | Menimpa unggahan dengan file baru dan mempertahankan tautannya. Memerlukan Aktar untuk Mac 0.14.0 atau Windows 0.7.0. |
search_uploads | Mencari di riwayat unggahan. |
list_destinations | Menampilkan daftar tujuan dan jenis file yang digunakan untuk masing-masing. |
list_bucket | Menampilkan folder dan file di bucket, termasuk file yang tidak diunggah lewat Aktar. |
create_temporary_link | Membuat tautan yang berhenti berfungsi setelah beberapa waktu (presigned URL). |
get_thumbnail | Menampilkan pratinjau sebuah unggahan kepada agen. Memerlukan Aktar untuk Mac 0.13.0 atau Windows 0.6.0. |
list_watched_folders | Menampilkan daftar folder yang dipantau beserta statusnya. |
get_status | Memeriksa koneksi ke Aktar. |
delete_upload | Menghapus 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 berhati-hati secara bawaan dan Anda bisa membatasinya lebih lanjut.
-
Mengunggah berarti mempublikasikan
Agen diperintahkan hanya mengunggah apa yang Anda minta untuk dibagikan, dan agen bertanya dulu sebelum memanggil alat yang mengunggah.
-
Hanya dari folder Anda
--rootmembatasi unggahan ke folder yang Anda sebut. Path diselesaikan, termasuk symlink, sehingga tautan ke~/.sshatau file.envdi tempat lain akan ditolak. -
Hanya baca, dan tanpa menghapus
--read-onlymembuang semua alat yang menulis. Menghapus dari bucket tidak ditawarkan sama sekali kecuali Anda menambahkan--allow-delete. -
Kunci Anda tetap di Aktar
Server berkomunikasi dengan Aktar di 127.0.0.1 memakai token Anda. Agen tidak pernah melihat kunci akses Anda, dan tidak ada yang melewati server kami.
aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-onlyTidak 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.mdPersyaratan
- Aktar untuk Mac atau Windows, sedang berjalan, dengan setidaknya satu tujuan
-
Perintah
aktar0.4.0 atau lebih baru (Node.js 18 atau lebih baru) - 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. Agar yakin, jalankan server dengan --root supaya unggahan hanya bisa berasal dari folder yang Anda sebut, atau dengan --read-only.
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.