--log 会记录每一次工具调用,方便你事后查看智能体做了什么。- 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:
两步完成设置
上传由 Mac 或 Windows 版 Aktar 完成,所以它必须和你的智能体运行在同一台电脑上。
安装 aktar 命令并连接到 Aktar。在 Aktar 中打开设置 → 集成,开启允许本地连接并复制令牌,然后把它粘贴到 aktar login 中。
npm install -g @getaktar/cli
aktar login把 Aktar 添加到你的智能体,并在 --root 后面写上允许它上传文件的文件夹(多个文件夹就重复使用)。需要时,智能体会自动启动 aktar mcp。
Claude Code
一条命令,对所有项目生效。把 ~/Projects 改成你工作所在的文件夹。在 Claude Code 中用 /mcp 检查。
claude mcp add --scope user aktar -- aktar mcp --root ~/ProjectsCodex
一条命令,会写入 ~/.codex/config.toml。
codex mcp add aktar -- aktar mcp --root ~/ProjectsVS Code
一条命令即可添加到你的 VS Code 配置文件。之后 Copilot 的智能体模式会列出 Aktar 的工具。
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp","--root","/Users/you/Projects"]}'Cursor
把它添加到这个文件,或某个项目里的 .cursor/mcp.json。
Claude Desktop
打开 Settings > Developer > Edit Config,添加下面的内容,然后重启 Claude Desktop。
Windsurf
把它添加到这个文件,然后在 Windsurf 的设置中刷新 MCP 服务器。
如果应用提示找不到 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 工具分步设置
现成的插件或可直接复制的配置,以及设置好之后可以让它做什么。
你的智能体能用的工具
搜索、列出、临时链接和缩略图只是查看。上传会修改你的存储桶,除非你允许,否则智能体在使用前会先询问。替换和删除只有在你开启后才会提供。
| 工具 | 作用 |
|---|---|
| upload_ | 上传文件并返回其链接、Markdown 和 HTML。上传目标、名称、文件夹和过期时间均为可选。short 可要求创建短链接,或不创建。 |
| upload_ | 上传剪贴板中的文件或图片。short 可要求创建短链接,或不创建。指定 --root 时不提供。 |
| replace_ | 用新文件覆盖已上传的文件或存储桶中的任意文件,并保留链接。仅在使用 --allow-replace 或 --allow-delete 时提供。需要 Aktar for Mac 0.14.0 或 Windows 0.7.0。 |
| create_ | 用上传目标的短链接服务为某个上传创建短链接,或返回已有的短链接。使用 --read-only 时不提供。需要 Mac 版 Aktar 0.17.0 或 Windows 版 0.10.0。 |
| search_ | 搜索上传记录。 |
| list_ | 列出上传目标,以及每个目标用于哪些文件类型。 |
| list_ | 列出存储桶中的文件夹和文件,包括不是通过 Aktar 上传的文件。 |
| create_ | 生成一个一段时间后失效的链接(预签名 URL)。在失效之前,任何拿到链接的人都能下载该文件,即使它在私有存储桶中。最长 60 分钟,除非 --max-link-minutes 允许更长。 |
| get_ | 向智能体展示某个上传的预览。需要 Aktar for Mac 0.13.0 或 Windows 0.6.0。 |
| list_ | 列出监视的文件夹及其状态。 |
| get_ | 检查与 Aktar 的连接。 |
| delete_ | 从存储桶中删除一个上传。仅在使用 --allow-delete 时可用。 |
它能碰什么,由你决定
上传的文件对任何拿到链接的人都是公开的,所以服务器一开始只提供很少的功能,要添加什么由你决定。
上传就是公开
智能体被告知只上传你要求分享的内容,而且调用会上传的工具之前,智能体会先询问。只从你指定的文件夹,绝不上传机密
文件只来自你用--root指定的文件夹,或智能体启动服务器时所在的文件夹,绝不会意外包括你的整个主文件夹。SSH 密钥和私钥、.env文件、云服务凭据、浏览器配置文件和密码数据库,无论放在哪里都会被拒绝,符号链接也一样。未经你同意,不会覆盖任何内容
只有使用--allow-replace时才提供替换文件,使用--allow-delete时才提供删除。--read-only会去掉所有会写入的工具。临时链接最长有效 60 分钟,除非--max-link-minutes允许更长。你的密钥留在 Aktar 中
服务器在 127.0.0.1 上与 Aktar 通信,并在发送你的令牌之前确认对方确实是 Aktar。智能体看不到你的访问密钥,任何内容也不会经过我们的服务器。
不支持 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 或浏览器里的其他智能体吗?
智能体会上传我没要求上传的文件吗?
--root 指定的文件夹(或智能体启动服务器时所在的文件夹),SSH 密钥和 .env 文件等机密永远不会被上传。--read-only 会关闭上传,--log 让你事后查看调用了什么。它会上传到哪个存储桶?
要花钱吗?
支持 Windows 吗?
aktar 命令在 Windows 版 Aktar 上同样可用,上面列出的所有智能体也一样。