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.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpPotem 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.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Przesłano do Twojego miejsca docelowego Screenshots. Oto Markdown do zgłoszenia:
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.
Zainstaluj polecenie
aktari 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 doaktar login.npm install -g @getaktar/cli aktar loginDodaj Aktar do swojego agenta. Agent sam uruchamia
aktar mcp, gdy go potrzebuje.Claude Code
Jedno polecenie, dla każdego projektu. Sprawdź je przez
/mcpw Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Jedno polecenie; trafia do
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude 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.jsonw 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ędzie | Co robi |
|---|---|
upload_file | Przesyła plik i zwraca jego link, Markdown i HTML. Miejsce docelowe, nazwa, folder i czas wygaśnięcia są opcjonalne. |
upload_clipboard | Przesyła plik lub obraz ze schowka. |
replace_file | Zapisuje nowy plik w miejsce przesłanego i zachowuje jego link. Wymaga Aktara na Maca 0.14.0 lub na Windows 0.7.0. |
search_uploads | Przeszukuje historię przesłanych plików. |
list_destinations | Wyświetla miejsca docelowe i typy plików, do których każde z nich jest używane. |
list_bucket | Wyświetla foldery i pliki bucketa, także te nieprzesłane przez Aktara. |
create_temporary_link | Tworzy link, który po pewnym czasie przestaje działać (presigned URL). |
get_thumbnail | Pokazuje agentowi podgląd przesłanego pliku. Wymaga Aktara na Maca 0.13.0 lub na Windows 0.6.0. |
list_watched_folders | Wyświetla obserwowane foldery i ich status. |
get_status | Sprawdza połączenie z Aktarem. |
delete_upload | Usuwa 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
--rootogranicza przesyłanie do wskazanych folderów. Ścieżki są rozwiązywane, łącznie z dowiązaniami symbolicznymi, więc link do~/.sshlub do.envw innym miejscu zostanie odrzucony. -
Tylko do odczytu i bez usuwania
--read-onlypomija 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-onlyBez 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.mdWymagania
- Uruchomiony Aktar dla Maca lub Windows z co najmniej jednym miejscem docelowym
-
Polecenie
aktar0.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.