--log 會記錄每一次工具呼叫,方便你事後查看代理程式做了什麼。- 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:
兩步完成設定
上傳由 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 伺服器。
如果 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 工具逐步設定
現成的外掛程式或可直接複製的設定,以及設定好之後可以請它做什麼。
你的代理程式能用的工具
搜尋、列出、暫時連結和縮圖只是查看。上傳會修改你的儲存貯體,除非你允許,否則代理程式在使用前會先詢問。取代和刪除只有在你開啟後才會提供。
| 工具 | 用途 |
|---|---|
| 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 上同樣可用,上面列出的所有代理程式也一樣。