讓你的 AI 代理程式從你自己的儲存貯體分享檔案

你可以這樣說

• 在工作階段中分享檔案

  “把這次建置打包成 zip，給我一個可以傳給 QA 的連結。”

  代理程式產生檔案並上傳。如果沒有指定目的地，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

常見問題