MCP-server

Laat je AI-agent bestanden delen vanuit je eigen bucket

aktar mcp koppelt Claude, Cursor, VS Code, Codex en andere agents aan de Aktar-app. Vraag om een link en de agent uploadt het bestand naar je eigen S3-, Cloudflare R2- of Backblaze B2-bucket en geeft je de URL of Markdown. Je opslagsleutels verlaten Aktar nooit.

1Installeer de CLI
npm install -g @getaktar/cli
2Voeg het toe aan Claude Code
claude mcp add --scope user aktar -- aktar mcp

Voer daarna één keer aktar login uit. Cursor, VS Code, Codex en andere staan hieronder.

Upload de screenshot checkout-bug op mijn bureaublad en geef me een Markdown-link voor het issue.

Aktar aangeroepenupload_file{ "path": "~/Desktop/checkout-bug.png" }

Geüpload naar je bestemming Screenshots. Hier is de Markdown voor het issue:

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

Wat je kunt vragen

Zeg het zoals je het tegen een collega zou zeggen. De agent kiest de tool, Aktar doet de upload met de eigen instellingen van de bestemming en je krijgt de link in het gesprek.

  • Een bestand delen tijdens een sessie

    “Zip de build en geef me een link die ik naar QA kan sturen.”

    De agent maakt het bestand en uploadt het. Noem je geen bestemming, dan kiest Aktar er een op bestandstype (de instelling Gebruiken voor van elke bestemming), net als bij een bestand dat je op de menubalk laat vallen.

    Tools: upload_file

  • Afbeeldingen voor een README of een issue

    “Voeg de screenshot die ik net heb gekopieerd toe aan de README.”

    Het uploadt de afbeelding, of wat er op het klembord staat, en schrijft de Markdown op de juiste plek. WebP-conversie en het verwijderen van locatiegegevens gebeuren in Aktar, zoals de bestemming bepaalt.

    Tools: upload_file, upload_clipboard

  • Een bestand bijwerken, de link behouden

    “Vervang de onboarding-pdf die ik vorige week heb gedeeld door deze nieuwe versie.”

    Het zoekt de upload op in de geschiedenis en schrijft het nieuwe bestand eroverheen. Iedereen met de link ziet de nieuwe versie; er hoeft niets opnieuw verstuurd te worden.

    Tools: search_uploads, replace_file

  • Vind wat je hebt geüpload

    “Wat was de link naar de factuur die ik maandag heb geüpload?”

    Het zoekt in de geschiedenis van Aktar op naam en datum en kan naar miniaturen kijken om screenshots, foto's en documenten uit elkaar te houden.

    Tools: search_uploads, get_thumbnail

  • Een link die verloopt

    “Geef me een link van 30 minuten naar het contract in de bucket Legal.”

    Een vooraf ondertekende link naar elk bestand in een bucket, voor privébuckets of om maar beperkte tijd te delen. Er verandert niets in de bucket.

    Tools: create_temporary_link

  • Kijk rond in je buckets

    “Wat staat er in de map releases van mijn bucket Builds?”

    Het toont mappen en bestanden, ook die niet met Aktar zijn geüpload, en weet welke bestemming voor welke bestandstypen wordt gebruikt.

    Tools: list_bucket, list_destinations

In twee stappen ingesteld

Aktar voor Mac of Windows doet het uploaden, dus het moet draaien op dezelfde computer als je agent.

  1. Installeer het commando aktar en verbind het met Aktar. Open in Aktar Instellingen > Integraties, zet Sta lokale verbindingen toe aan en kopieer het token. Plak het daarna in aktar login.

    npm install -g @getaktar/cli
    aktar login
  2. Voeg Aktar toe aan je agent. De agent start aktar mcp zelf wanneer hij het nodig heeft.

    Claude Code

    Eén commando, voor elk project. Controleer het met /mcp in Claude Code.

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

    Codex

    Eén commando; het komt in ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude Desktop

    Open Settings > Developer > Edit Config, voeg dit toe en start Claude Desktop opnieuw op.

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

    Cursor

    Voeg dit toe aan het bestand, of aan .cursor/mcp.json in één project.

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

    VS Code

    Eén commando voegt het toe aan je VS Code-profiel. De agentmodus van Copilot toont daarna de tools van Aktar.

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

    Windsurf

    Voeg dit toe aan het bestand en ververs daarna de MCP-servers in de instellingen van Windsurf.

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

Zegt een app dat hij aktar niet kan vinden, zet dan het volledige pad uit which aktar in command; desktop-apps laden de PATH van je shell niet altijd. Zonder globale installatie gebruik je npx als commando en ["-y", "@getaktar/cli", "mcp"] als argumenten. Elke andere agent die MCP-servers via stdio draait, werkt op dezelfde manier.

Tools die je agent krijgt

Zoeken, opsommen, tijdelijke links en miniaturen kijken alleen. Uploaden en vervangen wijzigen je bucket, en je agent vraagt eerst toestemming voordat hij ze gebruikt, tenzij je dat toestaat.

ToolWat het doet
upload_fileUploadt een bestand en geeft de link, Markdown en HTML terug. Bestemming, naam, map en vervaltijd zijn optioneel.
upload_clipboardUploadt het bestand of de afbeelding op het klembord.
replace_fileSchrijft een nieuw bestand over een upload heen en behoudt de link. Vereist Aktar voor Mac 0.14.0 of Windows 0.7.0.
search_uploadsDoorzoekt de uploadgeschiedenis.
list_destinationsToont de bestemmingen en voor welke bestandstypen elke bestemming wordt gebruikt.
list_bucketToont de mappen en bestanden van een bucket, ook bestanden die niet met Aktar zijn geüpload.
create_temporary_linkMaakt een link die na een tijdje niet meer werkt (een presigned URL).
get_thumbnailToont de agent een voorbeeld van een upload. Vereist Aktar voor Mac 0.13.0 of Windows 0.6.0.
list_watched_foldersToont de bewaakte mappen en hun status.
get_statusControleert de verbinding met Aktar.
delete_uploadVerwijdert een upload uit zijn bucket. Alleen met --allow-delete.

Jij bepaalt waar het aan mag komen

Een upload is openbaar voor iedereen met de link, dus de server is standaard voorzichtig en je kunt hem verder beperken.

  • Uploaden is publiceren

    De agent krijgt de opdracht alleen te uploaden wat jij wilt delen, en agents vragen toestemming voordat ze een tool aanroepen die uploadt.

  • Alleen uit je eigen mappen

    --root beperkt uploads tot de mappen die je opgeeft. Paden worden uitgewerkt, symbolische links inbegrepen, dus een link naar ~/.ssh of een .env elders wordt geweigerd.

  • Alleen-lezen, en niets verwijderen

    --read-only laat elke tool weg die schrijft. Verwijderen uit een bucket wordt helemaal niet aangeboden, tenzij je --allow-delete toevoegt.

  • Je sleutels blijven in Aktar

    De server praat met Aktar op 127.0.0.1 met je token. De agent ziet je toegangssleutels nooit en er gaat niets via een server van ons.

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

Geen MCP? Gebruik de skill

Voor agents die wel skills gebruiken maar geen MCP, drukt aktar skill een SKILL.md af die ze het commando aktar leert: wat ze moeten uitvoeren, hoe ze --json lezen en dat ze alleen uploaden wat jij hebt gevraagd. Alle commando's staan in de CLI-documentatie.

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

Vereisten

  • Aktar voor Mac of Windows, draaiend, met minstens één bestemming
  • Het commando aktar 0.4.0 of nieuwer (Node.js 18 of nieuwer)
  • Een agent die MCP-servers via stdio draait
  • Bestanden vervangen: Aktar voor Mac 0.14.0 of Windows 0.7.0. Miniaturen: Mac 0.13.0 of Windows 0.6.0
  • Open source (MIT) op GitHub, vermeld in het officiële MCP Registry

Vragen

Werkt het met ChatGPT of andere agents in de browser?

Nog niet. De server draait op je computer naast Aktar en praat via stdio met agents, dus het werkt met agents die op je computer draaien: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf en andere.

Kan de agent bestanden uploaden waar ik niet om heb gevraagd?

Hij kan alleen de tools aanroepen die je toestaat, en agents vragen toestemming voordat ze een tool aanroepen die uploadt, tenzij je anders hebt aangegeven. Wil je zeker zijn, start de server dan met --root zodat alleen uit de mappen die je opgeeft geüpload kan worden, of met --read-only.

Naar welke bucket uploadt het?

Dezelfde als bij een bestand dat je op de menubalk van Aktar laat vallen: de bestemming waarvan Gebruiken voor overeenkomt met het bestandstype, of de geselecteerde. Noem een bestemming in je verzoek en de agent gebruikt die.

Kost het iets?

Nee. Aktar, de CLI en de MCP-server zijn gratis. Je betaalt je opslagprovider voor de bucket, zoals gewoonlijk.

Werkt het op Windows?

Ja. Het commando aktar werkt op dezelfde manier met Aktar voor Windows, en dat geldt ook voor elke agent hierboven.