English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Quản lý Adapty Mail với trợ lý AI (MCP)

Adapty Mail chạy một MCP server, nhờ đó AI assistant có thể làm việc trong dự án của bạn giống như bạn thao tác trên dashboard: tạo và bản địa hóa các campaign, khởi chạy flow, thiết lập sending domain, tra cứu hồ sơ người dùng và đọc analytics. Assistant đăng nhập bằng tài khoản Adapty Mail của chính bạn và nhận quyền của bạn sau khi bạn chấp thuận kết nối trong dashboard. Không cần API key.

Server URLhttps://api-mail.adapty.io/mcp
ProtocolMCP over Streamable HTTP, OAuth 2.1 sign-in
Works withClaude (web and desktop), ChatGPT, Claude Code, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cursor, Windsurf, and any client that supports remote MCP servers with OAuth
Tip

Để đạt kết quả tốt nhất trong coding agent, hãy thêm Adapty Mail skill nữa. Skill này kết nối server cho bạn, hỏi xác nhận trước khi gửi email đến người thật, và xử lý các công việc sau khi ra mắt: kết quả, A/B test, và lý do ai đó không nhận được email.

Những gì trợ lý có thể làm

Các công cụ của server phản ánh dashboard:

Khu vựcVí dụ
Định hướngTìm công ty và dự án, xem những bước cài đặt còn thiếu
Thương hiệuXây dựng thương hiệu từ danh sách cửa hàng, xem lại và chỉnh sửa
Sending domainsThêm domain, lấy bản ghi DNS, kiểm tra xác minh, đọc tình trạng domain
DestinationsTạo và cập nhật các trang mà email dẫn đến
CampaignsTạo campaign từ brief, chỉnh sửa email, dịch email, gửi email thử
Flow và phân khúcTạo phân khúc và khởi chạy hoặc thay đổi flow
A/B testTạo, khởi chạy và kết thúc test
Hồ sơ người dùngTra cứu hồ sơ người dùng và hành trình của họ, hủy đăng ký hồ sơ người dùng
AnalyticsChỉ số campaign theo thời gian, phân tích chi tiết, kênh A/B test
SettingsTên người gửi, địa chỉ reply-to, double opt-in, tải ảnh lên

Ba quy trình hướng dẫn có sẵn dưới dạng prompt trong các client hỗ trợ chúng. Trong Claude Code, chúng xuất hiện dưới dạng slash command, ví dụ /mcp__adaptymail__campaign_to_flow:

  • campaign_to_flow: Tạo campaign từ một brief, chọn điểm đến và phân khúc, rồi khởi chạy flow.
  • campaign_localization: Dịch một campaign đã lưu sang nhiều ngôn ngữ hơn.
  • domain_onboarding: Thêm domain gửi thư, xuất bản bản ghi DNS và xác minh.

Một số bước thiết lập chỉ thực hiện trên dashboard: địa chỉ công ty, web checkout, và bật gửi dữ liệu.

Trước khi bắt đầu

  • Tư cách thành viên dự án: Tài khoản Adapty Mail của bạn phải là thành viên của dự án bạn muốn làm việc. Trợ lý chỉ thấy các công ty và dự án mà tài khoản của bạn có quyền truy cập.
  • Hỗ trợ client: Client của bạn hỗ trợ remote MCP server với OAuth.
Warning

Trợ lý có quyền hạn giống như bạn, và mọi thao tác của nó đều là thật: lưu một flow sẽ bắt đầu gửi email đến người dùng thực. Server đánh dấu các công cụ có thể gây hậu quả nghiêm trọng, và các trợ lý chúng tôi đã kiểm tra sẽ xin xác nhận trước khi thực thi chúng. Hãy đọc kỹ kế hoạch của trợ lý trước khi phê duyệt.

Kết nối trợ lý của bạn

Claude (claude.ai và Claude desktop)

  1. Để thêm server, mở Settings → Connectors và nhấp Add custom connector.
  2. Nhập tên, ví dụ Adapty Mail, và URL https://api-mail.adapty.io/mcp.
  3. Giữ Authentication ở Sign in now và OAuth client ở mặc định đã phát hiện, sau đó nhấp Add.
  4. Trong tab Adapty Mail vừa mở, đăng nhập nếu được yêu cầu, rồi nhấp Approve.

Quản trị viên workspace có thể thêm connector một lần cho toàn bộ tổ chức. Mỗi thành viên sau đó đăng nhập bằng tài khoản Adapty Mail của riêng mình khi sử dụng lần đầu.

ChatGPT

ChatGPT thêm máy chủ MCP tùy chỉnh từ trang connectors trong Settings. Chế độ Developer phải được bật cho workspace của bạn.

  1. Để thêm máy chủ, nhấp vào Create.
  2. Nhập tên, ví dụ Adapty Mail, và URL máy chủ https://api-mail.adapty.io/mcp. Giữ Authentication ở OAuth.
  3. Chấp nhận cảnh báo máy chủ MCP tùy chỉnh và nhấp vào Create.
  4. Khi ChatGPT yêu cầu, kết nối máy chủ. Trong tab Adapty Mail mở ra, đăng nhập nếu cần, và nhấp vào Approve.

Claude Code

claude mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

Để đăng nhập, chạy /mcp trong Claude Code, chọn adaptymail, rồi chọn Authenticate. Sau đó đăng nhập vào Adapty Mail dashboard trên trình duyệt và nhấn Approve.

Codex CLI

codex mcp add adaptymail --url https://api-mail.adapty.io/mcp
codex mcp login adaptymail

Lệnh login sẽ mở trình duyệt của bạn, nơi bạn xác nhận kết nối. Để cấu hình server thủ công, hãy thêm vào ~/.codex/config.toml, sau đó chạy lệnh login:

[mcp_servers.adaptymail]
url = "https://api-mail.adapty.io/mcp"

GitHub Copilot CLI

copilot mcp add --transport http adaptymail https://api-mail.adapty.io/mcp

Lần đầu tiên kết nối với server, trình duyệt sẽ mở ra để đăng nhập.

Gemini CLI

gemini mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

Bắt đầu một phiên mới, sau đó chạy /mcp auth adaptymail và phê duyệt kết nối trong trình duyệt của bạn.

Cursor, Windsurf, và các client khác

Thêm server vào file cấu hình MCP của client, ví dụ ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adaptymail": {
      "url": "https://api-mail.adapty.io/mcp"
    }
  }
}

Lần đầu kết nối, client sẽ mở trình duyệt để bạn đăng nhập. Các client không hỗ trợ OAuth cho remote server sẽ không thể kết nối với Adapty Mail.

Phê duyệt kết nối

Mọi client đều kết thúc tại cùng một màn hình trên Adapty Mail dashboard. Màn hình này hiển thị tên ứng dụng đang yêu cầu quyền truy cập và địa chỉ nơi ứng dụng nhận quyền truy cập đó. Với các công cụ desktop, địa chỉ đó nằm trên chính máy tính của bạn (localhost), vì vậy chỉ phê duyệt kết nối do chính bạn khởi tạo. Để hoàn tất, nhấn Approve.

Yêu cầu kết nối sẽ hết hạn sau 10 phút. Nếu màn hình hiển thị This request has expired, hãy bắt đầu lại từ phía client.

Bắt đầu làm việc

Hãy yêu cầu trợ lý liệt kê các dự án của bạn, sau đó đặt tên dự án bạn muốn làm việc. Một số yêu cầu bạn có thể thử:

  • “Hiển thị trạng thái onboarding của dự án tôi và cho biết những gì còn thiếu.”
  • “Tạo chiến dịch thu hút khách hàng cũ cho những người dùng có trial đã hết hạn, bằng tiếng Anh, và hiển thị email đầu tiên cho tôi.”
  • “Dịch chiến dịch Trial expired sang tiếng Đức và tiếng Pháp.”
  • “Thêm mail.example.com làm miền gửi và cho tôi các bản ghi DNS.”
  • “So sánh tỷ lệ mở và tỷ lệ nhấp của các chiến dịch đang chạy trong 30 ngày qua.”

Ngắt kết nối

Để ngắt kết nối, xóa connector trong cài đặt của client. Trong Claude, vào Settings → Connectors; trong ChatGPT, vào trang của connector; trong Claude Code, chạy lệnh claude mcp remove adaptymail.

Access token của client sẽ hết hạn trong vòng một giờ. Refresh token sẽ bị thu hồi khi client ngắt kết nối; nếu không được sử dụng, nó sẽ hết hạn sau 90 ngày. Để kết nối lại, hãy thêm server và phê duyệt kết nối một lần nữa.

Khắc phục sự cố

Vấn đềGiải pháp
Dashboard thông báo yêu cầu kết nối đã hết hạnBắt đầu lại kết nối từ client và phê duyệt trong vòng 10 phút.
Assistant thông báo không tìm thấy dự ánTài khoản của bạn không phải thành viên của dự án đó. Hãy liên hệ chủ sở hữu công ty để được cấp quyền truy cập.
Assistant bị đăng xuấtQuyền truy cập hết hạn sau một thời gian không hoạt động hoặc sau khi bạn ngắt kết nối. Kết nối lại từ client.
Client không hiển thị công cụ nàoClient đã kết nối mà không đăng nhập. Chạy bước đăng nhập, ví dụ /mcp trong Claude Code.