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 точно так же, как и все перечисленные выше агенты.