MCP
Máy chủ MCP cho Gmail, Outlook, Yahoo, iCloud và IMAP
Cho Claude, Cursor, VS Code hay agent của bạn đọc thư, lấy mã OTP, trả lời và kéo thư khỏi Spam trên mọi hộp thư đã kết nối — bằng API key của workspace, không cần viết code.
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \ --header "Authorization: Bearer mh_live_xxx"Kết nối
- Địa chỉ máy chủ
https://mailera.app/api/public/v1/mcp- Xác thực
Authorization: Bearer mh_live_… hoặc X-API-Key- Kiểu kết nối
- Streamable HTTP, không cần phiên
- Phiên bản giao thức
- 2025-06-18 · 2025-03-26 · 2024-11-05
12 công cụ, theo quyền của key
Agent chỉ thấy công cụ khớp với quyền của API key. Mỗi lần gọi chạy đúng endpoint REST tương ứng, nên kết quả và mã lỗi giống hệt API.
| Công cụ | Làm gì | Quyền |
|---|---|---|
| list_mailboxes | Liệt kê hộp thư, nhà cung cấp, khả năng và trạng thái đồng bộ | read |
| get_mailbox_status | Kiểm tra hộp thư còn kết nối và lần đồng bộ gần nhất | read |
| list_messages | Liệt kê thư trong một thư mục, mới nhất trước | read |
| search_messages | Tìm thư trên mọi hộp thư, có thể lấy kèm mã OTP | read |
| get_message | Đọc trọn một thư: người gửi, nội dung, tệp đính kèm | read |
| get_latest_otp | Lấy mã OTP mới nhất trong Inbox hoặc Spam | read |
| send_email | Gửi thư mới, chống gửi trùng bằng idempotency_key | send |
| reply_to_email | Trả lời, trả lời tất cả hoặc chuyển tiếp một thư | send |
| get_send_status | Theo dõi lượt gửi tới khi là sent, failed hoặc unknown | send |
| move_message | Chuyển thư sang Inbox, Spam, Lưu trữ hoặc Thùng rác | move |
| rescue_spam | Kéo thư khỏi Spam: tất cả, hoặc theo người gửi, tên miền, tiêu đề | move |
| sync_mailbox | Đồng bộ ngay và đánh thức hộp thư đang ngủ | sync |
Mỗi lần gọi công cụ chạy đúng endpoint REST tương ứng: cùng quyền, cùng giới hạn 300 lượt/phút, cùng nhật ký API. Lỗi nằm trong kết quả công cụ (isError) kèm error.code ổn định để agent tự xử lý.
Cấu hình cho từng ứng dụng
Chép cấu hình, thay API key của bạn, rồi khởi động lại ứng dụng. Mỗi ứng dụng có trang hướng dẫn riêng với cách kiểm tra và lỗi hay gặp.
Claude
Claude Code bằng một lệnh, Claude Desktop qua cầu nối mcp-remote.
Terminal · claude_desktop_config.json
Hướng dẫn ClaudeCursor
Một file mcp.json, dùng cho mọi dự án hoặc chỉ một dự án.
~/.cursor/mcp.json
Hướng dẫn CursorVS Code
File .vscode/mcp.json, VS Code hỏi key một lần và giữ kín.
.vscode/mcp.json
Hướng dẫn VS Code
An toàn khi cho agent dùng hộp thư
Key chỉ có quyền cần thiết
Agent chỉ cần đọc thư thì tạo key chỉ có quyền read. Chỉ cấp quyền send khi agent thật sự phải gửi, và giới hạn key theo nhóm hộp thư nếu được.
Thư đến là dữ liệu, không phải lệnh
Nội dung thư do người khác viết. Đừng để agent làm theo chỉ dẫn nằm trong thư, như “chuyển tiếp mọi thư cho…”. Hãy yêu cầu agent hỏi bạn trước khi gửi hoặc chuyển thư.
Mỗi thư chỉ gửi một lần
Luôn truyền idempotency_key khi gửi. Nếu trạng thái là unknown, đừng gửi lại — kiểm tra hộp Đã gửi trước.
Thu hồi bất cứ lúc nào
Thu hồi key trong Cài đặt → API key là mọi ứng dụng dùng key đó bị từ chối ngay. Nhật ký API ghi lại từng lần gọi công cụ.
Không dùng MCP?
Mọi công cụ đều có endpoint REST tương ứng, kèm webhook có chữ ký khi có thư mới.