• MCP 伺服器
  • aktar v0.6.0

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

aktar mcp 把 Claude、Cursor、VS Code、Codex 等代理程式連接到 Aktar App。你只要請它給個連結,代理程式就會把檔案上傳到你自己的 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

如果 App 提示找不到 aktar,請把 which aktar 輸出的完整路徑填到 command 中;桌面 App 不一定會載入你的 shell 的 PATH。如果沒有全域安裝,就把 npx 作為指令,把 ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] 作為引數。把 /Users/you/Projects 換成你自己的資料夾(在 Windows 上,例如 C:\\Users\\you\\Projects)。如果沒有 --root,檔案只能來自代理程式啟動伺服器時所在的資料夾;如果那是你的主資料夾或磁碟根目錄(桌面 App 經常如此),則不會上傳任何檔案。其他任何透過 stdio 執行 MCP 伺服器的代理程式,用法都一樣。

你可以這樣說

就像對同事說話一樣說出來就行。代理程式選擇工具,Aktar 依目的地本身的設定完成上傳,連結直接出現在對話裡。

  • 在工作階段中分享檔案

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

    代理程式產生檔案並上傳。如果沒有指定目的地,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 上同樣可用,上面列出的所有代理程式也一樣。