Bỏ qua, tới nội dung chính
Mailera

MCP

Dùng Mailera trong Claude

Thêm máy chủ MCP của Mailera vào Claude Code bằng một lệnh, hoặc vào Claude Desktop qua cầu nối mcp-remote. Claude sẽ đọc, tìm và trả lời thư trên các hộp thư bạn đã kết nối.

Tài liệu chính thức của Claude

Trước khi bắt đầu

  1. Tạo workspace miễn phí và kết nối ít nhất một hộp thư.
  2. Vào Cài đặt → API key, tạo key và chọn quyền. Quyền read là đủ để bắt đầu.
  3. Chép key ngay khi tạo — Mailera chỉ hiện key đầy đủ một lần.

Cài đặt

Claude Code

  1. Mở terminal ở thư mục dự án và chạy lệnh bên dưới, thay key của bạn.
  2. Trong Claude Code, gõ /mcp: mailera phải ở trạng thái connected và liệt kê công cụ.

Thay mh_live_xxx bằng API key của bạn.

Terminal
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \  --header "Authorization: Bearer mh_live_xxx"

Claude Desktop

  1. Cài Node.js 18 trở lên — cầu nối mcp-remote chạy bằng npx.
  2. Trong Claude Desktop mở Settings → Developer → Edit Config, dán khối mailera vào mcpServers rồi lưu.
  3. Thoát hẳn và mở lại Claude Desktop. Công cụ của Mailera hiện trong nút công cụ ở khung chat.

Thay mh_live_xxx bằng API key của bạn.

claude_desktop_config.json
{  "mcpServers": {    "mailera": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mailera.app/api/public/v1/mcp",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer mh_live_xxx"      }    }  }}

Mục Connectors (custom connector) trên claude.ai và Claude Desktop chưa dùng được với Mailera: mục này chỉ nhận máy chủ đăng nhập bằng OAuth hoặc không cần xác thực, còn Mailera dùng API key.

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àn

Lỗ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 Claude

Vào Cài đặt → API key, tạo key và chọn quyền. Quyền read là đủ để bắt đầu.

Tạo workspace miễn phí