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