Serwer MCP

Pozwól agentowi AI udostępniać pliki z Twojego bucketu

aktar mcp łączy Claude, Cursor, VS Code, Codex i innych agentów z aplikacją Aktar. Poproś o link, a agent prześle plik do Twojego bucketu S3, Cloudflare R2 lub Backblaze B2 i poda Ci URL albo Markdown. Klucze do Twojego magazynu nigdy nie opuszczają Aktara.

1Zainstaluj CLI
npm install -g @getaktar/cli
2Dodaj do Claude Code
claude mcp add --scope user aktar -- aktar mcp

Potem uruchom raz aktar login. Cursor, VS Code, Codex i inne są poniżej.

Prześlij zrzut ekranu checkout-bug z mojego Pulpitu i daj mi link w Markdown do zgłoszenia.

Wywołano Aktarupload_file{ "path": "~/Desktop/checkout-bug.png" }

Przesłano do Twojego miejsca docelowego Screenshots. Oto Markdown do zgłoszenia:

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

O co możesz poprosić

Powiedz to tak, jak powiedziałbyś koledze. Agent wybiera narzędzie, Aktar przesyła plik z ustawieniami miejsca docelowego, a link dostajesz w rozmowie.

  • Udostępnij plik w trakcie sesji

    “Spakuj build do zipa i daj mi link, który wyślę do QA.”

    Agent tworzy plik i go przesyła. Jeśli nie wskażesz miejsca docelowego, Aktar wybierze je według typu pliku (opcja Używaj dla każdego miejsca docelowego), tak jak przy upuszczeniu pliku na pasku menu.

    Narzędzia: upload_file

  • Obrazy do README lub zgłoszenia

    “Dodaj do README zrzut ekranu, który przed chwilą skopiowałem.”

    Przesyła obraz lub to, co jest w schowku, i wpisuje Markdown we właściwe miejsce. Konwersja do WebP i usuwanie lokalizacji odbywają się w Aktarze, zgodnie z ustawieniami miejsca docelowego.

    Narzędzia: upload_file, upload_clipboard

  • Zaktualizuj plik, zachowaj link

    “Zastąp PDF z onboardingiem, który udostępniłem w zeszłym tygodniu, tą nową wersją.”

    Znajduje przesłany plik w historii i zapisuje nowy plik w jego miejsce. Każdy, kto ma link, widzi nową wersję, więc nic nie trzeba wysyłać ponownie.

    Narzędzia: search_uploads, replace_file

  • Znajdź to, co przesłałeś

    “Jaki był link do faktury, którą przesłałem w poniedziałek?”

    Przeszukuje historię Aktara po nazwie i dacie, a miniatury pozwalają mu odróżnić zrzuty ekranu, zdjęcia i dokumenty.

    Narzędzia: search_uploads, get_thumbnail

  • Link, który wygasa

    “Daj mi 30-minutowy link do umowy w buckecie Legal.”

    Podpisany link do dowolnego pliku w buckecie, do prywatnych bucketów lub udostępniania na ograniczony czas. Nic w buckecie się nie zmienia.

    Narzędzia: create_temporary_link

  • Rozejrzyj się po bucketach

    “Co jest w folderze releases w moim buckecie Builds?”

    Wyświetla foldery i pliki, także te przesłane poza Aktarem, i wie, które miejsce docelowe jest używane dla których typów plików.

    Narzędzia: list_bucket, list_destinations

Konfiguracja w dwóch krokach

Przesyłaniem zajmuje się Aktar dla Maca lub Windows, więc musi działać na tym samym komputerze co Twój agent.

  1. Zainstaluj polecenie aktar i połącz je z Aktarem. W Aktarze otwórz Ustawienia > Integracje, włącz Zezwalaj na połączenia lokalne i skopiuj token, a potem wklej go do aktar login.

    npm install -g @getaktar/cli
    aktar login
  2. Dodaj Aktar do swojego agenta. Agent sam uruchamia aktar mcp, gdy go potrzebuje.

    Claude Code

    Jedno polecenie, dla każdego projektu. Sprawdź je przez /mcp w Claude Code.

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

    Codex

    Jedno polecenie; trafia do ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude Desktop

    Otwórz Settings > Developer > Edit Config, dodaj to i uruchom Claude Desktop ponownie.

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

    Cursor

    Dodaj to do pliku albo do .cursor/mcp.json w jednym projekcie.

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

    VS Code

    Jedno polecenie dodaje go do Twojego profilu VS Code. Tryb agenta w Copilocie pokaże wtedy narzędzia Aktara.

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

    Windsurf

    Dodaj to do pliku, a potem odśwież serwery MCP w ustawieniach Windsurfa.

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

Jeśli aplikacja twierdzi, że nie może znaleźć aktar, wpisz w command pełną ścieżkę z which aktar; aplikacje desktopowe nie zawsze wczytują PATH Twojej powłoki. Bez instalacji globalnej użyj npx jako polecenia i ["-y", "@getaktar/cli", "mcp"] jako argumentów. Każdy inny agent uruchamiający serwery MCP przez stdio działa tak samo.

Narzędzia, które dostaje Twój agent

Wyszukiwanie, listowanie, linki tymczasowe i miniatury tylko odczytują dane. Przesyłanie i zastępowanie zmieniają Twój bucket, a agent pyta o zgodę przed ich użyciem, chyba że mu na to pozwolisz.

NarzędzieCo robi
upload_filePrzesyła plik i zwraca jego link, Markdown i HTML. Miejsce docelowe, nazwa, folder i czas wygaśnięcia są opcjonalne.
upload_clipboardPrzesyła plik lub obraz ze schowka.
replace_fileZapisuje nowy plik w miejsce przesłanego i zachowuje jego link. Wymaga Aktara na Maca 0.14.0 lub na Windows 0.7.0.
search_uploadsPrzeszukuje historię przesłanych plików.
list_destinationsWyświetla miejsca docelowe i typy plików, do których każde z nich jest używane.
list_bucketWyświetla foldery i pliki bucketa, także te nieprzesłane przez Aktara.
create_temporary_linkTworzy link, który po pewnym czasie przestaje działać (presigned URL).
get_thumbnailPokazuje agentowi podgląd przesłanego pliku. Wymaga Aktara na Maca 0.13.0 lub na Windows 0.6.0.
list_watched_foldersWyświetla obserwowane foldery i ich status.
get_statusSprawdza połączenie z Aktarem.
delete_uploadUsuwa przesłany plik z jego bucketa. Tylko z --allow-delete.

Ty decydujesz, czego może dotykać

Przesłany plik jest publiczny dla każdego, kto ma link, więc serwer domyślnie jest ostrożny, a Ty możesz go jeszcze bardziej ograniczyć.

  • Przesłanie to publikacja

    Agent ma polecenie przesyłać tylko to, co chcesz udostępnić, a agenci pytają o zgodę, zanim wywołają narzędzie, które przesyła.

  • Tylko z Twoich folderów

    --root ogranicza przesyłanie do wskazanych folderów. Ścieżki są rozwiązywane, łącznie z dowiązaniami symbolicznymi, więc link do ~/.ssh lub do .env w innym miejscu zostanie odrzucony.

  • Tylko do odczytu i bez usuwania

    --read-only pomija każde narzędzie, które zapisuje. Usuwanie z bucketu w ogóle nie jest dostępne, chyba że dodasz --allow-delete.

  • Twoje klucze zostają w Aktarze

    Serwer komunikuje się z Aktarem pod adresem 127.0.0.1, używając Twojego tokenu. Agent nigdy nie widzi Twoich kluczy dostępu, a nic nie przechodzi przez nasz serwer.

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

Bez MCP? Użyj skilla

Dla agentów, które korzystają ze skilli, ale nie z MCP, aktar skill wypisuje plik SKILL.md, który uczy je polecenia aktar: co uruchamiać, jak czytać --json i żeby przesyłać tylko to, o co poprosisz. Wszystkie polecenia znajdziesz w dokumentacji CLI.

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

Wymagania

  • Uruchomiony Aktar dla Maca lub Windows z co najmniej jednym miejscem docelowym
  • Polecenie aktar 0.4.0 lub nowsze (Node.js 18 lub nowszy)
  • Agent uruchamiający serwery MCP przez stdio
  • Zastępowanie plików: Aktar dla Maca 0.14.0 lub Windows 0.7.0. Miniatury: Mac 0.13.0 lub Windows 0.6.0
  • Open source (MIT) na GitHubie, wpisany do oficjalnego MCP Registry

Pytania

Czy działa z ChatGPT lub innymi agentami w przeglądarce?

Jeszcze nie. Serwer działa na Twoim komputerze obok Aktara i rozmawia z agentami przez stdio, więc współpracuje z agentami działającymi na Twoim komputerze: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf i innymi.

Czy agent może przesłać pliki, o które nie prosiłem?

Może wywoływać tylko narzędzia, na które pozwolisz, a agenci pytają o zgodę przed wywołaniem narzędzia, które przesyła, chyba że postanowisz inaczej. Żeby mieć pewność, uruchom serwer z --root, aby można było przesyłać tylko z wskazanych folderów, albo z --read-only.

Do którego bucketu przesyła?

Do tego samego co przy upuszczeniu pliku na pasku menu Aktara: do miejsca docelowego, którego Używaj dla pasuje do typu pliku, albo do wybranego. Wskaż miejsce docelowe w prośbie, a agent użyje właśnie tego.

Czy to coś kosztuje?

Nie. Aktar, CLI i serwer MCP są darmowe. Płacisz swojemu dostawcy magazynu za bucket, jak zwykle.

Czy działa na Windows?

Tak. Polecenie aktar działa z Aktarem dla Windows tak samo, podobnie jak każdy z agentów wymienionych wyżej.