MCP
Dùng Mailera trong VS Code
Thêm Mailera vào .vscode/mcp.json để Copilot Chat ở chế độ Agent dùng được hộp thư của bạn. VS Code hỏi API key ở lần đầu và lưu như bí mật, nên file cấu hình không chứa key.
Tài liệu chính thức của VS CodeTrướ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 .vscode/mcp.json trong workspace, hoặc chạy lệnh MCP: Open User Configuration để dùng cho mọi workspace.
- Dán cấu hình bên dưới. Ở lần chạy đầu, VS Code hỏi Mailera API key và lưu như bí mật.
- Mở Chat ở chế độ Agent và bấm biểu tượng công cụ: các công cụ của mailera phải có trong danh sách.
.vscode/mcp.json
{ "inputs": [ { "type": "promptString", "id": "mailera-api-key", "description": "Mailera API key", "password": true } ], "servers": { "mailera": { "type": "http", "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer ${input:mailera-api-key}" } } }}File không chứa key nên commit được để cả đội dùng chung; mỗi người nhập key của riêng mình.
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 VS Code
Vào Cài đặt → API key, tạo key và chọn quyền. Quyền read là đủ để bắt đầu.