MCP-сервер

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

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

1Установіть CLI
npm install -g @getaktar/cli
2Додайте його до Claude Code
claude mcp add --scope user aktar -- aktar mcp

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

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

Викликано Aktarupload_file{ "path": "~/Desktop/checkout-bug.png" }

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

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

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

Кажіть так, як сказали б колезі. Агент вибирає інструмент, 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, тому він має працювати на тому самому комп’ютері, що й ваш агент.

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

    npm install -g @getaktar/cli
    aktar login
  2. Додайте Aktar своєму агентові. Агент сам запускає aktar mcp, коли це потрібно.

    Claude Code

    Одна команда, для всіх проєктів. Перевірте через /mcp у Claude Code.

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

    Codex

    Одна команда; вона записується в ~/.codex/config.toml.

    codex mcp add aktar -- aktar mcp

    Claude 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 так само, як і всі перелічені вище агенти.