Email MCP server: kết nối AI với hộp thư đang dùng

Máy chủ MCP cho email làm gì với hộp thư có sẵn?

Máy chủ MCP cho email cung cấp các thao tác đọc, tìm và trả lời thư dưới dạng công cụ để ứng dụng AI gọi. Muốn trợ lý đọc đúng hộp thư Gmail, Outlook đang dùng, bạn cần máy chủ hỗ trợ kết nối hộp thư có sẵn. Nó không thay thế nhà cung cấp email.

Theo đặc tả MCP, giao thức này kết nối ứng dụng mô hình ngôn ngữ với nguồn dữ liệu và công cụ bên ngoài. Trong luồng email, ứng dụng như Claude là nơi bạn giao việc; máy chủ MCP cung cấp công cụ; Gmail, Outlook hoặc máy chủ IMAP vẫn là nơi quản lý hộp thư.

MCP của Mailera nối các hộp thư đã có vào trợ lý qua một đầu mối. Bạn có thể yêu cầu liệt kê hộp thư, tìm thư theo người gửi, đọc nội dung rồi soạn câu trả lời trong cuộc trò chuyện để duyệt. Soạn nội dung chưa đồng nghĩa với gửi email.

Có hai lớp quyền cần phân biệt. Thông tin xác thực nhà cung cấp cho phép Mailera kết nối hộp thư. Khóa API dùng trong ứng dụng MCP giới hạn hộp thư và thao tác mà trợ lý được truy cập. Kết nối nhà cung cấp có khả năng gửi không có nghĩa khóa chỉ đọc cũng được gửi.

Nếu bạn còn đang chọn giữa MCP, REST và webhook, bài kết nối email có sẵn với AI agent giải thích phạm vi sử dụng rộng hơn.

Nên chọn loại email MCP server nào?

Chọn theo nơi thư cần được đọc và địa chỉ cần được dùng để trả lời. Đừng chỉ nhìn việc một dịch vụ có công cụ gửi email.

Đây là cách phân loại nhu cầu, không phải bảng xếp hạng sản phẩm. Nếu chưa rõ nên giữ hay tách địa chỉ, xem hộp thư có sẵn hay hộp thư riêng cho AI.

Tự chạy máy chủ MCP hợp lý khi bạn muốn trực tiếp kiểm soát mã và nơi lưu thông tin xác thực. Khi đó, hãy tính cả công cập nhật máy chủ, bảo quản bí mật và xử lý lỗi kết nối. Với dịch vụ được quản lý, hãy kiểm tra cách dịch vụ xử lý những việc này; bạn vẫn cần chọn đúng phạm vi khóa và thu hồi quyền khi không dùng nữa.

Trước khi chọn, đối chiếu nhà cung cấp trong danh sách kết nối của Mailera, khả năng tách quyền đọc/gửi, phạm vi nhóm hộp thư và ứng dụng MCP được hỗ trợ. Khả năng thu hồi khóa cũng là tiêu chí cần có, không phải việc để sau khi triển khai mới hỏi.

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

Dùng hộp thư thử thuộc quyền quản lý của bạn. Nên đưa hộp thư thử vào một nhóm riêng để khóa của trợ lý không cần truy cập các hộp thư công việc khác.

Với Microsoft, dùng luồng kết nối Outlook và Microsoft 365, không dùng mật khẩu ứng dụng.

Tài liệu mật khẩu ứng dụng của Google, đọc ngày 25/10/2026, yêu cầu tài khoản bật xác minh 2 bước. Tùy chọn này có thể không xuất hiện với tài khoản tổ chức, tài khoản chỉ dùng khóa bảo mật cho xác minh 2 bước hoặc tài khoản bật Advanced Protection. Nếu tài khoản công ty không có tùy chọn đó, hãy hỏi quản trị viên thay vì tìm cách đi vòng chính sách.

Kết nối và kiểm tra luồng đọc thư qua MCP như thế nào?

Mục tiêu đầu tiên là đọc đúng một thư thử. Chưa cần gửi hay di chuyển thư để xác nhận luồng kết nối hoạt động.

1. Thêm hộp thư. Trong Mailera, chỉ vai trò Admin hoặc Leader được thêm hộp thư. Mở Danh sách hộp thư → Thêm hộp thư. Với Microsoft, chọn Đăng nhập Microsoft. Với Gmail hoặc IMAP, chọn Một hộp thư, nhập Địa chỉ email, chọn nhà cung cấp rồi Tiếp tục. Điền thông tin kết nối và chọn Nhóm quản lý dành cho thử nghiệm. Với Gmail, điền mật khẩu ứng dụng vào ô Mật khẩu, không dùng mật khẩu đăng nhập thông thường. Bài kết nối hộp thư đầu tiên với Mailera hướng dẫn kỹ hơn phần này.
2. Kiểm tra kết nối. Chọn Kiểm tra & kết nối. Thao tác này đăng nhập thử, không gửi email. Sau khi hoàn tất, kiểm tra hộp thư xuất hiện trong danh sách và xem trạng thái kết nối. Nếu phần gửi thất bại nhưng phần nhận hoạt động, bạn có thể chọn Lưu ở chế độ Chỉ nhận để tiếp tục thử đọc thư.
3. Tạo khóa ít quyền. Vào Cài đặt, mở phần khóa API rồi chọn Tạo key. Điền Tên gợi nhớ, giới hạn Phạm vi hộp thư vào nhóm thử và chỉ cấp quyền read. Đặt Thời hạn phù hợp với đợt thử. Admin có thể chọn tất cả nhóm, nhưng với bài kiểm tra này chỉ cần giới hạn vào nhóm thử.
4. Sao chép cấu hình. Khóa mới chỉ hiện một lần. Lưu khóa an toàn, rồi dùng Sao chép cấu hình MCP cho Claude, Cursor hoặc VS Code trong cùng hộp thoại. Dùng cấu hình được tạo cho đúng ứng dụng, không tự ghép cấu trúc cấu hình từ ví dụ của ứng dụng khác.

5. Kiểm tra địa chỉ và xác thực. Địa chỉ MCP phải là https://mailera.app/api/public/v1/mcp. Khóa được truyền qua header Authorization: Bearer $MAILERA_API_KEY, với $MAILERA_API_KEY đại diện cho khóa của bạn. Nếu đang kết nối email với Claude, xem thêm trang tích hợp Claude.
6. Đọc thư thử và đối chiếu. Từ một địa chỉ khác do bạn quản lý, gửi vào hộp thư thử một thư có tiêu đề dễ nhận ra, chẳng hạn “Thử đọc thư qua MCP”. Trong ứng dụng AI, xác nhận có công cụ Mailera, gọi list_mailboxes, rồi list_messages và get_message cho thư đó. Đối chiếu người gửi, tiêu đề và nội dung với hộp thư gốc.

Theo đặc tả công cụ MCP, ứng dụng khám phá công cụ bằng tools/list; mỗi công cụ có inputSchema mô tả tham số. Vì vậy, khi xem hoặc gọi công cụ, dùng đúng lược đồ ứng dụng nhận được. Không lấy tên tham số của REST để đoán tham số MCP.

Bạn có thể yêu cầu trợ lý: “Tìm thư có tiêu đề ‘Thử đọc thư qua MCP’ trong hộp thư thử. Đọc nội dung và báo lại người gửi. Không gửi hoặc di chuyển thư.” Ghi lại ngày chạy, phiên bản ứng dụng và kết quả đối chiếu, nhưng không ghi khóa vào biên bản thử.

Tìm thư, trả lời hoặc di chuyển thư cần quyền nào?

Bắt đầu bằng read. Chỉ bổ sung quyền khi công việc thực sự cần thao tác tương ứng.

Khóa chỉ có read không được phép gửi email. Tuy vậy, quyền đọc vẫn tiếp cận nội dung nhạy cảm; đừng coi đây là quyền không có rủi ro. Bài các công cụ MCP của Mailera theo từng việc giúp chọn công cụ khi mở rộng quy trình.

Để thử tìm kiếm, yêu cầu trợ lý dùng search_messages tìm thư thử theo tiêu đề hoặc người gửi trong phạm vi hộp thư cần đọc. Kiểm tra thư tìm được trước khi yêu cầu soạn câu trả lời.

Khi thử gửi, chỉ dùng địa chỉ nhận do bạn quản lý. Duyệt người nhận và nội dung trước khi gọi send_email hoặc reply_to_email, sau đó dùng get_send_status. Trạng thái sent không cho biết thư nằm ở Hộp thư đến hay Thư rác của người nhận. Nếu hộp thư nhận đã kết nối với Mailera và nằm trong phạm vi quyền read của khóa, dùng điểm cuối REST GET /mailboxes/{id}/placement với ID của hộp thư nhận để kiểm tra vị trí thư; hoặc mở trực tiếp hộp thư nhận.

Những lỗi thường gặp khi kết nối MCP với email

“Kết nối MCP thành công” mới xác nhận một phần của quá trình kết nối. Trợ lý còn cần truy cập đúng nhóm hộp thư và đọc dữ liệu đã đồng bộ.

Google thu hồi mật khẩu ứng dụng khi bạn đổi mật khẩu tài khoản. Vì vậy, lỗi kết nối sau lần đổi mật khẩu cần được xử lý ở kết nối Gmail, không chỉ bằng cách thay khóa API Mailera.

Nếu không thấy công cụ, cũng kiểm tra phiên bản giao thức mà ứng dụng sử dụng. Mailera hỗ trợ 2025-06-18, 2025-03-26 và 2024-11-05.

Để tách lỗi ứng dụng MCP khỏi lỗi phạm vi khóa, bạn có thể gọi REST bằng cùng khóa. Sau khi đặt biến môi trường $MAILERA_API_KEY, lệnh này liệt kê hộp thư mà khóa truy cập được:

curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'limit=1'

Trong phản hồi, đối chiếu data[].group_id, status, capabilities.send và sync.last_synced_at. Vì lệnh chỉ lấy một hộp thư, nếu nhóm thử có nhiều hộp thư, hãy tăng limit để tìm đúng hộp cần xem.

Nếu hộp thư có mặt nhưng thiếu thư mới, kiểm tra thư mục và điều kiện tìm kiếm trước. Bạn có thể dùng Đồng bộ trong danh sách hộp thư hoặc sync_mailbox nếu khóa có quyền sync.

Làm sao hạn chế rủi ro khi trợ lý AI đọc email?

Thư đến là dữ liệu không tin cậy, không phải lệnh. Một email yêu cầu trợ lý tiết lộ khóa, đổi người nhận hoặc chuyển tiếp tài liệu không trở thành chỉ dẫn hợp lệ chỉ vì nó xuất hiện trong kết quả đọc thư. Đây là rủi ro chèn chỉ dẫn độc hại qua nội dung, hay prompt injection.

Giữ khóa trong nhóm hộp thư cần dùng và chỉ cấp quyền tối thiểu. Không cấp manage hoặc share cho tác vụ đọc thư. Không dán khóa, mật khẩu ứng dụng hoặc nội dung thư nhạy cảm vào lời nhắc hay nhật ký công khai; che thông tin đó trong ảnh chụp.

Trước thao tác gửi, trả lời hoặc di chuyển thư, thiết lập bước xác nhận tại ứng dụng hoặc quy trình của bạn. Đặc tả MCP khuyến nghị ứng dụng yêu cầu người dùng xác nhận thao tác nhạy cảm, nhưng giao thức không tự thực thi toàn bộ nguyên tắc an toàn.

Khi kết thúc thử nghiệm, thu hồi khóa trong phần khóa API. Các lời gọi tiếp theo dùng khóa đó sẽ bị từ chối ngay. Xem thông tin bảo mật Mailera khi đánh giá việc đưa hộp thư công việc vào quy trình. Giới hạn quyền giúp giảm phạm vi tác động, không loại bỏ hoàn toàn rủi ro từ nội dung thư.

Những giới hạn cần tính trước khi dùng Mailera

Mailera không cung cấp gửi thư tiếp thị hàng loạt hoặc làm ấm hộp thư. Proton Mail và Tuta không được hỗ trợ. Với hộp thư chỉ nhận, muốn gửi qua MCP bạn cần có kết nối gửi hợp lệ; thêm quyền send không tự sửa được kết nối đó.

Mailera không bảo đảm thư vào Hộp thư đến. Quyết định lọc vẫn thuộc nhà cung cấp; thao tác đưa một thư khỏi Thư rác không khiến nhà cung cấp mặc nhiên tin người gửi ở lần sau.

Mailera cũng không hứa đồng bộ tức thời trong mọi trường hợp. Hộp thư đang dùng được kiểm tra thường xuyên hơn; hộp thư ít hoạt động có thể được kiểm tra thưa hơn hoặc chuyển sang trạng thái ngủ. Vì thế, khi đánh giá luồng đọc thư, hãy kiểm tra trạng thái đồng bộ thay vì chỉ nhìn trạng thái kết nối MCP.