• MCP-Server
  • aktar v0.6.0

Dein KI-Agent teilt Dateien aus deinem eigenen Bucket

aktar mcp verbindet Claude, Cursor, VS Code, Codex und andere Agenten mit der Aktar-App. Bitte um einen Link, und der Agent lädt die Datei in deinen eigenen S3-, Cloudflare-R2- oder Backblaze-B2-Bucket hoch und gibt dir die URL oder das Markdown. Deine Speicher-Schlüssel verlassen Aktar nie.

Führe dann einmal aktar login aus. Cursor, VS Code, Codex und weitere stehen unten.

Lade den Checkout-Bug-Screenshot von meinem Schreibtisch hoch und gib mir einen Markdown-Link für das Issue.

Aktar aufgerufen · upload_file

In dein Ziel Screenshots hochgeladen. Hier ist das Markdown für das Issue:

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

In zwei Schritten einrichten

Aktar für Mac oder Windows übernimmt das Hochladen, deshalb muss es auf demselben Computer laufen wie dein Agent.

SCHRITT 01

Installiere den Befehl aktar und verbinde ihn mit Aktar. Öffne in Aktar Einstellungen → Integrationen, aktiviere Lokale Verbindungen erlauben, kopiere das Token und füge es in aktar login ein.

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

Füge Aktar zu deinem Agenten hinzu, mit dem Ordner, aus dem er Dateien hochladen darf, hinter --root (für weitere Ordner wiederholen). Der Agent startet aktar mcp von selbst, wenn er es braucht.

Claude Code

Ein Befehl, für jedes Projekt. Ersetze ~/Projects durch den Ordner, in dem deine Arbeit liegt. Prüfe mit /mcp in Claude Code.

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

Wenn eine App meldet, dass sie aktar nicht findet, trage den vollständigen Pfad aus which aktar bei command ein; Desktop-Apps laden den PATH deiner Shell nicht immer. Ohne globale Installation nimmst du npx als Befehl und ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] als Argumente. Ersetze /Users/you/Projects durch deinen eigenen Ordner (unter Windows etwa C:\\Users\\you\\Projects). Ohne --root kommen Dateien nur aus dem Ordner, in dem der Agent den Server startet, und gar keine, wenn das dein Benutzerordner oder die oberste Ebene der Festplatte ist, wie oft bei Desktop-Apps. Jeder andere Agent, der MCP-Server über stdio ausführt, funktioniert genauso.

Was du fragen kannst

Sag es so, wie du es einem Kollegen sagen würdest. Der Agent wählt das Tool, Aktar lädt mit den eigenen Einstellungen des Ziels hoch, und du bekommst den Link im Gespräch.

  • Eine Datei aus einer Sitzung teilen

    “Zippe den Build und gib mir einen Link, den ich an QA schicken kann.”

    Der Agent erstellt die Datei und lädt sie hoch. Ohne genanntes Ziel wählt Aktar eines nach Dateityp (Verwenden für jedes Ziels), wie bei einem Drop auf die Menüleiste.

    Tools:upload_file

  • Bilder für eine README oder ein Issue

    “Füge den neuen Screenshot aus docs/images in die README ein.”

    Er lädt das Bild hoch und schreibt das Markdown an die richtige Stelle. WebP-Konvertierung und das Entfernen von Standortdaten erledigt Aktar, wie es das Ziel vorgibt.

    Tools:upload_file

  • Eine Datei aktualisieren, den Link behalten

    “Ersetze das Onboarding-PDF, das ich letzte Woche geteilt habe, durch diese neue Version.”

    Er findet den Upload im Verlauf und überschreibt ihn mit der neuen Datei. Alle mit dem Link sehen die neue Version; nichts muss erneut verschickt werden. Ersetzen überschreibt die alte Datei, deshalb braucht es --allow-replace.

    Tools:search_uploadsreplace_file

  • Finden, was du hochgeladen hast

    “Wie lautete der Link zur Rechnung, die ich am Montag hochgeladen habe?”

    Er durchsucht den Verlauf von Aktar nach Name und Datum und kann sich Vorschaubilder ansehen, um Screenshots, Fotos und Dokumente zu unterscheiden.

    Tools:search_uploadsget_thumbnail

  • Ein Link, der abläuft

    “Gib mir einen 30-Minuten-Link zum Vertrag im Legal-Bucket.”

    Ein Presigned-Link zu jeder Datei in einem Bucket, für private Buckets oder zeitlich begrenztes Teilen. Im Bucket ändert sich nichts.

    Tools:create_temporary_link

  • Deine Buckets durchstöbern

    “Was liegt im Ordner releases meines Builds-Buckets?”

    Er listet Ordner und Dateien auf, auch solche, die nicht mit Aktar hochgeladen wurden, und weiß, welches Ziel für welche Dateitypen genutzt wird.

    Tools:list_bucketlist_destinations

Schritt für Schritt für dein KI-Tool

Ein fertiges Plugin oder eine Konfiguration zum Kopieren, dazu, was du fragen kannst, sobald alles eingerichtet ist.

Gelistet bei:Official MCP RegistryGlamamcpservers.org

Tools, die dein Agent bekommt

Suchen, Auflisten, temporäre Links und Vorschaubilder schauen nur. Hochladen verändert deinen Bucket, und dein Agent fragt vorher nach, es sei denn, du erlaubst es. Ersetzen und Löschen werden nur angeboten, wenn du sie einschaltest.

ToolWas es tut
upload_fileLädt eine Datei hoch und gibt ihren Link, Markdown und HTML zurück. Ziel, Name, Ordner und Ablauf sind optional. short verlangt einen Kurzlink oder keinen.
upload_clipboardLädt die Datei oder das Bild aus der Zwischenablage hoch. short verlangt einen Kurzlink oder keinen. Fehlt, wenn --root angegeben ist.
replace_fileSchreibt eine neue Datei über einen Upload oder eine beliebige Datei in einem Bucket und behält ihren Link. Nur mit --allow-replace oder --allow-delete. Braucht Aktar für Mac 0.14.0 oder Windows 0.7.0.
create_short_linkErstellt mit dem Linkkürzer des Ziels einen Kurzlink für einen Upload oder gibt den vorhandenen zurück. Fehlt mit --read-only. Braucht Aktar für Mac 0.17.0 oder Windows 0.10.0.
search_uploadsDurchsucht den Upload-Verlauf.
list_destinationsListet Ziele und die Dateitypen auf, für die jedes genutzt wird.
list_bucketListet die Ordner und Dateien eines Buckets auf, auch Dateien, die nicht mit Aktar hochgeladen wurden.
create_temporary_linkErstellt einen Link, der nach einer Weile nicht mehr funktioniert (eine Presigned URL). Bis dahin kann jeder mit dem Link die Datei herunterladen, auch aus einem privaten Bucket. Höchstens 60 Minuten, sofern --max-link-minutes nicht mehr erlaubt.
get_thumbnailZeigt dem Agenten eine Vorschau eines Uploads. Braucht Aktar für Mac 0.13.0 oder Windows 0.6.0.
list_watched_foldersListet überwachte Ordner und ihren Status auf.
get_statusPrüft die Verbindung zu Aktar.
delete_uploadLöscht einen Upload aus seinem Bucket. Nur mit --allow-delete.

Du entscheidest, was er anfassen darf

Ein Upload ist für jeden mit dem Link öffentlich, deshalb startet der Server mit wenig, und du entscheidest, was dazukommt.

  • Hochladen heißt veröffentlichen

    Dem Agenten wird gesagt, nur das hochzuladen, was du teilen wolltest, und Agenten fragen nach, bevor sie ein Tool aufrufen, das hochlädt. --log protokolliert jeden Tool-Aufruf, damit du später sehen kannst, was ein Agent getan hat.
  • Nur aus deinen Ordnern, nie Geheimnisse

    Dateien kommen nur aus den Ordnern, die du mit --root nennst, oder aus dem Ordner, in dem der Agent den Server startet, nie versehentlich aus deinem ganzen Benutzerordner. SSH- und private Schlüssel, .env-Dateien, Cloud-Zugangsdaten, Browserprofile und Passwortdatenbanken werden abgelehnt, egal wo sie liegen, Symlinks eingeschlossen.
  • Nichts wird überschrieben, außer du willst es

    Das Ersetzen einer Datei wird nur mit --allow-replace angeboten, das Löschen nur mit --allow-delete. --read-only lässt jedes Tool weg, das schreibt. Temporäre Links gelten höchstens 60 Minuten, sofern --max-link-minutes nicht mehr erlaubt.
  • Deine Schlüssel bleiben in Aktar

    Der Server spricht mit Aktar auf 127.0.0.1 und prüft, ob es wirklich Aktar ist, bevor er dein Token sendet. Der Agent sieht nie deine Zugriffsschlüssel, und nichts läuft über einen Server von uns.
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

Kein MCP? Nutze den Skill

Für Agenten, die Skills, aber kein MCP nutzen, gibt aktar skill eine SKILL.md aus, die ihnen den Befehl aktar beibringt: was sie ausführen, wie sie --json lesen und dass sie nur hochladen, was du verlangt hast. Jeder Befehl steht in der CLI-Doku.

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

Voraussetzungen

  • Aktar für Mac oder Windows, laufend, mit mindestens einem Ziel
  • Der Befehl aktar 0.4.0 oder neuer (Node.js 18 oder neuer). aktar 0.6.0 und neuer brauchen Aktar für Mac 0.18.0 oder Windows 0.11.0
  • Ein Agent, der MCP-Server über stdio ausführt
  • Dateien ersetzen: Aktar für Mac 0.14.0 oder Windows 0.7.0. Vorschaubilder: Mac 0.13.0 oder Windows 0.6.0
  • Open Source (MIT) auf GitHub, im offiziellen MCP Registry gelistet

Fragen

Funktioniert es mit ChatGPT oder anderen Agenten im Browser?

Noch nicht. Der Server läuft auf deinem Computer neben Aktar und spricht über stdio mit Agenten, funktioniert also mit Agenten, die auf deinem Computer laufen: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf und andere.

Kann der Agent Dateien hochladen, um die ich nicht gebeten habe?

Er kann nur die Tools aufrufen, die du erlaubst, und Agenten fragen nach, bevor sie ein Tool aufrufen, das hochlädt, außer du hast etwas anderes gesagt. Dateien kommen nur aus den Ordnern, die du mit --root angibst (oder aus dem Ordner, in dem der Agent ihn startet), und Geheimnisse wie SSH-Schlüssel und .env-Dateien werden nie hochgeladen. --read-only schaltet das Hochladen aus, und --log zeigt dir hinterher, was aufgerufen wurde.

In welchen Bucket lädt er hoch?

In denselben wie bei einem Drop auf die Menüleiste von Aktar: das Ziel, dessen Verwenden für zum Dateityp passt, oder das ausgewählte. Nenne in deiner Anfrage ein Ziel, und der Agent nutzt dieses.

Kostet es etwas?

Nein. Aktar, die CLI und der MCP-Server sind kostenlos. Du bezahlst wie gewohnt deinen Speicheranbieter für den Bucket.

Funktioniert es unter Windows?

Ja. Der Befehl aktar funktioniert mit Aktar für Windows genauso, und alle oben genannten Agenten auch.