---
title: "12 công cụ MCP Mailera: chọn theo việc cần làm"
description: "Tra cứu 12 công cụ MCP Mailera theo tác vụ: đọc, tìm, gửi, trả lời, chuyển thư và đồng bộ. Biết quyền cần cấp và cách đối chiếu kết quả."
url: https://mailera.app/blog/cong-cu-mcp-mailera
published: 2026-10-25
updated: 2026-10-25
---

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

Bảng tra cứu tên công cụ, quyền cần cấp và kết quả nên kiểm tra khi đọc, gửi hoặc chuyển thư trong hộp thư đã kết nối.

## 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](https://mailera.app/blog/ket-noi-email-voi-ai).

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.

| Việc cần làm | Công cụ | Quyền | Chuẩn bị | Kiểm tra kết quả |
| --- | --- | --- | --- | --- |
| Liệt kê hộp thư | `list_mailboxes` | `read` | Xác định hộp thư muốn dùng | Đối chiếu danh sách với Mailera |
| Xem trạng thái hộp thư | `get_mailbox_status` | `read` | Hộp thư cần kiểm tra | Đọc trạng thái được trả về |
| Duyệt thư trong thư mục | `list_messages` | `read` | Hộp thư và thư mục cần xem | Đối chiếu các thư trong danh sách |
| Tìm thư | `search_messages` | `read` | Điều kiện nhận diện thư cần tìm | Kiểm tra đúng thư, đúng hộp thư |
| Đọc nội dung một thư | `get_message` | `read` | Thư đã chọn | So nội dung với thư trên giao diện |
| Lấy mã xác minh mới nhất | `get_latest_otp` | `read` | Hộp thư thử của bạn | Đối chiếu với thư thử, che mã |
| Gửi thư mới | `send_email` | `send` | Người nhận và nội dung đã duyệt | Gọi `get_send_status` |
| Trả lời thư | `reply_to_email` | `send` | Thư gốc và câu trả lời đã duyệt | Kiểm tra người nhận, rồi trạng thái gửi |
| Xem trạng thái gửi | `get_send_status` | `send` | Lần gửi cần kiểm tra | Đọc kết quả trước khi quyết định gửi lại |
| Chuyển một thư | `move_message` | `move` | Thư cần chuyển và thư mục đích | Mở thư mục đích để đối chiếu |
| Đưa thư khỏi Thư rác | `rescue_spam` | `move` | Xác định thư sẽ bị tác động | Kiểm tra vị trí thư sau thao tác |
| Yêu cầu đồng bộ | `sync_mailbox` | `sync` | Hộp thư cần cập nhật | Kiểm tra lại thư và trạng thái đồng bộ |

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](https://mailera.app/blog/cach-ket-noi-email-voi-mailera), 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](https://mailera.app/mcp), hoặc [hướng dẫn tích hợp Claude](https://mailera.app/integrations/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.

![Cài đặt khoá API Mailera với quyền đọc, phạm vi hộp thư và nút sao chép cấu hình MCP.](https://mailera.app/media/fd8cfc2a0640c3a2/12-cong-cu-mcp-mailera-chon-theo-viec-can-lam-api-key-scope-vi-1200.jpg)
_Bắt đầu với quyền read và phạm vi hộp thư thử; chỉ thêm quyền khi tác vụ cần._

Theo [đặc tả công cụ MCP](https://modelcontextprotocol.io/specification/2025-06-18/server/tools), ứ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](https://code.visualstudio.com/docs/agent-customization/mcp-servers) 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.

![Luồng từ dữ liệu thư không tin cậy đến soạn nội dung, người dùng xác nhận, gọi công cụ gửi và kiểm tra trạng thái.](https://mailera.app/media/fbbd1d75756e66fc/12-cong-cu-mcp-mailera-chon-theo-viec-can-lam-send-vi-1200.jpg)
_Đặt bước xác nhận trước lời gọi gửi, rồi kiểm tra lần gửi bằng get\_send\_status._

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?

| Tình huống | Kiểm tra trước |
| --- | --- |
| Gọi công cụ thất bại vì quyền | Đối chiếu quyền trong bảng; chỉ bổ sung quyền tác vụ cần |
| Không thấy công cụ | Kiểm tra điểm kết nối, khoá, cấu hình ứng dụng khách và kết quả `tools/list` |
| Không tìm thấy thư | Kiểm tra hộp thư, thư mục, điều kiện tìm kiếm và đồng bộ |
| Đọc nhầm thư | Đối chiếu thư đã chọn với giao diện trước khi xử lý tiếp |
| Chưa rõ kết quả gửi | Dùng `get_send_status` trước khi cân nhắc gửi lại |
| Không kết nối được hộp thư | Quay lại hướng dẫn kết nối thay vì đổi quyền MCP |

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](https://mailera.app/docs) 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](https://mailera.app/security) 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.

**Cho AI agent dùng hộp thư qua MCP** — Thêm máy chủ MCP của Mailera vào Claude, Cursor hoặc VS Code để agent đọc, phân loại và trả lời thư. [Xem cách dùng MCP](https://mailera.app/docs#mcp)