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.

1Pasang CLI
npm install -g @getaktar/cli
2Tambahkan ke Claude Code
claude mcp add --scope user aktar -- aktar mcp

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 Aktarupload_file{ "path": "~/Desktop/checkout-bug.png" }

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

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

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.

  1. 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
  2. Tambahkan Aktar ke agen Anda. Agen menjalankan aktar mcp sendiri saat membutuhkannya.

    Claude Code

    Satu perintah, untuk semua proyek. Periksa dengan /mcp di Claude Code.

    claude mcp add --scope user aktar -- aktar mcp

    Codex

    Satu perintah; hasilnya masuk ke ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude 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.json di 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.

ToolFungsinya
upload_fileMengunggah file dan mengembalikan tautan, Markdown, dan HTML-nya. Tujuan, nama, folder, dan masa berlaku bersifat opsional.
upload_clipboardMengunggah file atau gambar yang ada di clipboard.
replace_fileMenimpa unggahan dengan file baru dan mempertahankan tautannya. Memerlukan Aktar untuk Mac 0.14.0 atau Windows 0.7.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).
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 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

    --root membatasi unggahan ke folder yang Anda sebut. Path diselesaikan, termasuk symlink, sehingga tautan ke ~/.ssh atau file .env di tempat lain akan ditolak.

  • Hanya baca, dan tanpa menghapus

    --read-only membuang 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-only

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)
  • 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.