• MCP 服务器
  • aktar v0.6.0

让你的 AI 智能体
从你自己的存储桶分享文件

aktar mcp 把 Claude、Cursor、VS Code、Codex 等智能体连接到 Aktar 应用。你只要让它给个链接,智能体就会把文件上传到你自己的 S3、Cloudflare R2 或 Backblaze B2 存储桶,然后把 URL 或 Markdown 交给你。你的存储密钥始终不会离开 Aktar。

然后运行一次 aktar login。Cursor、VS Code、Codex 等见下方。

把我桌面上那张结账页 bug 的截图上传一下,再给我一个能贴进 issue 的 Markdown 链接。

已调用 Aktar · upload_file

已上传到你的 Screenshots 上传目标。这是用于 issue 的 Markdown:

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

两步完成设置

上传由 Mac 或 Windows 版 Aktar 完成,所以它必须和你的智能体运行在同一台电脑上。

步骤 01

安装 aktar 命令并连接到 Aktar。在 Aktar 中打开设置 → 集成,开启允许本地连接并复制令牌,然后把它粘贴到 aktar login 中。

npm install -g @getaktar/cli
aktar login
步骤 02

把 Aktar 添加到你的智能体,并在 --root 后面写上允许它上传文件的文件夹(多个文件夹就重复使用)。需要时,智能体会自动启动 aktar mcp。

Claude Code

一条命令,对所有项目生效。把 ~/Projects 改成你工作所在的文件夹。在 Claude Code 中用 /mcp 检查。

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

如果应用提示找不到 aktar,请把 which aktar 输出的完整路径填到 command 中;桌面应用不一定会加载你的 shell 的 PATH。如果没有全局安装,就把 npx 作为命令,把 ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] 作为参数。把 /Users/you/Projects 换成你自己的文件夹(在 Windows 上,例如 C:\\Users\\you\\Projects)。如果没有 --root,文件只能来自智能体启动服务器时所在的文件夹;如果那是你的主文件夹或磁盘根目录(桌面应用经常如此),则不会上传任何文件。其他任何通过 stdio 运行 MCP 服务器的智能体,用法都一样。

你可以这样说

就像对同事说话一样说出来就行。智能体选择工具,Aktar 按上传目标自己的设置完成上传,链接直接出现在对话里。

  • 在会话中分享文件

    “把这次构建打成 zip,给我一个可以发给测试同事的链接。”

    智能体生成文件并上传。如果没有指定上传目标,Aktar 会按文件类型(各上传目标的用于)选择,就像把文件拖到菜单栏一样。

    工具:upload_file

  • 用于 README 或 issue 的图片

    “把 docs/images 里的新截图加到 README 里。”

    它会上传图片,并把 Markdown 写在合适的位置。WebP 转换和位置信息移除由 Aktar 按上传目标的设置完成。

    工具:upload_file

  • 更新文件,保留链接

    “把我上周分享的入职指南 PDF 换成这个新版本。”

    它在历史记录中找到那次上传,并把新文件写在原位置。拥有链接的人看到的就是新版本,不需要重新发送。替换会覆盖旧文件,所以需要 --allow-replace。

    工具:search_uploadsreplace_file

  • 找回你上传过的文件

    “我周一上传的那张发票的链接是什么?”

    它按名称和日期搜索 Aktar 的历史记录,还能查看缩略图来区分截图、照片和文档。

    工具:search_uploadsget_thumbnail

  • 会过期的链接

    “给我 Legal 存储桶里那份合同的 30 分钟链接。”

    为存储桶中的任意文件生成预签名链接,适用于私有存储桶或限时分享。存储桶里的内容不会有任何变化。

    工具:create_temporary_link

  • 浏览你的存储桶

    “我的 Builds 存储桶里 releases 文件夹有什么?”

    它会列出文件夹和文件,包括不是通过 Aktar 上传的文件,并且知道各上传目标用于哪些文件类型。

    工具:list_bucketlist_destinations

按你的 AI 工具分步设置

现成的插件或可直接复制的配置,以及设置好之后可以让它做什么。

收录于:Official MCP RegistryGlamamcpservers.org

你的智能体能用的工具

搜索、列出、临时链接和缩略图只是查看。上传会修改你的存储桶,除非你允许,否则智能体在使用前会先询问。替换和删除只有在你开启后才会提供。

工具作用
upload_file上传文件并返回其链接、Markdown 和 HTML。上传目标、名称、文件夹和过期时间均为可选。short 可要求创建短链接,或不创建。
upload_clipboard上传剪贴板中的文件或图片。short 可要求创建短链接,或不创建。指定 --root 时不提供。
replace_file用新文件覆盖已上传的文件或存储桶中的任意文件,并保留链接。仅在使用 --allow-replace 或 --allow-delete 时提供。需要 Aktar for Mac 0.14.0 或 Windows 0.7.0。
create_short_link用上传目标的短链接服务为某个上传创建短链接,或返回已有的短链接。使用 --read-only 时不提供。需要 Mac 版 Aktar 0.17.0 或 Windows 版 0.10.0。
search_uploads搜索上传记录。
list_destinations列出上传目标,以及每个目标用于哪些文件类型。
list_bucket列出存储桶中的文件夹和文件,包括不是通过 Aktar 上传的文件。
create_temporary_link生成一个一段时间后失效的链接(预签名 URL)。在失效之前,任何拿到链接的人都能下载该文件,即使它在私有存储桶中。最长 60 分钟,除非 --max-link-minutes 允许更长。
get_thumbnail向智能体展示某个上传的预览。需要 Aktar for 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 中

    服务器在 127.0.0.1 上与 Aktar 通信,并在发送你的令牌之前确认对方确实是 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

要求

  • Mac 或 Windows 版 Aktar,正在运行,并且至少有一个上传目标
  • aktar 命令 0.4.0 或更高版本(Node.js 18 或更高版本)。aktar 0.6.0 及更高版本需要 Mac 版 Aktar 0.18.0 或 Windows 版 0.11.0
  • 一个通过 stdio 运行 MCP 服务器的智能体
  • 替换文件:Mac 版 Aktar 0.14.0 或 Windows 版 0.7.0。缩略图:Mac 版 0.13.0 或 Windows 版 0.6.0
  • 在 GitHub 上开源(MIT),并已收录于官方 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 命令在 Windows 版 Aktar 上同样可用,上面列出的所有智能体也一样。