MCP-сервер
Нехай ШІ-агент ділиться файлами з вашого бакета
aktar mcp підключає Claude, Cursor, VS Code, Codex та інших агентів до програми Aktar. Попросіть посилання, і агент вивантажить файл у ваш бакет S3, Cloudflare R2 чи Backblaze B2, а потім дасть вам URL-адресу або Markdown. Ключі вашого сховища ніколи не залишають Aktar.
npm install -g @getaktar/cli claude mcp add --scope user aktar -- aktar mcpПотім один раз виконайте aktar login. Cursor, VS Code, Codex та інші нижче.
Вивантаж скриншот помилки оформлення замовлення з Робочого столу й дай мені Markdown-посилання для задачі.
upload_file{ "path": "~/Desktop/checkout-bug.png" }Вивантажено в ціль Screenshots. Ось Markdown для задачі:
Про що можна попросити
Кажіть так, як сказали б колезі. Агент вибирає інструмент, Aktar виконує вивантаження з налаштуваннями самої цілі, а посилання з’являється просто в розмові.
-
Поділитися файлом із сесії
“Запакуй збірку в zip і дай посилання, яке я надішлю в QA.”
Агент створює файл і вивантажує його. Якщо ціль не названо, Aktar вибирає її за типом файлу (за параметром Використовувати для кожної цілі), як під час перетягування на значок у рядку меню.
Інструменти:
upload_file -
Зображення для README чи задачі
“Додай до README скриншот, який я щойно скопіював.”
Він вивантажує зображення або те, що лежить у буфері обміну, і вставляє Markdown куди треба. Перетворення у WebP і видалення геолокації виконуються в Aktar, як задано в цілі.
Інструменти:
upload_file,upload_clipboard -
Оновити файл, зберігши посилання
“Заміни PDF з онбордингу, яким я ділився минулого тижня, цією новою версією.”
Він знаходить вивантаження в історії й записує новий файл поверх нього. Усі, хто має посилання, бачать нову версію, нічого не треба надсилати заново.
Інструменти:
search_uploads,replace_file -
Знайти вивантажене
“Яке було посилання на рахунок, який я вивантажував у понеділок?”
Він шукає в історії Aktar за назвою й датою і може дивитися мініатюри, щоб відрізняти скриншоти, фотографії та документи.
Інструменти:
search_uploads,get_thumbnail -
Посилання з обмеженим терміном
“Дай посилання на 30 хвилин на договір із бакета Legal.”
Presigned-посилання на будь-який файл у бакеті, для приватних бакетів або тимчасового доступу. У бакеті нічого не змінюється.
Інструменти:
create_temporary_link -
Оглянути бакети
“Що лежить у теці releases мого бакета Builds?”
Він показує теки й файли, зокрема вивантажені не через Aktar, і знає, яку ціль використовують для яких типів файлів.
Інструменти:
list_bucket,list_destinations
Налаштування у два кроки
Вивантаження виконує Aktar для Mac або Windows, тому він має працювати на тому самому комп’ютері, що й ваш агент.
Установіть команду
aktarі підключіть її до Aktar. В Aktar відкрийте Параметри > Інтеграції, увімкніть Дозволити локальні з’єднання і скопіюйте токен, а потім вставте його вaktar login.npm install -g @getaktar/cli aktar loginДодайте Aktar своєму агентові. Агент сам запускає
aktar mcp, коли це потрібно.Claude Code
Одна команда, для всіх проєктів. Перевірте через
/mcpу Claude Code.claude mcp add --scope user aktar -- aktar mcpCodex
Одна команда; вона записується в
~/.codex/config.toml.codex mcp add aktar -- aktar mcpClaude Desktop
Відкрийте Settings > Developer > Edit Config, додайте це й перезапустіть Claude Desktop.
У claude_desktop_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }Cursor
Додайте це у файл або в
.cursor/mcp.jsonодного проєкту.У ~/.cursor/mcp.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }VS Code
Одна команда додає його до вашого профілю VS Code. Потім агентний режим Copilot показує інструменти Aktar.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'Windsurf
Додайте це у файл, а потім оновіть список MCP-серверів у налаштуваннях Windsurf.
У ~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "aktar": { "command": "aktar", "args": ["mcp"] } } }
Якщо програма повідомляє, що не знаходить aktar, укажіть у command повний шлях із which aktar: настільні програми не завжди завантажують PATH вашої оболонки. Без глобального встановлення використовуйте npx як команду та ["-y", "@getaktar/cli", "mcp"] як аргументи. Будь-який інший агент, що запускає MCP-сервери через stdio, працює так само.
Інструменти, які отримує агент
Пошук, перегляд списку, тимчасові посилання та мініатюри лише дивляться. Вивантаження й заміна змінюють ваш бакет, і агент питає дозволу перед їх використанням, якщо ви не дозволили інакше.
| Інструмент | Що робить |
|---|---|
upload_file | Вивантажує файл і повертає його посилання, Markdown та HTML. Призначення, ім’я, тека й термін дії необов’язкові. |
upload_clipboard | Вивантажує файл або зображення з буфера обміну. |
replace_file | Записує новий файл поверх вивантаження, зберігаючи його посилання. Потрібен Aktar для Mac 0.14.0 або Windows 0.7.0. |
search_uploads | Шукає в історії вивантажень. |
list_destinations | Показує призначення та типи файлів, для яких використовується кожне з них. |
list_bucket | Показує теки й файли бакета, зокрема файли, вивантажені не через Aktar. |
create_temporary_link | Створює посилання, яке перестає працювати через певний час (presigned URL). |
get_thumbnail | Показує агентові попередній перегляд вивантаження. Потрібен Aktar для Mac 0.13.0 або Windows 0.6.0. |
list_watched_folders | Показує відстежувані теки та їхній стан. |
get_status | Перевіряє з’єднання з Aktar. |
delete_upload | Видаляє вивантаження з бакета. Лише з --allow-delete. |
Ви вирішуєте, до чого він має доступ
Вивантажений файл доступний усім, хто має посилання, тож сервер за замовчуванням обережний, а ви можете обмежити його ще більше.
-
Вивантажити означає опублікувати
Агентові сказано вивантажувати лише те, чим ви попросили поділитися, а агенти питають дозволу перед викликом інструмента, що вивантажує.
-
Лише з ваших тек
--rootобмежує вивантаження вказаними вами теками. Шляхи розв’язуються разом із символічними посиланнями, тож посилання на~/.sshабо файл.envдеінде буде відхилено. -
Лише читання й жодного видалення
--read-onlyприбирає всі інструменти, що щось записують. Видалення з бакета не пропонується взагалі, доки ви не додасте--allow-delete. -
Ваші ключі лишаються в Aktar
Сервер спілкується з Aktar на 127.0.0.1 з вашим токеном. Агент ніколи не бачить ваших ключів доступу, і ніщо не проходить через наші сервери.
aktar mcp --root ~/Projects --root ~/Desktop
aktar mcp --read-onlyНемає 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 або новіший) - Агент, що запускає 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, щоб вивантажувати можна було лише з указаних тек, або з --read-only.
У який бакет він вивантажує?
У той самий, що й під час перетягування на значок Aktar у рядку меню: у ціль, чий параметр Використовувати для відповідає типу файлу, або в обрану. Назвіть ціль у запиті, і агент використає її.
Це коштує грошей?
Ні. Aktar, CLI та MCP-сервер безкоштовні. Ви, як завжди, платите своєму провайдеру сховища за бакет.
Чи працює це у Windows?
Так. Команда aktar працює з Aktar для Windows так само, як і всі перелічені вище агенти.