Server MCP
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.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpPoi 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.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Caricato sulla tua destinazione Screenshots. Ecco il Markdown per la issue:
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 lo screenshot che ho appena copiato.”
Carica l'immagine, o ciò che c'è negli Appunti, 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,upload_clipboard -
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.
Strumenti:
search_uploads,replace_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_uploads,get_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_bucket,list_destinations
Configura in due passaggi
Il caricamento lo fa Aktar per Mac o Windows, quindi deve essere in esecuzione sullo stesso computer del tuo agente.
Installa il comando
aktare collegalo ad Aktar. In Aktar apri Impostazioni > Integrazioni, attiva Consenti connessioni locali e copia il token, poi incollalo inaktar login.npm install -g @getaktar/cli aktar loginAggiungi Aktar al tuo agente. L'agente avvia
aktar mcpda solo quando serve.Claude Code
Un solo comando, per ogni progetto. Verifica con
/mcpin Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Un solo comando; viene salvato in
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude Desktop
Apri Settings > Developer > Edit Config, aggiungi questo e riavvia Claude Desktop.
In claude_desktop_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }Cursor
Aggiungi questo al file, oppure a
.cursor/mcp.jsonin un singolo progetto.In ~/.cursor/mcp.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }VS Code
Un comando lo aggiunge al tuo profilo di VS Code. La modalità agente di Copilot elenca poi gli strumenti di Aktar.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'Windsurf
Aggiungi questo al file, poi aggiorna i server MCP nelle impostazioni di Windsurf.
In ~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }
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"] come argomenti. Qualsiasi altro agente che esegue server MCP via stdio funziona allo stesso modo.
Gli strumenti che ottiene il tuo agente
Cercare, elencare, creare link temporanei e vedere le miniature sono azioni di sola lettura. Caricare e sostituire modificano il tuo bucket, e il tuo agente chiede conferma prima di usarli, a meno che tu non lo consenta.
| Strumento | Cosa fa |
|---|---|
upload_file | Carica un file e restituisce il suo link, Markdown e HTML. Destinazione, nome, cartella e scadenza sono facoltativi. |
upload_clipboard | Carica il file o l'immagine negli appunti. |
replace_file | Scrive un nuovo file al posto di un caricamento, mantenendone il link. Richiede Aktar per Mac 0.14.0 o Windows 0.7.0. |
search_uploads | Cerca nella cronologia dei caricamenti. |
list_destinations | Elenca le destinazioni e i tipi di file per cui è usata ciascuna. |
list_bucket | Elenca le cartelle e i file di un bucket, compresi quelli non caricati con Aktar. |
create_temporary_link | Crea un link che smette di funzionare dopo un po' (un URL presigned). |
get_thumbnail | Mostra all'agente un'anteprima di un caricamento. Richiede Aktar per Mac 0.13.0 o Windows 0.6.0. |
list_watched_folders | Elenca le cartelle monitorate e il loro stato. |
get_status | Controlla la connessione ad Aktar. |
delete_upload | Elimina 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 è prudente per impostazione predefinita e puoi restringerlo ancora.
-
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.
-
Solo dalle tue cartelle
--rootlimita i caricamenti alle cartelle che indichi. I percorsi vengono risolti, collegamenti simbolici inclusi, quindi un link a~/.ssho a un.envaltrove viene rifiutato. -
Sola lettura e nessuna eliminazione
--read-onlyesclude ogni strumento che scrive. L'eliminazione da un bucket non viene proprio offerta, a meno che tu non aggiunga--allow-delete. -
Le tue chiavi restano in Aktar
Il server comunica con Aktar su 127.0.0.1 usando il tuo token. L'agente non vede mai le tue chiavi di accesso e nulla passa da un nostro server.
aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-onlyNiente 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.mdRequisiti
- Aktar per Mac o Windows, in esecuzione, con almeno una destinazione
-
Il comando
aktar0.4.0 o successivo (Node.js 18 o successivo) - 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. Per stare tranquillo, avvia il server con --root così si può caricare solo dalle cartelle che indichi, oppure con --read-only.
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.