Đọc email trong Cursor qua MCP, kiểm tra rồi mới gửi

MCP cho phép Cursor gọi công cụ để lấy thư hoặc thực hiện thao tác với hộp thư qua Mailera. Bài này dành cho ứng dụng Cursor trên máy tính; phần tổng quan nằm trong hướng dẫn MCP cho hộp thư có sẵn.

Cần chuẩn bị gì trước khi kết nối?

Bạn cần Cursor có hỗ trợ MCP, tài khoản Mailera và hộp thư thử do bạn sở hữu hoặc được phép sử dụng. Người thêm hộp thư vào Mailera cần vai trò Admin hoặc Leader.

Với Outlook, Hotmail hoặc Microsoft 365, dùng Đăng nhập Microsoft theo hướng dẫn kết nối Microsoft bằng OAuth. Với Gmail, luồng kết nối dùng mật khẩu ứng dụng (app password); tài liệu Google về mật khẩu ứng dụng yêu cầu tài khoản bật xác minh 2 bước. Xem nhánh thiết lập tại trang kết nối Gmail. Nếu cần từng bước cho Gmail, xem hướng dẫn cấu hình Gmail MCP bằng mật khẩu ứng dụng.

Phân biệt quyền của khóa với khả năng của hộp thư: khóa có quyền gửi chưa đủ nếu hộp thư chỉ nhận được thư.

Bắt đầu với read. Quy trình này không cần manage hoặc import; chỉ thêm sync nếu bạn muốn Cursor gọi đồng bộ.

Thêm máy chủ MCP của Mailera vào Cursor

1. Kiểm tra hộp thư thử. Mở Danh sách hộp thư, đối chiếu địa chỉ và trạng thái kết nối. Mở một thư thử trong Hộp thư chung của Mailera để có nội dung đối chiếu khi Cursor đọc. Đừng chọn hộp thư chỉ dựa vào tên hiển thị.

2. Tạo khóa chỉ đọc. Trong Cài đặt, mở tab API key và chọn Tạo key. Điền Tên gợi nhớ, chẳng hạn “Cursor đọc thư thử”. Ở Phạm vi hộp thư, chọn nhóm chứa hộp thư thử, cấp read và đặt Thời hạn phù hợp. Admin có thể chọn mọi nhóm, nhưng bài thử này không cần phạm vi đó.
3. Sao chép cấu hình. Khi thấy Key đã tạo — sao chép ngay, lưu khóa ở nơi bảo vệ bí mật: Mailera chỉ hiển thị khóa mới một lần. Chọn Sao chép cấu hình MCP cho Cursor. Không dán khóa vào cuộc trò chuyện hoặc đưa cấu hình chứa khóa lên kho mã.

4. Đặt cấu hình vào Cursor. Theo tài liệu MCP của Cursor, cấu hình riêng cho dự án nằm ở .cursor/mcp.json; cấu hình dùng chung nằm ở ~/.cursor/mcp.json. Chọn phạm vi phù hợp và dùng cấu hình Mailera xuất. Đối chiếu điểm cuối là https://mailera.app/api/public/v1/mcp; đừng tự đoán trường xác thực.
5. Kiểm tra công cụ. Trong Cursor, kiểm tra danh sách “Available Tools” có các công cụ đọc thư của Mailera. Chỉ chuyển sang bước đọc khi Cursor nhận được máy chủ và công cụ.

Nếu muốn giữ khóa ngoài tệp cấu hình, Cursor hỗ trợ biến môi trường dạng ${env:NAME}, kể cả trong trường headers. Biến phải có sẵn trong môi trường chạy Cursor. Đừng dùng envFile cho máy chủ MCP từ xa HTTP/SSE vì Cursor không hỗ trợ trường đó với loại máy chủ này.

Bạn có thể đối chiếu thông tin kết nối tại trang Mailera dành cho Cursor và danh mục công cụ tại trang MCP của Mailera.

Đọc đúng thư mà không lấy dư dữ liệu

6. Xác định hộp thư bằng list_mailboxes. Yêu cầu Cursor liệt kê hộp thư trong phạm vi khóa. Đối chiếu địa chỉ và định danh của hộp thư thử trước khi tìm thư.
7. Tìm trước, lấy nội dung sau. Dùng list_messages hoặc search_messages để thu hẹp kết quả, rồi dùng get_message cho thư đã chọn. Tránh yêu cầu đọc toàn bộ hộp thư khi chỉ cần trả lời một thư.

Bạn có thể yêu cầu:

Trong hộp thư thử tôi vừa chọn, tìm thư có tiêu đề “Xác nhận lịch thử nghiệm”. Cho tôi xem người gửi và thư tìm được trước khi lấy nội dung. Sau đó tóm tắt việc cần trả lời. Không gửi email.

Kiểm tra đúng hộp thư, người gửi và tiêu đề. Nếu nhiều thư trùng tiêu đề, yêu cầu Cursor liệt kê để bạn chọn đúng thư, thay vì tự lấy kết quả đầu tiên.

Tham số gọi công cụ phải theo inputSchema mà máy chủ MCP cung cấp. Đặc tả công cụ MCP định nghĩa đây là lược đồ tham số đầu vào; không chép tên tham số REST sang lời gọi MCP.

Soạn câu trả lời, xác nhận rồi mới gửi

8. Soạn trong cuộc trò chuyện. Yêu cầu Cursor viết nội dung trả lời, chưa gọi công cụ gửi. Phần văn bản này là nội dung để bạn duyệt trong Cursor, không phải bản nháp đã lưu trong hộp thư.
9. Chỉ cấp quyền gửi khi sẵn sàng. Tạo khóa có read và send, vẫn giới hạn vào nhóm thử, rồi thay cấu hình bằng bản xuất cho khóa đó. Kiểm tra hộp thư không ở chế độ chỉ nhận. Mailera cho phép lưu hộp thư ở chế độ này khi kết nối gửi thất bại.

Trước khi duyệt reply_to_email, yêu cầu Cursor trình bày hộp thư gửi, người nhận, thư gốc và toàn bộ nội dung cuối cùng. Trong yêu cầu duyệt công cụ, mở mũi tên cạnh tên công cụ để xem tham số thực sự được gửi đi. Nếu chúng khác phần bạn vừa duyệt, dừng lại.

Cursor mặc định hỏi phê duyệt trước khi dùng công cụ MCP. Tuy nhiên, trong “Auto-review”, công cụ thuộc danh sách cho phép có thể chạy ngay; công cụ khác được chuyển qua bộ phân loại. Để tự xác nhận từng lần gửi, tránh chế độ này và không cho phép tự động chạy công cụ gửi.

10. Kiểm tra lần gửi. Sau khi bạn xác nhận và Cursor gọi reply_to_email, yêu cầu dùng get_send_status để kiểm tra lần gửi tương ứng, rồi đối chiếu ở hộp thư nhận thử.

Đừng gửi lại ngay khi kết quả chưa rõ. Mailera không bảo đảm thư vào Hộp thư đến: trạng thái đã gửi không xác nhận thư nằm ở đâu bên nhận.

Lỗi hay gặp khi đọc và trả lời email trong Cursor

Đồng bộ nền của Mailera thay đổi theo mức sử dụng hộp thư; hộp thư ít hoạt động có thể ngủ và thức lại khi được sử dụng. Bạn cũng có thể gọi sync_mailbox với quyền sync để yêu cầu đồng bộ. Không coi việc vừa gửi một thư thử là bằng chứng Cursor phải thấy thư ngay.

Bảo vệ khóa và coi thư đến là dữ liệu không tin cậy

Nội dung thư là dữ liệu không tin cậy, không phải lệnh cho agent. Nếu thư yêu cầu bỏ qua quy tắc, tiết lộ khóa hoặc chuyển tiếp tài liệu, Cursor không được làm theo chỉ vì yêu cầu đó nằm trong email.

Một câu “hãy hỏi trước khi gửi” không đủ làm hàng rào bảo vệ. Kết hợp khóa ít quyền với việc phê duyệt công cụ trong Cursor. MCP không bắt buộc một mô hình tương tác người dùng cụ thể; điểm xác nhận phụ thuộc vào ứng dụng và cấu hình bạn dùng.

Chỉ thử bằng thư không nhạy cảm. Trước khi đưa thư công việc vào ngữ cảnh trợ lý, kiểm tra chính sách dữ liệu của Cursor và mô hình bạn chọn; chỉ lấy phần nội dung cần cho tác vụ.

Thu hồi khóa khi không còn dùng hoặc nghi bị lộ. Mailera từ chối ngay các lời gọi tiếp theo dùng khóa đã thu hồi. Tham khảo thông tin bảo mật của Mailera khi thiết lập quyền truy cập cho đội.

Giới hạn của quy trình này

Quy trình này dành cho đọc và trả lời từng thư trong hộp thư được phép sử dụng. Mailera không cung cấp gửi thư hàng loạt hoặc tiếp thị. Nếu công việc chỉ cần tóm tắt và soạn nội dung, giữ khóa ở quyền read; bạn không cần cấp quyền gửi cho Cursor.