Để agent AI chia sẻ tệp từ bucket của riêng bạn

Bạn có thể nhờ gì

• Chia sẻ tệp từ một phiên làm việc

  “Nén bản build thành zip và đưa tôi liên kết để gửi cho QA.”

  Agent tạo tệp rồi tải lên. Nếu không nêu đích, Aktar chọn một đích theo loại tệp (mục Dùng cho của từng đích), giống như khi thả tệp vào thanh menu.

  Công cụ: upload_file

• Ảnh cho README hoặc issue

  “Thêm ảnh chụp màn hình tôi vừa sao chép vào README.”

  Nó tải ảnh lên, hoặc nội dung đang có trong clipboard, rồi ghi Markdown vào đúng chỗ. Việc chuyển sang WebP và xóa vị trí được Aktar thực hiện, theo đúng cài đặt của đích.

  Công cụ: upload_file, upload_clipboard

• Cập nhật tệp, giữ nguyên liên kết

  “Thay tệp PDF onboarding tôi đã chia sẻ tuần trước bằng phiên bản mới này.”

  Nó tìm lần tải lên trong lịch sử và ghi đè tệp mới lên đó. Mọi người có liên kết đều thấy phiên bản mới; không cần gửi lại gì cả.

  Công cụ: search_uploads, replace_file

• Tìm thứ bạn đã tải lên

  “Liên kết của hóa đơn tôi đã tải lên hôm thứ Hai là gì?”

  Nó tìm trong lịch sử của Aktar theo tên và ngày, và có thể xem ảnh thu nhỏ để phân biệt ảnh chụp màn hình, ảnh và tài liệu.

  Công cụ: search_uploads, get_thumbnail

• Liên kết có hạn

  “Tạo cho tôi liên kết 30 phút tới hợp đồng trong bucket Legal.”

  Một liên kết presigned tới bất kỳ tệp nào trong bucket, dùng cho bucket riêng tư hoặc để chia sẻ trong thời gian giới hạn. Bucket không bị thay đổi gì.

  Công cụ: create_temporary_link

• Xem qua các bucket của bạn

  “Thư mục releases trong bucket Builds của tôi có gì?”

  Nó liệt kê thư mục và tệp, kể cả những tệp không tải lên bằng Aktar, và biết đích nào được dùng cho loại tệp nào.

  Công cụ: list_bucket, list_destinations

Thiết lập trong hai bước

1. Cài lệnh aktar và kết nối nó với Aktar. Trong Aktar, mở Cài đặt > Tích hợp, bật Cho phép kết nối cục bộ và sao chép token, rồi dán vào aktar login.

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

2. Thêm Aktar vào agent của bạn. Agent tự khởi chạy aktar mcp khi cần.

   Claude Code

   Một lệnh, cho mọi dự án. Kiểm tra bằng /mcp trong Claude Code.

   $ claude mcp add --scope user aktar -- aktar mcp

   Codex

   Một lệnh; nó được ghi vào ~/.codex/config.toml.

   $ codex mcp add aktar -- aktar mcp

   Claude Desktop

   Mở Settings > Developer > Edit Config, thêm đoạn này rồi khởi động lại Claude Desktop.

   Trong claude_desktop_config.json

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

   Cursor

   Thêm đoạn này vào tệp, hoặc vào .cursor/mcp.json trong một dự án.

   Trong ~/.cursor/mcp.json

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

   VS Code

   Một lệnh thêm nó vào hồ sơ VS Code của bạn. Chế độ agent của Copilot sau đó liệt kê các công cụ của Aktar.

   $ code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp"]}'

   Windsurf

   Thêm đoạn này vào tệp, rồi làm mới các máy chủ MCP trong cài đặt của Windsurf.

   Trong ~/.codeium/windsurf/mcp_config.json

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

Các công cụ agent của bạn nhận được

Bạn quyết định nó được đụng vào đâu

• Tải lên nghĩa là công khai

  Agent được dặn chỉ tải lên những gì bạn nhờ chia sẻ, và các agent hỏi trước khi gọi công cụ có tải lên.

• Chỉ từ các thư mục của bạn

  --root giới hạn việc tải lên trong các thư mục bạn nêu. Đường dẫn được phân giải, kể cả symlink, nên liên kết tới ~/.ssh hay tệp .env ở nơi khác sẽ bị từ chối.

• Chỉ đọc, và không xóa

  --read-only loại bỏ mọi công cụ có ghi dữ liệu. Việc xóa khỏi bucket hoàn toàn không được cung cấp trừ khi bạn thêm --allow-delete.

• Khóa của bạn ở lại trong Aktar

  Máy chủ giao tiếp với Aktar trên 127.0.0.1 bằng token của bạn. Agent không bao giờ thấy khóa truy cập của bạn, và không có gì đi qua máy chủ của chúng tôi.

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

Câu hỏi