MCP-Server

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.

1CLI installieren
npm install -g @getaktar/cli
2Zu Claude Code hinzufügen
claude mcp add --scope user aktar -- aktar mcp

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

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

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

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 Screenshot, den ich gerade kopiert habe, in die README ein.”

    Er lädt das Bild oder den Inhalt der Zwischenablage 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, upload_clipboard

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

    Tools: search_uploads, replace_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_uploads, get_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_bucket, list_destinations

In zwei Schritten einrichten

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

  1. 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
  2. Füge Aktar zu deinem Agenten hinzu. Der Agent startet aktar mcp von selbst, wenn er es braucht.

    Claude Code

    Ein Befehl, für jedes Projekt. Prüfe mit /mcp in Claude Code.

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

    Codex

    Ein Befehl; er landet in ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude Desktop

    Öffne Settings > Developer > Edit Config, füge das hier ein und starte Claude Desktop neu.

    In claude_desktop_config.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

    Cursor

    Füge das der Datei hinzu, oder in einem Projekt der .cursor/mcp.json.

    In ~/.cursor/mcp.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

    VS Code

    Ein Befehl fügt es deinem VS-Code-Profil hinzu. Der Agent-Modus von Copilot listet dann die Tools von Aktar auf.

    code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'

    Windsurf

    Füge das der Datei hinzu und aktualisiere dann die MCP-Server in den Einstellungen von Windsurf.

    In ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "aktar": { "command": "aktar", "args": ["mcp"] }
      }
    }

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"] als Argumente. Jeder andere Agent, der MCP-Server über stdio ausführt, funktioniert genauso.

Tools, die dein Agent bekommt

Suchen, Auflisten, temporäre Links und Vorschaubilder schauen nur. Hochladen und Ersetzen verändern deinen Bucket, und dein Agent fragt vorher nach, es sei denn, du erlaubst es.

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.
upload_clipboardLädt die Datei oder das Bild aus der Zwischenablage hoch.
replace_fileSchreibt eine neue Datei über einen Upload und behält seinen Link. Braucht Aktar für Mac 0.14.0 oder Windows 0.7.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).
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 ist der Server standardmäßig vorsichtig, und du kannst ihn weiter einschränken.

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

  • Nur aus deinen Ordnern

    --root beschränkt Uploads auf die Ordner, die du nennst. Pfade werden aufgelöst, Symlinks eingeschlossen, ein Link auf ~/.ssh oder eine .env woanders wird also abgelehnt.

  • Nur lesen, und kein Löschen

    --read-only lässt jedes Tool weg, das schreibt. Löschen aus einem Bucket wird gar nicht angeboten, außer du fügst --allow-delete hinzu.

  • Deine Schlüssel bleiben in Aktar

    Der Server spricht mit Aktar auf 127.0.0.1 mit deinem Token. Der Agent sieht nie deine Zugriffsschlüssel, und nichts läuft über einen Server von uns.

aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-only

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)
  • 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. Um sicherzugehen, starte den Server mit --root, damit nur aus den Ordnern hochgeladen werden kann, die du nennst, oder mit --read-only.

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.