• MCP-сервер
  • aktar v0.6.0

Нехай ШІ-агент ділиться файлами з вашого бакета

aktar mcp підключає Claude, Cursor, VS Code, Codex та інших агентів до програми Aktar. Попросіть посилання, і агент вивантажить файл у ваш бакет S3, Cloudflare R2 чи Backblaze B2, а потім дасть вам URL-адресу або Markdown. Ключі вашого сховища ніколи не залишають Aktar.

Потім один раз виконайте aktar login. Cursor, VS Code, Codex та інші нижче.

Вивантаж скриншот помилки оформлення замовлення з Робочого столу й дай мені Markdown-посилання для задачі.

Викликано Aktar · upload_file

Вивантажено в ціль Screenshots. Ось Markdown для задачі:

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

Налаштування у два кроки

Вивантаження виконує Aktar для Mac або Windows, тому він має працювати на тому самому комп’ютері, що й ваш агент.

КРОК 01

Установіть команду aktar і підключіть її до Aktar. В Aktar відкрийте Параметри > Інтеграції, увімкніть Дозволити локальні з’єднання і скопіюйте токен, а потім вставте його в aktar login.

npm install -g @getaktar/cli
aktar login
КРОК 02

Додайте Aktar своєму агентові, указавши після --root теку, з якої він може вивантажувати файли (для кількох тек повторіть прапорець). Агент сам запускає aktar mcp, коли це потрібно.

Claude Code

Одна команда, для всіх проєктів. Замініть ~/Projects на теку, де лежить ваша робота. Перевірте через /mcp у Claude Code.

claude mcp add --scope user aktar -- aktar mcp --root ~/Projects

Якщо програма повідомляє, що не знаходить aktar, укажіть у command повний шлях із which aktar: настільні програми не завжди завантажують PATH вашої оболонки. Без глобального встановлення використовуйте npx як команду та ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] як аргументи. Замініть /Users/you/Projects на власну теку (у Windows, наприклад, C:\\Users\\you\\Projects). Без --root файли беруться лише з теки, у якій агент запускає сервер, а якщо це ваша домашня тека чи корінь диска (як часто буває з настільними програмами), то взагалі нізвідки. Будь-який інший агент, що запускає MCP-сервери через stdio, працює так само.

Про що можна попросити

Кажіть так, як сказали б колезі. Агент вибирає інструмент, Aktar виконує вивантаження з налаштуваннями самої цілі, а посилання з’являється просто в розмові.

  • Поділитися файлом із сесії

    “Запакуй збірку в zip і дай посилання, яке я надішлю в QA.”

    Агент створює файл і вивантажує його. Якщо ціль не названо, Aktar вибирає її за типом файлу (за параметром Використовувати для кожної цілі), як під час перетягування на значок у рядку меню.

    Інструменти:upload_file

  • Зображення для README чи задачі

    “Додай до README новий скриншот із docs/images.”

    Він вивантажує зображення і вставляє Markdown куди треба. Перетворення у WebP і видалення геолокації виконуються в Aktar, як задано в цілі.

    Інструменти:upload_file

  • Оновити файл, зберігши посилання

    “Заміни PDF з онбордингу, яким я ділився минулого тижня, цією новою версією.”

    Він знаходить вивантаження в історії й записує новий файл поверх нього. Усі, хто має посилання, бачать нову версію, нічого не треба надсилати заново. Заміна перезаписує старий файл, тому потрібен --allow-replace.

    Інструменти:search_uploadsreplace_file

  • Знайти вивантажене

    “Яке було посилання на рахунок, який я вивантажував у понеділок?”

    Він шукає в історії Aktar за назвою й датою і може дивитися мініатюри, щоб відрізняти скриншоти, фотографії та документи.

    Інструменти:search_uploadsget_thumbnail

  • Посилання з обмеженим терміном

    “Дай посилання на 30 хвилин на договір із бакета Legal.”

    Presigned-посилання на будь-який файл у бакеті, для приватних бакетів або тимчасового доступу. У бакеті нічого не змінюється.

    Інструменти:create_temporary_link

  • Оглянути бакети

    “Що лежить у теці releases мого бакета Builds?”

    Він показує теки й файли, зокрема вивантажені не через Aktar, і знає, яку ціль використовують для яких типів файлів.

    Інструменти:list_bucketlist_destinations

Покроково для вашого ШІ-інструмента

Готовий плагін або конфігурація, яку можна скопіювати, і про що просити після налаштування.

Є в каталогах:Official MCP RegistryGlamamcpservers.org

Інструменти, які отримує агент

Пошук, перегляд списку, тимчасові посилання та мініатюри лише дивляться. Вивантаження змінює ваш бакет, і агент питає дозволу перед ним, якщо ви не дозволили інакше. Заміна й видалення пропонуються, лише коли ви їх увімкнете.

ІнструментЩо робить
upload_fileВивантажує файл і повертає його посилання, Markdown та HTML. Призначення, ім’я, тека й термін дії необов’язкові. short просить коротке посилання або відмовляється від нього.
upload_clipboardВивантажує файл або зображення з буфера обміну. short просить коротке посилання або відмовляється від нього. Не пропонується, якщо задано --root.
replace_fileЗаписує новий файл поверх вивантаження або будь-якого файлу в бакеті, зберігаючи його посилання. Лише з --allow-replace або --allow-delete. Потрібен Aktar для Mac 0.14.0 або Windows 0.7.0.
create_short_linkСтворює коротке посилання для вивантаження сервісом скорочення посилань його цілі або повертає наявне. Не пропонується з --read-only. Потрібен Aktar для Mac 0.17.0 або Windows 0.10.0.
search_uploadsШукає в історії вивантажень.
list_destinationsПоказує призначення та типи файлів, для яких використовується кожне з них.
list_bucketПоказує теки й файли бакета, зокрема файли, вивантажені не через Aktar.
create_temporary_linkСтворює посилання, яке перестає працювати через певний час (presigned URL). Доти будь-хто, хто його має, може завантажити файл, навіть із приватного бакета. Щонайбільше 60 хвилин, якщо --max-link-minutes не дозволяє більше.
get_thumbnailПоказує агентові попередній перегляд вивантаження. Потрібен Aktar для Mac 0.13.0 або Windows 0.6.0.
list_watched_foldersПоказує відстежувані теки та їхній стан.
get_statusПеревіряє з’єднання з Aktar.
delete_uploadВидаляє вивантаження з бакета. Лише з --allow-delete.

Ви вирішуєте, до чого він має доступ

Вивантажений файл доступний усім, хто має посилання, тож сервер починає з мінімуму, а ви вирішуєте, що додати.

  • Вивантажити означає опублікувати

    Агентові сказано вивантажувати лише те, чим ви попросили поділитися, а агенти питають дозволу перед викликом інструмента, що вивантажує. --log записує кожен виклик інструмента, тож згодом можна побачити, що робив агент.
  • Лише з ваших тек, жодних секретів

    Файли беруться лише з тек, указаних через --root, або з теки, у якій агент запускає сервер, і ніколи випадково з усієї домашньої теки. SSH- і приватні ключі, файли .env, облікові дані хмарних сервісів, профілі браузерів і бази паролів відхиляються, хоч би де вони лежали, зокрема через символічні посилання.
  • Нічого не перезаписується без вашого дозволу

    Заміна файлу пропонується лише з --allow-replace, а видалення з --allow-delete. --read-only прибирає всі інструменти, що щось записують. Тимчасові посилання діють щонайбільше 60 хвилин, якщо --max-link-minutes не дозволяє більше.
  • Ваші ключі лишаються в Aktar

    Сервер спілкується з Aktar на 127.0.0.1 і перед надсиланням вашого токена перевіряє, що це справді Aktar. Агент ніколи не бачить ваших ключів доступу, і ніщо не проходить через наші сервери.
aktar mcp
aktar mcp --root ~/Projects --root ~/Desktop --allow-replace
aktar mcp --root ~/Projects --read-only
aktar mcp --root ~/Projects --log ~/aktar-mcp.log

Немає MCP? Використайте навичку

Для агентів, які підтримують навички, але не MCP, aktar skill виводить файл SKILL.md, що вчить їх команди aktar: що запускати, як читати --json і вивантажувати лише те, про що ви просили. Усі команди описано в документації CLI.

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

Вимоги

  • Aktar для Mac або Windows, запущений, принаймні з однією ціллю
  • Команда aktar версії 0.4.0 або новішої (Node.js 18 або новіший). aktar 0.6.0 і новіші потребують Aktar для Mac 0.18.0 або Windows 0.11.0
  • Агент, що запускає MCP-сервери через stdio
  • Заміна файлів: Aktar для Mac 0.14.0 або Windows 0.7.0. Мініатюри: Mac 0.13.0 або Windows 0.6.0
  • Відкритий вихідний код (MIT) на GitHub, є в офіційному MCP Registry

Запитання

Чи працює це з ChatGPT або іншими агентами в браузері?

Поки що ні. Сервер працює на вашому комп’ютері поруч з Aktar і спілкується з агентами через stdio, тож він підходить агентам, що працюють на вашому комп’ютері: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf та іншим.

Чи може агент вивантажити файли, про які я не просив?

Він може викликати лише ті інструменти, які ви дозволили, а агенти питають дозволу перед викликом інструмента, що вивантажує, якщо ви не сказали інакше. Файли беруться лише з тек, указаних через --root (або з теки, у якій агент його запускає), а секрети на кшталт SSH-ключів і файлів .env ніколи не вивантажуються. --read-only вимикає вивантаження, а --log згодом показує, що викликалося.

У який бакет він вивантажує?

У той самий, що й під час перетягування на значок Aktar у рядку меню: у ціль, чий параметр Використовувати для відповідає типу файлу, або в обрану. Назвіть ціль у запиті, і агент використає її.

Це коштує грошей?

Ні. Aktar, CLI та MCP-сервер безкоштовні. Ви, як завжди, платите своєму провайдеру сховища за бакет.

Чи працює це у Windows?

Так. Команда aktar працює з Aktar для Windows так само, як і всі перелічені вище агенти.