Thiết lập Adapty CLI trong ứng dụng Claude

Adapty Developer CLI hoạt động trong ứng dụng Claude, cho phép bạn quản lý tài khoản Adapty qua chat thay vì terminal. Claude chạy các lệnh trong một sandbox chỉ cho phép truy cập các domain đã được liệt kê, vì vậy CLI cần được thiết lập một lần trong Claude trước khi có thể đăng nhập vào tài khoản của bạn.

Những gì bạn cần:

• Ứng dụng Claude
• Tài khoản Adapty
• Đối với các workspace Claude doanh nghiệp, cần có sự hỗ trợ từ quản trị viên workspace — xem Cho phép các domain Adapty

Thêm plugin Adapty

Plugin Adapty bao gồm các skill mà Claude sử dụng để cài đặt, xác thực và điều khiển CLI, bao gồm cả skill Apple Ads dành cho công việc với Ads Manager.

Để thêm plugin:

1. Trong Claude, mở Settings → Plugins.
2. Nhấp Add → Add marketplace.
3. Chọn Add from a repository.
4. Trong trường URL, dán https://github.com/adaptyteam/apple-ads-cli.
5. Nhấp Sync.

Các plugin Adapty xuất hiện trong mục Personal trong thư mục plugin.

Cho phép các domain của Adapty

Cho đến khi bạn cho phép Adapty trong danh sách domain được phép của sandbox, CLI không thể đăng nhập hoặc đọc tài khoản của bạn.

Hãy cho phép cả adapty.io và *.adapty.io. Ký tự đại diện (wildcard) không bao gồm apex domain trong hầu hết các cài đặt danh sách cho phép. Bản thân CLI kết nối đến api.adapty.io, còn một agent đọc tài liệu Adapty trong khi làm việc thì kết nối đến apex domain.

Claude áp dụng các cài đặt này khi một cuộc hội thoại bắt đầu. Nếu bạn thay đổi chế độ truy cập hoặc thêm domain trong khi đang hội thoại, cuộc hội thoại đó vẫn giữ nguyên cài đặt ban đầu — hãy bắt đầu một cuộc hội thoại mới.

Tài khoản cá nhân

Bạn tự thiết lập danh sách cho phép:

1. Trong Claude, mở Settings → Capabilities.
2. Bật Code execution and file creation. Khối Allow network egress sẽ ẩn cho đến khi bạn thực hiện bước này.
3. Bật Allow network egress.
4. Trong Domain allowlist, chọn Package managers only.
5. Trong Additional allowed domains, thêm adapty.io, sau đó thêm *.adapty.io.

Chế độ truy cập còn lại, All domains, cho phép sandbox truy cập bất kỳ trang web nào. Khi chọn chế độ này, bạn không cần thêm các domain của Adapty.

Không gian làm việc doanh nghiệp

Quản trị viên quản lý danh sách cho phép. Hãy yêu cầu họ thêm cả hai domain vào không gian làm việc.

Cài đặt và xác thực CLI

Mỗi cuộc trò chuyện bắt đầu trên một máy sạch: không có CLI, không có token, và không có cấu hình nào được giữ lại từ cuộc trò chuyện trước, vì vậy các bước cài đặt và đăng nhập sẽ lặp lại ở đầu mỗi cuộc trò chuyện.

Để cài đặt và xác thực CLI:

1. Bắt đầu một cuộc trò chuyện mới trong Claude.

2. Yêu cầu Claude cài đặt Adapty CLI — ví dụ: “Install the Adapty CLI”. Claude có thể xin phép mở các liên kết cài đặt — hãy cho phép.

   

3. Sau khi cài đặt xong, Claude sẽ đề nghị đăng nhập vào Adapty — hãy đồng ý, và Claude sẽ đăng một liên kết xác thực kèm mã thiết bị. Mã này sẽ hết hạn sau khoảng 15 phút.

   

4. Mở liên kết đó. Trang xác thực Adapty CLI sẽ mở trong trình duyệt của bạn.

5. Kiểm tra xem mã trên trang có khớp với mã Claude cung cấp không, rồi nhấn Authorize. Nếu mã không khớp, nhấn Deny và yêu cầu Claude tạo liên kết mới.

   

6. Quay lại chat, báo cho Claude biết bạn đã xác thực — ví dụ: “done”. Claude sẽ xác minh đăng nhập và hiển thị thông tin tài khoản của bạn.

CLI đã sẵn sàng. Để thiết lập app, sản phẩm và paywall từ chat, hãy xem hướng dẫn quickstart.

Khắc phục sự cố