Kết nối AI assistant với Adapty (MCP)

MCP server của Adapty kết nối trợ lý AI với tài khoản Adapty của bạn. Hỏi về doanh thu và tỷ lệ chuyển đổi, thiết lập sản phẩm và placement, xuất bản flow, hoặc bắt đầu A/B test từ chat, bằng ngôn ngữ tự nhiên. Trợ lý đăng nhập bằng tài khoản Adapty của bạn trên trình duyệt và nhận quyền của bạn. Không cần API key.


Server URL	`https://mcp.adapty.io/mcp`
Protocol	MCP over Streamable HTTP, OAuth 2.1 sign-in in the browser
Works with	The Claude app (web and desktop), Claude Code, Codex, and other MCP clients that support OAuth sign-in

Important

MCP server hoạt động tốt nhất khi kết hợp với Adapty skills. Server cung cấp cho trợ lý quyền truy cập vào tài khoản của bạn; còn skills cung cấp các quy trình đã được kiểm nghiệm để thực hiện công việc. Việc xây dựng flow, paywall và tìm ra điểm cần kiểm thử trong analytics đều phụ thuộc vào skills.

Claude

Tỷ lệ chuyển đổi từ dùng thử sang trả phí giảm tháng trước. Tìm hiểu nguyên nhân và thiết lập một bài test để cải thiện lại.

Đã sử dụng 6 công cụ Adapty

analytics_conversion — tỷ lệ chuyển đổi từ dùng thử sang trả phí, theo quốc gia, hai tháng gần nhất
analytics_conversion — tỷ lệ chuyển đổi từ dùng thử sang trả phí tại Đức, theo placement
placements_get — settings_upgrade
paywalls_list
ab_tests_list — A/B test trên settings_upgrade
ab_tests_create — bản nháp test, 50/50

Tỷ lệ chuyển đổi từ dùng thử sang trả phí chỉ giảm ở Đức, từ 41% xuống 29%, và chỉ trên placement settings_upgrade.

Mọi quốc gia khác đều ổn định. Vào ngày 2 tháng 10, settings_upgrade đã chuyển từ paywall Annual first sang Weekly focus, vốn ưu tiên hiển thị gói hàng tuần lên trước. Kể từ đó, ít người dùng ở Đức bắt đầu dùng thử hơn và sau khi hết thời gian dùng thử, tỷ lệ thanh toán cũng giảm.

Tôi đã tạo một A/B test nháp trên settings_upgrade cho người dùng ở Đức: Annual first so với Weekly focus, tỷ lệ 50/50. Người dùng của bạn chưa bị ảnh hưởng gì cả.

Start the A/B test

Nếu tôi bắt đầu test, một nửa người dùng Đức mở settings_upgrade sẽ thấy Annual first từ hôm nay. Người dùng ở các quốc gia khác vẫn thấy Weekly focus. Bạn có thể dừng test bất cứ lúc nào, nhưng không thể hoàn tác sau khi đã bắt đầu. Bắt đầu không?

Có, bắt đầu test
Không, giữ nguyên là bản nháp

Ví dụ cuộc trò chuyện với ứng dụng mẫu. Số liệu, paywall và các bài test của bạn sẽ khác.

Thêm Adapty skills

MCP server cho phép trợ lý của bạn truy cập vào tài khoản Adapty. Các Adapty skill cung cấp kiến thức cần thiết: những workflow đã được kiểm thử, lên kế hoạch thay đổi, xác minh và hỏi trước mỗi bước có ảnh hưởng đến người dùng của bạn. Hãy cài đặt chúng cùng nhau. Plugin adapty-skills bao gồm cả các skill lẫn MCP server này.

Có hai loại công việc phụ thuộc vào các skill:

Flow và paywall: Skill flow-generator tích hợp sẵn các quy tắc cấu hình của Flow Builder. Skill này xây dựng màn hình từ mô tả hoặc ảnh chụp màn hình, đồng thời xác thực và xem trước mọi thay đổi trước khi lưu flow. Nếu không có skill này, trợ lý vẫn có thể đọc và ghi cấu hình flow, nhưng sẽ không có quy tắc để tạo ra một cấu hình hợp lệ.
Analytics và những gì cần test tiếp theo: Skill growth-advisor biết cần đọc báo cáo nào và đọc như thế nào, đồng thời chuyển đổi các con số của bạn thành các giả thuyết để A/B test. Nếu không có skill này, trợ lý vẫn có thể lấy các biểu đồ của bạn, nhưng sẽ không có phương pháp để giải thích chúng.

Thêm plugin trong ứng dụng Claude

Bạn thêm plugin từ cài đặt Claude, không cần dùng dòng lệnh.

Trong Claude, mở Settings → Plugins.
Nhấp Add → Add marketplace.
Chọn Add from a repository.
Trong trường URL, nhập adaptyteam/adapty-skills và chọn repository. Để nhận các skill và bản vá mới khi có, hãy giữ Sync automatically bật.
Nhấp Sync.

Add marketplace dialog in Claude with adaptyteam/adapty-skills in the URL field and Sync automatically turned on

Claude mở tab Discover với các plugin từ marketplace của Adapty. Để cài đặt các skill, trong hàng Adapty, nhấn Add.

Discover tab in Claude listing the Adapty, Apple ads, and Apple ads benchmarks plugins, each with an Add button

Các skill chạy script của chúng trong sandbox của Claude. Để cho phép điều này, trong Settings → Capabilities, hãy bật Code execution and file creation.

Thêm plugin vào coding agent

Trong Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor và các coding agent khác, hãy chạy:

npx adapty skills install

Lệnh này cài plugin thông qua trình cài đặt của agent khi agent có sẵn trình đó. Sau khi cài xong, hãy khởi động lại agent. Trong Claude Code và Codex, plugin còn thêm cả Adapty MCP server, nên bạn chỉ cần đăng nhập như mô tả trong phần Kết nối assistant của bạn.

Skill nào dùng MCP server và skill nào dùng CLI

Trước bước đầu tiên, mỗi skill sẽ phát hiện xem agent của bạn có MCP server, Adapty Developer CLI, hay cả hai. Nếu chỉ có một, skill sẽ sử dụng cái đó. Nếu có cả hai, skill sẽ chọn cái phù hợp nhất với công việc:

MCP server: Chạy A/B test, tích hợp SDK và kiểm tra mua hàng.
Adapty CLI: Xây dựng và kiểm tra flow, tìm điểm cần test tiếp theo, chuyển placement sang flow và tạo phân khúc. Các skill này chạy script và file riêng, CLI sẽ cung cấp file trực tiếp cho chúng.

Xây dựng và chỉnh sửa flow

Cài đặt skill flow-generator để công cụ AI coding của bạn có thể tạo, dịch và tái cấu trúc các flow Adapty thông qua Adapty CLI.

Tìm nội dung cần test tiếp theo

Cài đặt skill growth-advisor để công cụ AI của bạn đọc dữ liệu phân tích Adapty, tìm ra nơi ứng dụng bị thất thoát doanh thu, và đề xuất nội dung A/B test tiếp theo.

Chạy A/B test

Cài skill ab-tests để công cụ AI của bạn có thể tạo, bắt đầu, dừng và thay thế A/B test paywall và flow trong Adapty, đồng thời hiển thị ai đang xem gì trước mỗi bước không thể hoàn tác.

Tích hợp theo skill

Sử dụng skill adapty-integration để tích hợp Adapty SDK vào ứng dụng iOS của bạn từ đầu đến cuối với công cụ lập trình AI.

Trợ lý có thể làm gì

Các công cụ của server tuân theo Adapty Dashboard và Adapty Developer CLI. Trợ lý sẽ tự chọn công cụ phù hợp với yêu cầu của bạn; bạn không cần gọi tên chúng.

Khu vực	Trợ lý có thể làm gì	Thử hỏi
Ứng dụng và mức độ truy cập	Liệt kê, tạo và cập nhật ứng dụng và mức độ truy cập	”Tạo mức độ truy cập `premium` trong Fitness Pro.”
Sản phẩm và ưu đãi	Tạo sản phẩm với ID sản phẩm trên cửa hàng, và liên kết ưu đãi của cửa hàng với chúng	”Sản phẩm nào của tôi chưa có ID sản phẩm Google Play?”
Paywall	Tạo và cập nhật paywall, và tìm các placement hiển thị từng paywall	”Placement nào hiển thị paywall Annual sale?”
Flow	Tạo flow, đọc và ghi cấu hình builder, xác thực, xem trước, xuất bản và đọc chỉ số của flow	”Xuất bản flow Onboarding v2 và cho tôi biết placement nào hiển thị nó.”
Placement và đối tượng	Tạo placement và thay đổi ai thấy nội dung gì, và đọc chỉ số của các flow placement	”Ai thấy gì trên placement `onboarding`?”
Phân khúc	Đọc phân khúc và các bộ lọc của chúng	”Liệt kê các phân khúc của tôi và mỗi phân khúc lọc theo tiêu chí gì.”
A/B test	Tạo, bắt đầu, dừng, thay thế và lưu trữ các A/B test paywall và flow	”Bắt đầu A/B test nháp Weekly vs annual cho người dùng ở Đức.”
Analytics	Đọc doanh thu, MRR, tỷ lệ chuyển đổi, funnel, retention, LTV và install cohort	”So sánh tỷ lệ chuyển đổi từ dùng thử sang trả phí theo quốc gia trong tháng trước.”
Migration từ RevenueCat	Tạo và chạy migration catalog RevenueCat sang ứng dụng Adapty mới	”Chuyển dự án RevenueCat của tôi sang ứng dụng Adapty mới.”

Adapty Mail có MCP server riêng. Để kết nối một assistant với dự án Adapty Mail của bạn, xem Quản lý Adapty Mail bằng AI assistant.

Chọn MCP server hoặc CLI

MCP server và Adapty Developer CLI đều kết nối đến cùng một tài khoản Adapty. Hãy chọn dựa trên nơi assistant của bạn chạy:

	Adapty MCP server	Adapty CLI
Chạy trong	Bất kỳ MCP client nào, bao gồm các ứng dụng chat như Claude app	Các agent chạy lệnh terminal và script của riêng bạn
Đăng nhập	Một lần cho mỗi client, trên trình duyệt	`adapty auth login`, một lần cho mỗi máy
Phù hợp nhất cho	Đặt câu hỏi và thực hiện thay đổi qua chat	Chỉnh sửa cấu hình flow, thay đổi hàng loạt và script
Cài đặt	Không cần cài đặt	`npm install -g adapty`

Một agent có thể sử dụng cả hai. Trong ứng dụng Claude, MCP server cần ít thiết lập hơn so với CLI: CLI phải được cài đặt và ủy quyền trong mỗi cuộc hội thoại, như mô tả trong Thiết lập Adapty CLI trong ứng dụng Claude.

Trước khi bắt đầu

Tài khoản Adapty: Trợ lý hoạt động trong các công ty và ứng dụng mà tài khoản Adapty của bạn có thể truy cập, với các quyền của bạn.
MCP client có OAuth: Client của bạn hỗ trợ các remote MCP server đăng nhập bằng OAuth.

Warning

Trợ lý hành động với quyền của bạn, và các thay đổi là thực tế. Một A/B test được khởi chạy hoặc một placement bị thay đổi sẽ ảnh hưởng đến người dùng của bạn. Trước khi trợ lý bắt đầu hoặc dừng một A/B test, hoặc thay đổi đối tượng xem nội dung trên một placement, server sẽ yêu cầu nó mô tả chính xác tác động và chờ xác nhận từ bạn. Hãy đọc kỹ kế hoạch trước khi phê duyệt.

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

Ứng dụng Claude (claude.ai và Claude desktop) thêm các MCP server từ xa dưới dạng custom connector.

Để thêm server, mở Settings → Connectors và nhấn Add custom connector.
Nhập tên, ví dụ Adapty, và URL https://mcp.adapty.io/mcp.
Giữ nguyên cài đặt xác thực mặc định và nhấn Add.
Đăng nhập vào Adapty trong tab trình duyệt mở ra. Xem Đăng nhập.

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 của mình khi sử dụng lần đầu.

Nếu bạn dùng plugin adapty-skills, Claude Code đã liệt kê server là plugin:adapty-skills:adapty với trạng thái Needs authentication. Để đăng nhập, chạy /mcp trong Claude Code, chọn plugin:adapty-skills:adapty, rồi chọn Authenticate.

Nếu không dùng plugin, hãy thêm server trước:

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

Sau đó chạy /mcp trong Claude Code, chọn adapty, và chọn Authenticate. Nếu các công cụ Adapty không xuất hiện trong phiên hiện tại, hãy bắt đầu một phiên mới.

Nếu bạn sử dụng plugin adapty-skills, plugin sẽ tự thêm server và Codex sẽ yêu cầu bạn đăng nhập khi kết nối.

Nếu không dùng plugin, hãy thêm server và đăng nhập thủ công:

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

Lệnh đăng nhập sẽ mở trình duyệt của bạn. Để tự cấu hình server, hãy thêm vào ~/.codex/config.toml, sau đó chạy lệnh đăng nhập:

[mcp_servers.adapty]
url = "https://mcp.adapty.io/mcp"

Khởi động một phiên codex mới để tải các công cụ Adapty.

Thêm https://mcp.adapty.io/mcp làm remote MCP server trong phần cài đặt client hoặc file cấu hình MCP của bạn. Client sẽ mở trình duyệt để đăng nhập lần đầu kết nối.

Máy chủ nhận diện mỗi client thông qua Client ID Metadata Document, phương thức đăng ký client của đặc tả MCP hiện tại. Client nào không hỗ trợ phương thức này sẽ không thể hoàn tất quá trình đăng nhập. Trong trường hợp đó, hãy dùng Adapty Developer CLI từ một terminal agent thay thế.

Mọi client đều kết thúc ở cùng một nơi: trang đăng nhập Adapty trên trình duyệt của bạn.

Đăng nhập bằng tài khoản Adapty của bạn, nếu bạn chưa đăng nhập.
Cho phép client truy cập vào tài khoản Adapty của bạn.

Sau đó, client sẽ đọc và thay đổi dữ liệu trong các công ty mà tài khoản của bạn có thể mở, và nó sẽ duy trạng thái đăng nhập cho đến khi bạn ngắt kết nối. Chỉ chấp nhận lần đăng nhập do chính bạn khởi tạo.

Để xác minh kết nối, hãy hỏi trợ lý xem nó đang đăng nhập vào tài khoản Adapty nào. Câu trả lời phải nêu tên bạn và các công ty mà tài khoản của bạn có thể mở.

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

Hỏi trợ lý xem nó có thể thấy những ứng dụng nào, rồi đặt tên ứng dụng bạn muốn làm việc. Một số yêu cầu bạn có thể thử:

List my Adapty apps and their placements.
How did revenue and new subscriptions change last month compared with the month before?
Which products in Fitness Pro have no App Store product ID?
Show who sees what on the onboarding placement, including any A/B test.
Create a draft A/B test on main_paywall: the current paywall against Annual sale, 50/50.

The assistant asks for confirmation before the steps that change what users see. A request that only reads data runs without questions.

After a task of several steps, the assistant can send the Adapty team a short note about how the task went. The note contains no personal data of your app’s users.

Ngắt kết nối

Để ngắt kết nối, xóa server khỏi client:

Claude app: Trong Settings → Connectors, xóa connector Adapty.
Claude Code: Chạy claude mcp remove adapty. Nếu server đi kèm với plugin adapty-skills, hãy tắt nó trong /mcp.
Codex: Xóa server adapty khỏi ~/.codex/config.toml.

Để kết nối lại, thêm server và đăng nhập lại một lần nữa.

Khắc phục sự cố

Vấn đề	Giải pháp
Claude Code hiển thị server là Needs authentication	Client đã thêm server nhưng chưa đăng nhập. Chạy `/mcp`, chọn server Adapty, và chọn Authenticate.
Client không liệt kê công cụ Adapty nào	Hoàn tất đăng nhập, sau đó bắt đầu phiên mới. Một số client chỉ tải công cụ khi bắt đầu phiên.
Trợ lý không tìm thấy ứng dụng	Ứng dụng thuộc về một công ty mà tài khoản Adapty của bạn không có quyền truy cập. Hãy yêu cầu chủ sở hữu công ty cấp quyền.
Client không thể hoàn tất đăng nhập	Client không hỗ trợ phương thức đăng nhập mà server sử dụng. Kết nối từ ứng dụng Claude, Claude Code, hoặc Codex, hoặc sử dụng Adapty Developer CLI.