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.

1Installa la CLI
npm install -g @getaktar/cli
2Aggiungilo a Claude Code
claude mcp add --scope user aktar -- aktar mcp

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

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

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

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.

  1. 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
  2. Aggiungi Aktar al tuo agente. L'agente avvia aktar mcp da solo quando serve.

    Claude Code

    Un solo comando, per ogni progetto. Verifica con /mcp in Claude Code.

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

    Codex

    Un solo comando; viene salvato in ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

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

StrumentoCosa fa
upload_fileCarica un file e restituisce il suo link, Markdown e HTML. Destinazione, nome, cartella e scadenza sono facoltativi.
upload_clipboardCarica il file o l'immagine negli appunti.
replace_fileScrive un nuovo file al posto di un caricamento, mantenendone il link. Richiede Aktar per Mac 0.14.0 o Windows 0.7.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).
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 è 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

    --root limita i caricamenti alle cartelle che indichi. I percorsi vengono risolti, collegamenti simbolici inclusi, quindi un link a ~/.ssh o a un .env altrove viene rifiutato.

  • Sola lettura e nessuna eliminazione

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

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