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

你可以这样说

• 在会话中分享文件

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

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

  工具: upload_file

• 用于 README 或 issue 的图片

  “把我刚复制的截图加到 README 里。”

  它会上传图片或剪贴板中的内容，并把 Markdown 写在合适的位置。WebP 转换和位置信息移除由 Aktar 按上传目标的设置完成。

  工具: upload_file, upload_clipboard

• 更新文件，保留链接

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

  它在历史记录中找到那次上传，并把新文件写在原位置。拥有链接的人看到的就是新版本，不需要重新发送。

  工具: search_uploads, replace_file

• 找回你上传过的文件

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

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

  工具: search_uploads, get_thumbnail

• 会过期的链接

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

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

  工具: create_temporary_link

• 浏览你的存储桶

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

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

  工具: list_bucket, list_destinations

两步完成设置

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

   $ npm install -g @getaktar/cli
   $ aktar login

2. 把 Aktar 添加到你的智能体。需要时，智能体会自动启动 aktar mcp。

   Claude Code

   一条命令，对所有项目生效。在 Claude Code 中用 /mcp 检查。

   $ 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

   把它添加到这个文件，然后在 Windsurf 的设置中刷新 MCP 服务器。

   在 ~/.codeium/windsurf/mcp_config.json 中

   {
     "mcpServers": {
       "aktar": { "command": "aktar", "args": ["mcp"] }
     }
   }

你的智能体能用的工具

它能碰什么，由你决定

• 上传就是公开

  智能体被告知只上传你要求分享的内容，而且调用会上传的工具之前，智能体会先询问。

• 只从你指定的文件夹

  --root 把上传限制在你指定的文件夹内。路径会被解析（包括符号链接），所以指向 ~/.ssh 的链接，或其他位置的 .env 都会被拒绝。

• 只读，不能删除

  --read-only 会去掉所有会写入的工具。除非你加上 --allow-delete，否则根本不提供从存储桶删除的功能。

• 你的密钥留在 Aktar 中

  服务器用你的令牌在 127.0.0.1 上与 Aktar 通信。智能体看不到你的访问密钥，任何内容也不会经过我们的服务器。

$ aktar mcp --root ~/Projects --root ~/Desktop
$ aktar mcp --read-only

常见问题