• Server MCP
  • aktar v0.6.0

Lascia che il tuo agente AI condivida file dal tuo bucket

aktar mcp collega Claude, Cursor, VS Code, Codex e altri agenti all'app Aktar. Chiedi un link e l'agente carica il file sul tuo bucket S3, Cloudflare R2 o Backblaze B2, poi ti restituisce l'URL o il Markdown. Le chiavi del tuo storage non escono mai da Aktar.

Poi esegui aktar login una volta. Cursor, VS Code, Codex e altri sono qui sotto.

Carica lo screenshot checkout-bug che ho sulla scrivania e dammi un link Markdown per la issue.

Aktar chiamato · upload_file

Caricato sulla tua destinazione Screenshots. Ecco il Markdown per la issue:

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

Configura in due passaggi

Il caricamento lo fa Aktar per Mac o Windows, quindi deve essere in esecuzione sullo stesso computer del tuo agente.

PASSO 01

Installa il comando aktar e collegalo ad Aktar. In Aktar apri Impostazioni > Integrazioni, attiva Consenti connessioni locali e copia il token, poi incollalo in aktar login.

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

Aggiungi Aktar al tuo agente, con la cartella da cui può caricare file dopo --root (ripetilo per altre cartelle). L'agente avvia aktar mcp da solo quando serve.

Claude Code

Un solo comando, per ogni progetto. Sostituisci ~/Projects con la cartella in cui si trova il tuo lavoro. Verifica con /mcp in Claude Code.

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

Se un'app dice di non trovare aktar, inserisci in command il percorso completo restituito da which aktar: le app desktop non sempre caricano il PATH della tua shell. Senza un'installazione globale, usa npx come comando e ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] come argomenti. Sostituisci /Users/you/Projects con la tua cartella (su Windows, ad esempio C:\\Users\\you\\Projects). Senza --root, i file arrivano solo dalla cartella in cui l'agente avvia il server, e da nessuna se è la tua cartella Inizio o la radice del disco, come accade spesso con le app desktop. Qualsiasi altro agente che esegue server MCP via stdio funziona allo stesso modo.

Cosa puoi chiedere

Dillo come lo diresti a un collega. L'agente sceglie lo strumento, Aktar esegue il caricamento con le impostazioni della destinazione e ricevi il link nella conversazione.

  • Condividi un file durante una sessione

    “Comprimi la build in uno zip e dammi un link da mandare al QA.”

    L'agente crea il file e lo carica. Se non indichi una destinazione, Aktar ne sceglie una in base al tipo di file (l'opzione Usa per di ogni destinazione), come per un file trascinato sulla barra dei menu.

    Strumenti:upload_file

  • Immagini per un README o una issue

    “Aggiungi al README il nuovo screenshot in docs/images.”

    Carica l'immagine e scrive il Markdown dove serve. La conversione in WebP e la rimozione della posizione avvengono in Aktar, come stabilisce la destinazione.

    Strumenti:upload_file

  • Aggiorna un file, mantieni il suo link

    “Sostituisci il PDF di onboarding che ho condiviso la settimana scorsa con questa nuova versione.”

    Trova il caricamento nella cronologia e ci scrive sopra il nuovo file. Chiunque abbia il link vede la nuova versione: non serve rimandare nulla. La sostituzione sovrascrive il vecchio file, quindi richiede --allow-replace.

    Strumenti:search_uploadsreplace_file

  • Ritrova ciò che hai caricato

    “Qual era il link della fattura che ho caricato lunedì?”

    Cerca nella cronologia di Aktar per nome e data e può guardare le miniature per distinguere screenshot, foto e documenti.

    Strumenti:search_uploadsget_thumbnail

  • Un link che scade

    “Dammi un link di 30 minuti al contratto nel bucket Legal.”

    Un link prefirmato a qualsiasi file di un bucket, per bucket privati o per condividere solo per un periodo limitato. Nel bucket non cambia nulla.

    Strumenti:create_temporary_link

  • Dai un'occhiata ai tuoi bucket

    “Cosa c'è nella cartella releases del mio bucket Builds?”

    Elenca cartelle e file, anche quelli non caricati con Aktar, e sa quale destinazione viene usata per quali tipi di file.

    Strumenti:list_bucketlist_destinations

Passo passo per il tuo strumento AI

Un plugin pronto all'uso o una configurazione da copiare, con cosa chiedere una volta configurato.

Presente su:Official MCP RegistryGlamamcpservers.org

Gli strumenti che ottiene il tuo agente

Cercare, elencare, creare link temporanei e vedere le miniature sono azioni di sola lettura. Caricare modifica il tuo bucket, e il tuo agente chiede conferma prima di farlo, a meno che tu non lo consenta. Sostituire ed eliminare vengono offerti solo se li attivi.

StrumentoCosa fa
upload_fileCarica un file e restituisce il suo link, Markdown e HTML. Destinazione, nome, cartella e scadenza sono facoltativi. short chiede un link breve, o nessuno.
upload_clipboardCarica il file o l'immagine negli appunti. short chiede un link breve, o nessuno. Escluso quando è indicato --root.
replace_fileScrive un nuovo file al posto di un caricamento o di qualsiasi file in un bucket, mantenendone il link. Solo con --allow-replace o --allow-delete. Richiede Aktar per Mac 0.14.0 o Windows 0.7.0.
create_short_linkCrea un link breve per un caricamento con l'accorciatore della sua destinazione, o restituisce quello che ha già. Escluso con --read-only. Richiede Aktar per Mac 0.17.0 o Windows 0.10.0.
search_uploadsCerca nella cronologia dei caricamenti.
list_destinationsElenca le destinazioni e i tipi di file per cui è usata ciascuna.
list_bucketElenca le cartelle e i file di un bucket, compresi quelli non caricati con Aktar.
create_temporary_linkCrea un link che smette di funzionare dopo un po' (un URL presigned). Fino ad allora chiunque lo abbia può scaricare il file, anche da un bucket privato. Al massimo 60 minuti, a meno che --max-link-minutes non consenta di più.
get_thumbnailMostra all'agente un'anteprima di un caricamento. Richiede Aktar per Mac 0.13.0 o Windows 0.6.0.
list_watched_foldersElenca le cartelle monitorate e il loro stato.
get_statusControlla la connessione ad Aktar.
delete_uploadElimina un caricamento dal suo bucket. Solo con --allow-delete.

Decidi tu cosa può toccare

Un file caricato è pubblico per chiunque abbia il link, quindi il server parte con poco e decidi tu cosa aggiungere.

  • Caricare significa pubblicare

    All'agente viene detto di caricare solo ciò che hai chiesto di condividere, e gli agenti chiedono conferma prima di chiamare uno strumento che carica. --log tiene traccia di ogni chiamata di strumento, così puoi vedere in seguito cosa ha fatto un agente.
  • Solo dalle tue cartelle, mai segreti

    I file arrivano solo dalle cartelle che indichi con --root, o dalla cartella in cui l'agente avvia il server, mai da tutta la tua cartella Inizio per errore. Chiavi SSH e private, file .env, credenziali cloud, profili del browser e database di password vengono rifiutati ovunque si trovino, collegamenti simbolici inclusi.
  • Niente viene sovrascritto senza il tuo permesso

    La sostituzione di un file viene offerta solo con --allow-replace e l'eliminazione solo con --allow-delete. --read-only esclude ogni strumento che scrive. I link temporanei durano al massimo 60 minuti, a meno che --max-link-minutes non consenta di più.
  • Le tue chiavi restano in Aktar

    Il server comunica con Aktar su 127.0.0.1 e verifica che sia davvero Aktar prima di inviare il tuo token. L'agente non vede mai le tue chiavi di accesso e nulla passa da un nostro server.
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

Niente MCP? Usa la skill

Per gli agenti che usano le skill ma non MCP, aktar skill stampa un SKILL.md che insegna loro il comando aktar: cosa eseguire, come leggere --json e di caricare solo ciò che hai chiesto. Tutti i comandi sono nella documentazione della CLI.

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

Requisiti

  • Aktar per Mac o Windows, in esecuzione, con almeno una destinazione
  • Il comando aktar 0.4.0 o successivo (Node.js 18 o successivo). aktar 0.6.0 e successivi richiedono Aktar per Mac 0.18.0 o Windows 0.11.0
  • Un agente che esegue server MCP via stdio
  • Sostituire i file: Aktar per Mac 0.14.0 o Windows 0.7.0. Miniature: Mac 0.13.0 o Windows 0.6.0
  • Open source (MIT) su GitHub, presente nel MCP Registry ufficiale

Domande

Funziona con ChatGPT o con altri agenti nel browser?

Non ancora. Il server gira sul tuo computer accanto ad Aktar e parla con gli agenti via stdio, quindi funziona con gli agenti che girano sul tuo computer: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf e altri.

L'agente può caricare file che non ho chiesto?

Può chiamare solo gli strumenti che consenti, e gli agenti chiedono conferma prima di chiamare uno strumento che carica, a meno che tu non abbia detto diversamente. I file arrivano solo dalle cartelle che indichi con --root (o dalla cartella in cui l'agente lo avvia), e i segreti come le chiavi SSH e i file .env non vengono mai caricati. --read-only disattiva il caricamento, e --log ti mostra in seguito cosa è stato chiamato.

Su quale bucket carica?

Lo stesso di un file trascinato sulla barra dei menu di Aktar: la destinazione il cui Usa per corrisponde al tipo di file, oppure quella selezionata. Indica una destinazione nella tua richiesta e l'agente usa quella.

Ha un costo?

No. Aktar, la CLI e il server MCP sono gratuiti. Paghi il tuo provider di storage per il bucket, come sempre.

Funziona su Windows?

Sì. Il comando aktar funziona allo stesso modo con Aktar per Windows, e lo stesso vale per tutti gli agenti qui sopra.