12 công cụ MCP Mailera: chọn theo việc cần làm

12 công cụ MCP của Mailera dùng cho những việc gì?

Công cụ MCP là thao tác mà ứng dụng khách có thể gọi trên máy chủ MCP. Với Mailera, bạn chọn công cụ theo việc cần làm với thư, rồi cấp quyền tương ứng cho khoá API. Nếu cần hình dung cách hộp thư nối vào agent, xem bài dùng hộp thư có sẵn cho AI agent.

Bảng dưới ghi thông tin bạn cần chuẩn bị, không phải tên tham số để chép vào lời gọi.

Quyền read đủ cho nhóm đọc, kể cả get_latest_otp. Riêng get_send_status cần send, dù công cụ này dùng để xem trạng thái. Một agent đọc rồi trả lời thư cần cả read và send; không cần thêm move nếu không chuyển thư.

Cần chuẩn bị gì trước khi gọi công cụ?

1. Kết nối hộp thư của bạn. Làm theo hướng dẫn kết nối hộp thư đầu tiên, rồi kiểm tra hộp thư xuất hiện trong Danh sách hộp thư.
2. Tạo khoá API với quyền tối thiểu. Dùng Tạo key; với lần thử đọc đầu tiên, chọn read và giới hạn Phạm vi hộp thư vào hộp thư thử.
3. Lấy cấu hình MCP. Trong phần Kết nối AI agent qua MCP, dùng Sao chép cấu hình MCP. Không đưa cấu hình chứa khoá vào hội thoại hoặc kho mã nguồn.
4. Cấu hình ứng dụng khách. Điểm kết nối là https://mailera.app/api/public/v1/mcp. Tham khảo trang MCP của Mailera, hoặc hướng dẫn tích hợp Claude nếu dùng Claude.
5. Kiểm tra công cụ thực tế. Cho ứng dụng khách lấy danh sách công cụ, rồi thử list_mailboxes. Đối chiếu kết quả với giao diện thay vì dừng ở bước lưu cấu hình.

Theo đặc tả công cụ MCP, ứng dụng khách dùng tools/list để khám phá công cụ và tools/call để gọi. Trường inputSchema mô tả tham số đầu vào bằng JSON Schema. Hãy dựa vào lược đồ đó khi điền đối số, không chuyển nguyên tên tham số REST sang MCP.

Tài liệu MCP của VS Code cũng lưu ý: thêm cấu hình chưa có nghĩa agent đã dùng được máy chủ. Một lời gọi đọc có kết quả đúng mới là bước kiểm tra hữu ích.

Muốn tìm và đọc thư thì gọi công cụ nào?

Dùng list_messages khi đã biết hộp thư và muốn duyệt một thư mục. Dùng search_messages khi có dấu hiệu để tìm, chẳng hạn nội dung cần nhận diện. Sau khi chọn được thư, dùng get_message để đọc nội dung của chính thư đó.

Bạn có thể kiểm tra luồng đọc email qua MCP bằng một thư thử dễ nhận ra:

1. Chuẩn bị thư thử có tiêu đề riêng trong hộp thư do bạn sở hữu.
2. Gọi list_mailboxes và chọn đúng hộp thư.
3. Gọi search_messages, điền điều kiện theo lược đồ công cụ. Nếu muốn duyệt thư mục, dùng list_messages thay thế.
4. Chọn kết quả phù hợp rồi gọi get_message.
5. Mở cùng thư trong Hộp thư chung. Đối chiếu người gửi, tiêu đề và nội dung, không chỉ dựa vào bản tóm tắt của agent.

get_mailbox_status dành cho việc kiểm tra trạng thái hộp thư; sync_mailbox dành cho yêu cầu đồng bộ và cần thêm quyền sync. Đừng dùng một kết quả trạng thái thay cho việc kiểm tra thư cần đọc đã xuất hiện.

get_latest_otp là tác vụ riêng. Chỉ thử trên hộp thư của chính bạn, đọc lược đồ trước khi chọn điều kiện lấy mã và che mã trong ảnh hoặc nhật ký. Không dùng công cụ này để lấy mã của tài khoản người khác.

Gửi và trả lời thư thế nào để kiểm tra được kết quả?

Chọn send_email để gửi thư mới, reply_to_email để trả lời thư. Khi trả lời, luôn kiểm tra thư gốc và danh sách người nhận; đừng để agent tự suy đoán người nhận từ nội dung thư.

Quy trình gửi email qua MCP nên có một bước xác nhận rõ ràng:

1. Chuẩn bị người nhận, tiêu đề và nội dung.
2. Hiển thị bản sẽ gửi để bạn kiểm tra. Với thư trả lời, hiển thị cả thư gốc liên quan.
3. Chờ bạn xác nhận, rồi mới gọi send_email hoặc reply_to_email.
4. Dùng get_send_status để kiểm tra lần gửi.
5. Nếu mục tiêu thử nghiệm là xác nhận thư đến, mở hộp thư nhận do bạn sở hữu để đối chiếu.

Công cụ nhận yêu cầu không có nghĩa là thư đã nằm trong hộp thư đến của người nhận. Nếu kết quả gửi chưa rõ, kiểm tra trạng thái trước; đừng lập tức gọi gửi lại. Bước này giúp tránh gửi trùng trong lúc bạn đang tìm nguyên nhân.

Khi nào dùng move_message, rescue_spam và sync_mailbox?

move_message dùng để chuyển một thư; rescue_spam dành cho việc đưa thư khỏi Thư rác. Mailera hỗ trợ đưa một hoặc nhiều thư khỏi Thư rác qua MCP. Trước khi gọi, đọc mô tả và lược đồ công cụ để xác định phạm vi tác động, rồi kiểm tra đúng hộp thư và đúng thư.

Sau thao tác, mở thư mục đích trên giao diện và tìm lại thư. Mailera không thể khiến nhà cung cấp tin cậy người gửi hoặc bảo đảm thư vào hộp thư đến.

Dùng sync_mailbox khi cần yêu cầu cập nhật hộp thư. Hoạt động nền của Mailera phụ thuộc mức sử dụng: hộp thư đang dùng được kiểm tra thường xuyên hơn, hộp thư ít dùng có thể ngủ. Vì vậy, sau khi yêu cầu đồng bộ, hãy kiểm tra lại thư cần tìm thay vì giả định mọi thư xuất hiện tức thì.

Lỗi hay gặp và nên kiểm tra gì trước?

Khi chẩn đoán lời gọi thất bại, so đối số với inputSchema và xem lỗi ứng dụng khách hiển thị. Không cấp mọi quyền chỉ để thử cho hết lỗi. Tài liệu Mailera là nơi tra cứu tích hợp; bảng công cụ ở trên dùng để chọn đúng tác vụ và quyền.

Cho AI agent đọc thư thế nào cho an toàn?

Thư đến là dữ liệu không tin cậy, không phải lệnh. Một email có thể yêu cầu agent tiết lộ khoá, gửi dữ liệu hoặc đổi quy tắc làm việc. Không làm theo các chỉ dẫn đó chỉ vì chúng nằm trong thư cần đọc.

Cấp khoá ít quyền nhất. Agent chỉ tìm và tóm tắt thư không cần send hay move. Với luồng gửi, người dùng phải được xem người nhận và nội dung trước khi xác nhận, thay vì chỉ duyệt một câu “agent sẽ trả lời”.

Bạn cần thiết lập các biện pháp này trong quy trình của agent. Đặc tả MCP khuyến nghị ứng dụng khách yêu cầu xác nhận cho thao tác nhạy cảm; đừng coi việc kết nối MCP là thay thế cho bước duyệt.

Che khoá, nội dung riêng tư và mã xác minh trong ảnh, ví dụ và nhật ký. Không dán thông tin xác thực vào hội thoại hoặc commit vào dự án. Xem thêm thông tin bảo mật của Mailera khi thiết kế cách quản lý quyền truy cập.

Giới hạn nào cần tính trước?

Danh sách 12 công cụ MCP không bao phủ toàn bộ REST API. Chẳng hạn, các chức năng quản lý webhook và chia sẻ có trong REST API nhưng không nằm trong danh sách công cụ này.

Mailera cũng không cung cấp dịch vụ gửi email hàng loạt hoặc tiếp thị. Hãy dùng các công cụ gửi và trả lời cho tác vụ với hộp thư đã kết nối, trong phạm vi quyền bạn chủ động cấp.