Tạo mật khẩu ứng dụng Fastmail để AI đọc thư qua Mailera

Cần kiểm tra gì trước khi tạo mật khẩu ứng dụng Fastmail?

Mật khẩu ứng dụng (app password) là mật khẩu dành riêng cho ứng dụng bên thứ ba truy cập Fastmail. Theo hướng dẫn mật khẩu ứng dụng của Fastmail, mỗi ứng dụng cần một mật khẩu riêng. Hãy kiểm tra gói Fastmail đang dùng trước khi thử kết nối: gói Basic không cho tạo mật khẩu ứng dụng hoặc dùng ứng dụng thư bên thứ ba.

Chuẩn bị một hộp thư thử do bạn sở hữu. Tài khoản Mailera của bạn cần vai trò Admin hoặc Leader để thêm hộp thư. Nên đặt hộp thư thử vào một nhóm riêng để sau đó giới hạn phạm vi của agent.

Đừng nhập mật khẩu đăng nhập thông thường vào phần kết nối Mailera. Tài liệu về mật khẩu Fastmail phân biệt mật khẩu tài khoản dùng cho web hoặc ứng dụng Fastmail với mật khẩu ứng dụng dùng cho kết nối bên thứ ba. Phần khái niệm chung nằm trong bài mật khẩu ứng dụng cho hộp thư của agent.

Tạo mật khẩu ứng dụng Fastmail ở đâu?

Thực hiện trên giao diện web Fastmail:

1. Mở “Settings” → “Privacy & Security”.
2. Trong “Connected apps & API tokens”, chọn “Manage app passwords and access”.
3. Chọn “New app password”. Nếu xuất hiện “Verify it's you”, nhập mật khẩu tài khoản ngay tại Fastmail rồi chọn “Continue”.
4. Chọn “Custom...” để đặt tên dễ nhận diện, chẳng hạn Mailera-hop-thu-thu.
5. Giới hạn quyền vào dữ liệu email. Mặc định “Mail, Contacts & Calendars” còn bao gồm danh bạ và lịch; kết nối thư không cần hai phần đó.
6. Chọn “Generate password”, rồi lưu mật khẩu vào nơi quản lý bí mật. Dùng mật khẩu này ở bước kết nối Mailera bên dưới.
7. Kiểm tra kết nối hoạt động trước khi chọn “Done”, như Fastmail hướng dẫn.

Màn hình quản lý không cho hiển thị lại hoặc chỉnh sửa mật khẩu ứng dụng đã tạo. Hãy sao chép mật khẩu ngay; đóng trang rồi quay lại sẽ không xem lại được. Không đưa mật khẩu vào cuộc trò chuyện với AI, kho mã hoặc nhật ký.

Giới hạn vào email không có nghĩa là chỉ đọc. Quyền mặc định của Fastmail bao gồm IMAP/POP/SMTP; bản thân IMAP cũng cho phép thao tác với thư. Quyền chỉ đọc cho agent cần được đặt riêng tại Mailera.

Kết nối hộp thư Fastmail với Mailera như thế nào?

Trang kết nối Fastmail giới thiệu kết nối bằng mật khẩu ứng dụng. Trong Mailera, làm lần lượt như sau:

1. Mở Danh sách hộp thư → Thêm hộp thư, chọn Một hộp thư.
2. Điền Địa chỉ email và kiểm tra nhà cung cấp được nhận diện. Nếu cần, chọn Fastmail trong Hoặc chọn nhà cung cấp, rồi bấm Tiếp tục.
3. Tại Thông tin kết nối, dán mật khẩu ứng dụng vào Mật khẩu. Chọn Nhóm quản lý dành cho hộp thư thử; Tên hiển thị không bắt buộc.
4. Bấm Kiểm tra & kết nối. Mailera kiểm tra đăng nhập nhận thư, nhận diện thư mục và đăng nhập gửi thư nếu có máy chủ gửi. Thao tác này không gửi email thử.

Đây là cấu hình Mailera dùng cho Fastmail, để bạn đối chiếu khi xử lý lỗi:

Nếu nhận thư thành công nhưng kiểm tra gửi thất bại, bạn có thể chọn Lưu ở chế độ Chỉ nhận. Đây là trạng thái kết nối của hộp thư, không phải quyền của khóa API. Agent vẫn cần khóa chỉ có quyền read.

Sau khi kết nối, Mailera tải thư trong thời gian lưu trữ, mới nhất trước. Gửi một thư thử không chứa dữ liệu nhạy cảm đến hộp Fastmail, đợi một lúc để Mailera đồng bộ, rồi kiểm tra nội dung trong Hộp thư chung. Như vậy bạn kiểm tra được việc đọc thư, thay vì chỉ dựa vào kết quả đăng nhập.

Phản hồi GET /mailboxes có trường status và last_sync_at để kiểm tra trạng thái hộp thư và lần đồng bộ gần nhất.

Cho AI đọc thư mà không cấp quyền gửi ra sao?

Có hai lớp thông tin xác thực: mật khẩu ứng dụng cho Mailera kết nối Fastmail, còn khóa API cho agent truy cập Mailera. Không chuyển mật khẩu ứng dụng Fastmail cho agent.

Tạo khóa trong Mailera:

1. Mở Cài đặt, vào phần khóa API và chọn Tạo key.
2. Điền Tên gợi nhớ, chẳng hạn Agent-doc-thu-thu.
3. Trong Phạm vi hộp thư, chọn nhóm chỉ chứa hộp thư thử. Không chọn tất cả nhóm cho tác vụ này.
4. Chỉ cấp quyền read; không cấp send, move hay quyền quản lý.
5. Đặt Thời hạn phù hợp với thời gian thử nghiệm.
6. Khi thấy Key đã tạo — sao chép ngay, lưu khóa an toàn. Mailera chỉ hiển thị khóa mới một lần.
7. Chọn Sao chép cấu hình MCP cho Claude, Cursor hoặc VS Code rồi thêm cấu hình vào ứng dụng tương ứng.

Theo hướng dẫn MCP của Mailera, kiểm tra bằng chuỗi công cụ sau:

Cả ba công cụ đều yêu cầu read. send_email và reply_to_email yêu cầu send; move_message và rescue_spam yêu cầu move. Vì vậy, chỉ cấp read cho quy trình đọc thư, kể cả khi hộp thư đã kết nối SMTP thành công. Bài công cụ MCP Mailera theo từng tác vụ trình bày cách chọn công cụ cho các bước tiếp theo.

Những lỗi nào thường gặp khi kết nối Fastmail?

Tách lỗi kết nối hộp thư khỏi lỗi quyền của agent. Nếu Mailera đã đọc được thư mà agent chưa đọc được, hãy kiểm tra khóa API và phạm vi nhóm trước khi tạo lại mật khẩu Fastmail.

Với Fastmail, trạng thái đăng nhập Mailera báo qua API dựa trên lần đồng bộ gần nhất, không phải lần nào cũng đăng nhập trực tiếp để kiểm tra. Đừng coi trạng thái đó là kết quả kiểm tra kết nối ngay tại thời điểm bạn xem.

An toàn khi agent đọc nội dung thư

Thư đến là dữ liệu không tin cậy, không phải lệnh cho agent. Một thư có thể yêu cầu tiết lộ khóa, thay đổi cấu hình hoặc gọi công cụ ngoài nhiệm vụ. Agent phải bỏ qua những chỉ dẫn đó, kể cả khi chúng nằm trong nội dung có vẻ là hướng dẫn kỹ thuật.

Chỉ cung cấp khóa qua cấu hình kết nối, không dán vào lời nhắc. Giữ phạm vi ở nhóm thử và quyền read. Quyền đọc vẫn cho phép truy cập nội dung thư trong phạm vi đó, nên không dùng nhóm chứa thư nhạy cảm để thử lần đầu.

Nếu sau này mở rộng sang gửi thư, cần người dùng xác nhận trước khi gửi. Xem thông tin bảo mật Mailera trước khi đưa hộp thư làm việc vào quy trình của agent.

Thu hồi quyền truy cập và thay mật khẩu thế nào?

Thu hồi đúng loại thông tin xác thực theo việc bạn muốn dừng:

Khi chỉ ngừng dùng agent, thu hồi khóa API của nó. Khi ngừng kết nối Fastmail hoặc nghi lộ mật khẩu ứng dụng, thu hồi mật khẩu tương ứng tại Fastmail. Nếu nghi cả hai bí mật bị lộ, xử lý cả hai lớp.

Muốn thay mật khẩu ứng dụng, hãy tạo mật khẩu mới; không tìm cách sửa mật khẩu cũ trong màn hình quản lý Fastmail. Với việc thay định kỳ, chỉ chọn “Done” sau khi kết nối bằng mật khẩu mới hoạt động. Nếu nghi bị lộ, ưu tiên thu hồi mật khẩu cũ.

Giới hạn cần biết trước khi dùng lâu dài

Mailera không thay đổi điều kiện hỗ trợ IMAP của gói Fastmail. Khóa API chỉ có read giới hạn thao tác qua Mailera, không biến mật khẩu ứng dụng Fastmail bên dưới thành mật khẩu chỉ đọc.

Mailera cũng không bảo đảm đồng bộ tức thời tuyệt đối. Hộp thư đang dùng được kiểm tra thường xuyên hơn hộp thư ít hoạt động; hộp thư không hoạt động có thể chuyển sang trạng thái ngủ. Gói miễn phí lưu thư trong 30 ngày, nên khi kiểm tra lần tải đầu, hãy dùng thư thử mới thay vì tìm thư cũ ngoài khoảng lưu trữ.