Kết nối trợ lý AI của bạn với Unbox

Tổng quan

Unbox MCP dành cho chủ sở hữu tài khoản cá nhân muốn có trợ lý AI — trong Cursor, Workbuddy, OpenClaw hoặc bất kỳ máy chủ tương thích MCP nào — để làm việc với thư được lưu trữ của họ. Đây không phải là API nhà phát triển để xây dựng ứng dụng trên Unbox; để gửi giao dịch từ miền của bạn, hãy xem tài liệu HTTP API của chúng tôi.

Những gì tác nhân có thể làm

Sau khi bạn đăng nhập, tác nhân của bạn có thể gọi các công cụ Unbox thay mặt bạn:

• Đọc hộp thư đến & chuỗi thư — Liệt kê các cuộc hội thoại, mở một chuỗi thư và lấy các tin nhắn riêng lẻ.
• Tìm kiếm thư — Tìm tin nhắn trong hộp thư đến của bạn bằng các truy vấn ngôn ngữ tự nhiên.
• Gửi & trả lời — Soạn thư mới hoặc trả lời một chuỗi thư từ các địa chỉ Unbox của bạn, tùy thuộc vào giới hạn gửi của gói cước.
• Sắp xếp — Đánh dấu spam, khôi phục từ spam, chuyển vào thùng rác hoặc khôi phục — từng tin nhắn một.

Xóa hàng loạt spam hoặc thùng rác, tạo khóa API và các hành động trong không gian làm việc nhóm không khả dụng qua MCP trong phiên bản v1.

Cách hoạt động

Trình khách AI của bạn kết nối đến máy chủ MCP của Unbox. Máy chủ gọi các API tài khoản Unbox bằng một phiên web thông thường — giống như phiên bạn có khi đăng nhập tại unbox.im.

1. Thêm Unbox vào cấu hình trình khách MCP của bạn (xem phần Thiết lập bên dưới).
2. Yêu cầu tác nhân của bạn đăng nhập — nó sẽ mở một liên kết trình duyệt nơi bạn phê duyệt quyền truy cập bằng tài khoản Unbox của bạn.
3. Sau khi kết nối, yêu cầu tác nhân của bạn đọc thư, soạn thảo trả lời hoặc sắp xếp tin nhắn.

Đăng nhập

Unbox sử dụng đăng nhập qua trình duyệt để bạn luôn phê duyệt quyền truy cập. Tác nhân của bạn bắt đầu quy trình với các công cụ đăng nhập, sau đó bạn hoàn tất đăng nhập trong trình duyệt:

1. Tác nhân của bạn gọi unbox_login_start và hiển thị cho bạn một URL trình duyệt.
2. Mở liên kết, đăng nhập vào Unbox nếu cần và sao chép mã liên kết một lần được hiển thị trên trang.
3. Dán mã trở lại cho tác nhân của bạn (unbox_login_complete).
4. Phiên của bạn vẫn hoạt động trong suốt thời gian phiên web Unbox thông thường — đăng nhập lại khi nó hết hạn.

URL đăng nhập (để tham khảo)

https://unbox.im/vi/auth/desktop/link?source=mcp

Cần tài khoản trước? Tạo Unbox ID của bạn, sau đó quay lại để kết nối tác nhân của bạn.

Thiết lập

Thêm Unbox như một máy chủ MCP trong trình khách AI của bạn. Truyền tải HTTP từ xa là cách đơn giản nhất để kết nối với đám mây Unbox:

HTTP từ xa (khuyến nghị)

Trỏ MCP client của bạn đến endpoint MCP của Unbox. Sau khi thêm máy chủ, hãy sử dụng các công cụ đăng nhập để xác thực:

{
  "mcpServers": {
    "unbox": {
      "url": "https://unbox.im/api/mcp"
    }
  }
}

HTTP MCP có thể bị vô hiệu hóa trên một số hệ thống cho đến khi được người vận hành bật. Nếu kết nối thất bại, hãy thử lại sau hoặc liên hệ hỗ trợ.

Công cụ phổ biến

Sau khi đăng nhập, agent của bạn có thể sử dụng các công cụ như:

• unbox_login_start — mở đăng nhập trình duyệt
• unbox_login_complete — trao đổi mã liên kết để lấy phiên
• unbox_list_threads — nguồn cấp dữ liệu hộp thư đến
• unbox_search_inbox — tìm kiếm tin nhắn
• unbox_reply_to_email — trả lời tin nhắn
• unbox_send_email — gửi thư mới

Client được hỗ trợ

Bất kỳ máy chủ agent nào tương thích MCP đều có thể kết nối với Unbox. Chúng tôi kiểm tra và ghi lại:

• Cursor — Thêm Unbox vào mục MCP servers trong cài đặt Cursor, sau đó đăng nhập qua luồng trình duyệt.
• Workbuddy — Cấu hình URL máy chủ MCP từ xa trỏ đến Unbox, sau đó xác thực với tài khoản của bạn.
• OpenClaw — Kết nối OpenClaw với endpoint HTTP MCP của Unbox và hoàn tất đăng nhập qua trình duyệt.

Bảo mật

• Đăng nhập qua trình duyệt — Bạn đăng nhập qua Unbox trong trình duyệt — agent không bao giờ thấy mật khẩu của bạn.
• Chỉ chủ tài khoản — Quyền truy cập MCP chỉ giới hạn ở chủ tài khoản cá nhân, không dành cho thành viên nhóm hoặc không gian làm việc chung.
• Giới hạn tương tự như ứng dụng web — Hạn mức gửi, quy tắc spam và chính sách giao dịch áp dụng cho hành động của agent giống như trong giao diện hộp thư đến.
• Không xóa hàng loạt — Agent không thể dọn sạch thư rác, dọn sạch thùng rác hoặc xoay vòng khóa API qua MCP trong phiên bản v1.