Hướng dẫn cài Adam Ads MCP

Khoảng 15 phút. Làm lần lượt trên đúng máy bạn sẽ dùng, vì bản quyền gắn với một máy. Kẹt ở đâu thì xem mục Gặp lỗi ở cuối trang hoặc nhắn Zalo.

Tải bộ càiWindowsWindows 10 và 11MTải bộ càimacOS chip AppleMac M1, M2, M3, M4x86Tải bộ càimacOS chip IntelMac đời trước 2021

Máy Mac của bạn chip gì? Bấm quả táo góc trên bên trái → Giới thiệu về máy Mac này: ghi “Chip Apple M…” là chip Apple, ghi “Bộ xử lý … Intel” là chip Intel.

Bản 0.2.2 · Windows 10/11, macOS 11 trở lên

Cần chuẩn bị

• Máy Windows 10/11, hoặc Mac chạy macOS 11 trở lên (chip Apple hoặc Intel), có mạng.
• Quyền quản trị Business Manager đang giữ tài khoản quảng cáo.
• Claude Desktop (khuyên dùng). Hoặc Claude Code, Cursor, Gemini CLI.
• Windows cần Node.js 18 trở lên: chưa có thì trình cài hỏi cài giúp, bấm c. Mac: bộ cài tự tải Node.js đúng chip, không cần làm gì.

1. 1

   Tải và chạy bộ cài

   • Bấm nút tải đúng máy ở đầu trang: Windows, Mac chip Apple, hoặc Mac chip Intel.
   • Windows: chuột phải tệp zip → Extract All (Giải nén tất cả). Mở thư mục vừa giải nén, bấm đúp CAI-DAT.cmd. Windows hỏi có chạy tệp tải từ mạng không thì chọn Run (Chạy).
   • Mac: bấm đúp tệp zip để giải nén (Safari thường tự giải nén trong Tải về). Mở Terminal (Cmd+Space, gõ Terminal). Gõ bash và một dấu cách, kéo tệp CAI-DAT.command trong thư mục adam-ads-mcp vào cửa sổ Terminal, bấm Enter. Lần đầu bộ cài tải Node.js (khoảng 50 MB), không hỏi mật khẩu máy.
   • Cửa sổ hiện “ADAM ADS MCP: CÀI ĐẶT”, chép phần mềm vào máy. Đừng đóng cửa sổ này.

   Mac: bấm đúp CAI-DAT.command cũng được. macOS báo không xác minh được nhà phát triển thì vào Cài đặt hệ thống → Quyền riêng tư và bảo mật → kéo xuống, bấm “Vẫn mở”.

   bash ~/Downloads/adam-ads-mcp/CAI-DAT.command

2. 2

   Lấy token Meta (một lần, khoảng 10 phút)

   • Dùng Người dùng hệ thống để token không hết hạn sau 60 ngày.
   • 1. Vào developers.facebook.com/apps → Tạo ứng dụng → loại Doanh nghiệp → gắn vào Business Manager của bạn. Thêm sản phẩm Marketing API.
   • 2. Vào business.facebook.com/settings → Người dùng → Người dùng hệ thống → Thêm. Đặt tên, ví dụ “AI quảng cáo”, vai trò Quản trị viên.
   • 3. Bấm Gán tài sản: chọn các tài khoản quảng cáo (quyền Quản lý chiến dịch hoặc Toàn quyền) và các Trang cần dùng.
   • 4. Bấm Tạo mã → chọn ứng dụng vừa tạo → hạn Không bao giờ → tích 5 quyền: ads_read, ads_management, business_management, pages_show_list, pages_read_engagement.
   • 5. Chép mã, bắt đầu bằng EAA. Giữ kín như mật khẩu.

   Chỉ muốn AI xem báo cáo, không cho sửa: chỉ tích ads_read, hoặc chọn chế độ chỉ xem ở bước 4.

3. 3

   Dán token vào cửa sổ cài

   • Quay lại cửa sổ cài. Tới dòng “Dán token Meta rồi bấm Enter”, bấm Ctrl+V (Mac: Cmd+V) để dán.
   • Token hiện thành dấu * để không lộ. Dài vài dòng là đúng. Bấm Enter.
   • Trình cài báo “Đã nhận … ký tự”, rồi kiểm token với Meta. Đúng thì hiện “✔ Token hợp lệ” và danh sách tài khoản quảng cáo.
   • Sai thì hiện dòng ✘ kèm lý do và cho dán lại, tối đa 3 lần. Token chỉ lưu trên máy bạn, Adam Uses AI không nhận.

   

   

4. 4

   Trả lời các câu hỏi còn lại

   • Trình cài hỏi thêm vài câu. Không chắc thì bấm Enter để giữ mặc định, sau này sửa lại bằng lệnh adam-ads cai-dat.

   Câu hỏi	Nên trả lời
   Chỉ cho AI dùng các tài khoản nào?	Enter để dùng tất cả. Hoặc gõ số, ví dụ 1,3.
   CPA mục tiêu	Mỗi tin nhắn hoặc đơn đáng bao nhiêu tiền, ví dụ 40000. Chưa rõ thì bỏ trống.
   Chế độ CHỈ XEM?	k nếu muốn AI được sửa (vẫn phải hỏi bạn trước). c nếu chỉ cho xem.
   Nhận báo cáo qua Telegram?	k nếu chưa cần. Muốn bật xem mục Telegram bên dưới.
   Chạy theo dõi nền mỗi khi đăng nhập?	c nếu đã bật Telegram, để nhận báo cáo sáng và cảnh báo.

5. 5

   Mở trang mua đã gắn mã máy

   • Cài xong, phần mềm còn khoá cho tới khi có bản quyền.
   • Windows: mở PowerShell (bấm Start, gõ PowerShell). Mac: mở cửa sổ Terminal MỚI. Chạy lệnh dưới.
   • Trình duyệt mở trang mua đã điền sẵn mã máy. Điền họ tên, số điện thoại, email, rồi quét QR chuyển khoản. Nội dung chuyển khoản là mã đơn, trang đã ghi sẵn.

   adam-ads mua

   

6. 6

   Bấm mở bản quyền

   • Chuyển khoản xong, trang tự chuyển sang “Đã nhận đủ tiền”.
   • Bấm nút mở bản quyền, chờ vài giây.

   

7. 7

   Chép lệnh kích hoạt

   • Trang hiện mã bản quyền, mã máy, và lệnh kích hoạt có sẵn mã đơn. Bấm “Chép lệnh”.
   • Thư kèm bản quyền cũng gửi tới email bạn đã khai. Giữ trang hoặc ghi lại mã đơn.

   

8. 8

   Dán lệnh để kích hoạt

   • Mở PowerShell hoặc Terminal MỚI trên đúng máy đó, dán lệnh vừa chép, bấm Enter.
   • Thấy “✔ Đã kích hoạt bản quyền vĩnh viễn trên máy này” là xong.
   • Không có mạng thì dán mã bản quyền (bắt đầu ADAM3-ADSMCP-) thay cho mã đơn.

   adam-ads kich-hoat <MÃ ĐƠN>

   

9. 9

   Mở lại Claude và hỏi

   • Thoát hẳn Claude Desktop rồi mở lại. Windows: chuột phải biểu tượng Claude ở khay hệ thống (góc phải dưới) → Quit. Mac: bấm Cmd+Q trong Claude.
   • Gõ “Kiểm tra kết nối quảng cáo”. Claude báo thấy tài khoản là xong.
   • Thử tiếp: “Hôm qua chi bao nhiêu, ra bao nhiêu tin nhắn?”, “Vì sao giá tin nhắn tuần này tăng?”, “Nhóm nào nên tắt, CPA mục tiêu 40.000đ”, “Tăng ngân sách chiến dịch X thêm 20%”.
   • Mọi lệnh sửa đều có bước xem trước: AI đọc cho bạn thay đổi, bạn đồng ý mới làm. Chiến dịch tạo mới luôn ở trạng thái tạm dừng.

   

Cần người giúp? Nhắn Zalo 0813967222 kèm mã đơn và ảnh chụp cửa sổ lỗi.

Xem trang sản phẩm Adam Ads MCP →