MCP
Dùng Mailera trong Cursor
Thêm Mailera vào file mcp.json của Cursor. Agent của Cursor sẽ đọc thư, lấy mã OTP khi bạn chạy test đăng ký và trả lời thư ngay trong lúc code.
Tài liệu chính thức của CursorTrước khi bắt đầu
- Tạo workspace miễn phí và kết nối ít nhất một hộp thư.
- Vào Cài đặt → API key, tạo key và chọn quyền. Quyền read là đủ để bắt đầu.
- Chép key ngay khi tạo — Mailera chỉ hiện key đầy đủ một lần.
Cài đặt
- Tạo file ~/.cursor/mcp.json (dùng cho mọi dự án) hoặc .cursor/mcp.json trong thư mục dự án (chỉ dự án đó).
- Dán cấu hình bên dưới và thay key của bạn. Nếu file đã có mcpServers, chỉ thêm khối mailera.
- Mở phần MCP trong cài đặt của Cursor: mailera phải đang bật và liệt kê công cụ.
Thay mh_live_xxx bằng API key của bạn.
~/.cursor/mcp.json
{ "mcpServers": { "mailera": { "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer mh_live_xxx" } } }}Đừng commit .cursor/mcp.json có key thật vào git. Dùng file trong thư mục home cho key cá nhân, hoặc tạo key riêng chỉ có quyền read cho cả đội.
Kiểm tra kết nối
Hỏi agent: “Liệt kê các hộp thư Mailera của tôi”. Agent gọi list_mailboxes và trả về danh sách hộp thư cùng trạng thái đồng bộ. Sau đó thử: “Tìm thư mới nhất từ noreply@… và lấy mã OTP”.
Danh sách công cụ và cách giữ an toànLỗi hay gặp
- 401 unauthorized
- Key sai, đã bị thu hồi hoặc thiếu chữ Bearer. Header phải là Authorization: Bearer mh_live_…
- Không thấy send_email hay rescue_spam
- Key không có quyền tương ứng (send, move). Mailera chỉ hiện công cụ khớp quyền — tạo key mới có quyền cần thiết.
- Agent không thấy hộp thư nào
- Key đang giới hạn theo một nhóm không có hộp thư, hoặc workspace chưa kết nối hộp thư nào.
- 429 rate_limited
- Quá 300 lượt mỗi phút cho key này. Chờ đúng số giây trong Retry-After rồi gọi lại.
Ứng dụng khác
Dùng Mailera trong Cursor
Vào Cài đặt → API key, tạo key và chọn quyền. Quyền read là đủ để bắt đầu.