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.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpFü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.
upload_file{ "path": "~/Desktop/checkout-bug.png" }In dein Ziel Screenshots hochgeladen. Hier ist das Markdown für das Issue:
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.
Installiere den Befehl
aktarund verbinde ihn mit Aktar. Öffne in Aktar Einstellungen → Integrationen, aktiviere Lokale Verbindungen erlauben, kopiere das Token und füge es inaktar loginein.npm install -g @getaktar/cli aktar loginFüge Aktar zu deinem Agenten hinzu. Der Agent startet
aktar mcpvon selbst, wenn er es braucht.Claude Code
Ein Befehl, für jedes Projekt. Prüfe mit
/mcpin Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Ein Befehl; er landet in
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude 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.
| Tool | Was es tut |
|---|---|
upload_file | Lädt eine Datei hoch und gibt ihren Link, Markdown und HTML zurück. Ziel, Name, Ordner und Ablauf sind optional. |
upload_clipboard | Lädt die Datei oder das Bild aus der Zwischenablage hoch. |
replace_file | Schreibt 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_uploads | Durchsucht den Upload-Verlauf. |
list_destinations | Listet Ziele und die Dateitypen auf, für die jedes genutzt wird. |
list_bucket | Listet die Ordner und Dateien eines Buckets auf, auch Dateien, die nicht mit Aktar hochgeladen wurden. |
create_temporary_link | Erstellt einen Link, der nach einer Weile nicht mehr funktioniert (eine Presigned URL). |
get_thumbnail | Zeigt dem Agenten eine Vorschau eines Uploads. Braucht Aktar für Mac 0.13.0 oder Windows 0.6.0. |
list_watched_folders | Listet überwachte Ordner und ihren Status auf. |
get_status | Prüft die Verbindung zu Aktar. |
delete_upload | Lö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
--rootbeschränkt Uploads auf die Ordner, die du nennst. Pfade werden aufgelöst, Symlinks eingeschlossen, ein Link auf~/.sshoder eine.envwoanders wird also abgelehnt. -
Nur lesen, und kein Löschen
--read-onlylässt jedes Tool weg, das schreibt. Löschen aus einem Bucket wird gar nicht angeboten, außer du fügst--allow-deletehinzu. -
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-onlyKein 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.mdVoraussetzungen
- Aktar für Mac oder Windows, laufend, mit mindestens einem Ziel
-
Der Befehl
aktar0.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.