MCPAgent

Dùng agent của riêng bạn.

Kết nối Claude, ChatGPT, Gemini CLI, GitHub Copilot, Cursor hoặc code của riêng bạn với một hộp thư, với cùng các bước kiểm tra như agent của chúng tôi.

01

Trước khi bắt đầu

  • Một nhóm MySendbox đã bật Agents, và có ít nhất một hộp thư.
  • Một chủ sở hữu trong nhóm để duyệt kết nối.
  • Để agent trả lời được, chứ không chỉ đọc: mở cài đặt của hộp thư trên bảng điều khiển và đặt Who answers thành “Your connected agent” hoặc “Either”.

Chưa có tài khoản? Cứ thêm máy chủ và chọn “Create a workspace for your agent” khi được yêu cầu đăng nhập. Agent đọc được thư ngay; trả lời bắt đầu khi bạn có gói.

02

Thêm máy chủ vào ứng dụng của bạn

Máy chủ dùng Streamable HTTP và đăng nhập bằng OAuth, nên hầu hết ứng dụng chỉ cần URL.

URL máy chủClaude, ChatGPT
https://mcp.mysendbox.com/mcp
  • Claude (web và desktop): thêm MySendbox từ danh mục connector của Claude, hoặc vào Cài đặt → Connector → Thêm connector tùy chỉnh và dán URL.
  • ChatGPT: thêm làm connector tùy chỉnh (máy chủ MCP) với cùng URL.
Claude Code
claude mcp add --transport http mysendbox https://mcp.mysendbox.com/mcp
Gemini CLI
gemini mcp add --scope user --transport http mysendbox https://mcp.mysendbox.com/mcp
Hoặc trong phần cài đặt của Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "mysendbox": { "httpUrl": "https://mcp.mysendbox.com/mcp" }
  }
}

Sau đó chạy /mcp auth mysendbox trong Gemini CLI để đăng nhập và duyệt kết nối trên trình duyệt.

GitHub Copilot trong VS Code.vscode/mcp.json
{
  "servers": {
    "mysendbox": { "type": "http", "url": "https://mcp.mysendbox.com/mcp" }
  }
}

Chọn Start phía trên máy chủ trong tệp, đăng nhập khi VS Code yêu cầu, rồi dùng từ Copilot Chat ở chế độ agent.

Cursor và các ứng dụng khácmcp.json
{
  "mcpServers": {
    "mysendbox": { "url": "https://mcp.mysendbox.com/mcp" }
  }
}
03

Duyệt kết nối

Lần đầu agent kết nối, ứng dụng của bạn sẽ mở một trang trên app.mysendbox.com. Đăng nhập với tư cách chủ sở hữu, chọn các hộp thư agent được dùng, và chọn quyền truy cập:

  • Đọc: đọc và tìm kiếm thư.
  • Soạn nháp: đọc, sắp xếp, và soạn nháp để một người trong đội ngũ gửi đi.
  • Trả lời: đọc, sắp xếp và trả lời. Thư trả lời được kiểm tra, và chờ một người xem xét khi có rủi ro.
04

Công cụ

Công cụtheo quyền truy cập
read    list_mailboxes  list_messages  search_messages
        get_message  get_thread  get_attachment  get_reply
        account_status   → what it may do in each mailbox, credits
        wait_for         → the reply it's waiting for, as it arrives
        wait_for_code    → the code or link from a sign-up email
        list_threads     → where each conversation stands
draft   + mark_read  move_messages  draft_reply  draft_email
        + set_thread     → a note or a follow-up date on a conversation
reply   + send_reply   → sent, or waits for review
        + send_email   → a new email: waits for a person to approve it,
                         unless the mailbox sends on its own

Đăng ký hoặc đăng nhập ở đâu đó bằng địa chỉ của hộp thư? Gửi biểu mẫu, rồi gọi wait_for_code: lệnh này chờ email tối đa 30 giây và trả về mã dùng một lần hoặc liên kết xác minh.

Với thư cần trả lời, lọc theo category: "personal". Các loại khác là updates, newsletters và promotions.

Khi đã kết nối, cứ hỏi bằng lời thường:

read · search_messagesHôm nay support@ nhận được những thư nào vẫn chưa được trả lời?
draft · draft_replySoạn nháp trả lời các câu hỏi về đơn hàng chưa được trả lời, để tôi kiểm tra.
read · wait_for_codeĐăng ký Acme bằng bookings@ và hoàn tất bước xác minh email.
draft · move_messagesChuyển các bản tin tuần này ra khỏi hộp thư đến, vào Lưu trữ.
reply · send_email · wait_forHỏi báo giá 40 chiếc ghế từ ba nhà cung cấp, và cho tôi biết bên nào rẻ nhất khi họ trả lời.

Đang chờ thư trả lời? Ngay sau send_email hoặc send_reply, gọi wait_for với thread_id của cuộc hội thoại: lệnh này trả về thư trả lời ngay khi nó đến, tối đa 30 giây mỗi lần gọi, để agent của bạn không phải liệt kê hộp thư đến hết lần này đến lần khác.

Mỗi thư đều kèm các thông tin chính: ngày, số tiền, mã vận đơn, lời mời, và người gửi có đang hỏi gì không. Thường chừng đó đã đủ để xử lý mà không cần đọc cả email.

Agent chạy dưới dạng máy chủ có thể được đánh thức bằng webhook message.received; webhook này mang cùng các thông tin đó.

05

Agent không cần người đăng nhập

Máy chủ và script có thể bỏ qua OAuth và gửi khóa API làm bearer token. Tạo khóa trên bảng điều khiển trong mục API keys, với các phạm vi quyền agent cần, hoặc để agent tự đăng ký và nhận khóa cùng hộp thư đến riêng:

Header
Authorization: Bearer msb_live_…
  • messages:read để đọc, drafts:write để soạn nháp, replies:send để trả lời.
  • messages:write để sắp xếp: đánh dấu đã đọc và chuyển thư.
06

Những gì luôn an toàn

  • Thư trả lời, và email mới do một người duyệt. Thư trả lời chỉ gửi đến người đã viết thư, trong cùng chuỗi thư, mỗi thư một lần. Email mới được gửi từ chính tên miền của bạn đến tối đa 10 người, và chờ một người duyệt trừ khi hộp thư được đặt để tự gửi.
  • Cùng bước kiểm tra, cùng quy trình duyệt. Mọi thư trả lời đều được kiểm tra rò rỉ và các lệnh cài cắm trong email. Thư rủi ro sẽ chờ một người duyệt, dù agent nào viết.
  • Thư bên ngoài vẫn là thư bên ngoài. Thư đến tay agent được đánh dấu là không đáng tin, kèm kết quả kiểm tra. Thư bị cách ly không bao giờ được hiển thị.
  • Mọi lệnh gọi đều được ghi lại. Mỗi lệnh gọi công cụ được ghi nhật ký cùng agent, hộp thư và kết quả. Mỗi kết nối giới hạn 120 yêu cầu một phút, bên cạnh giới hạn hằng ngày của từng hộp thư.

Tìm hiểu thêm cách chúng tôi giữ email luôn được người nhận mong muốn: An toàn.

07

Ngắt kết nối

Chủ sở hữu thấy mọi agent đã kết nối trong mục Connect agent, và có thể ngắt kết nối ngay lập tức.