MCP Ads — Cài đặt dự án & Biến cấu hình (P2PDigital Data Marts UI)

1. Kết nối Bot Telegram (@BotFather) Chế độ Simulator

Chạy cơ chế Long-Polling trực tiếp từ máy của bạn (không cần mở Port hay cài Webhook/ngrok). Chỉ cần dán TELEGRAM_BOT_TOKEN là nhận tin nhắn tức thì:

Hướng dẫn lấy Token trong 20 giây

Mở ứng dụng Telegram, tìm @BotFather → gửi lệnh /newbot.
Đặt tên Bot (VD: Enomarker Ads AI) và username đuôi _bot.
Copy chuỗi Token dán vào ô trên → Bấm Bật Bot.

2. Não bộ AI Setup Ads (OpenRouter) OpenRouter Active

Tích hợp OpenRouter API chuyên biệt cho giao tiếp tự nhiên & Setup Ads (tự động dự phòng 3 tầng model thông minh):

Model AI trên OpenRouter:

Chỉ dẫn Hệ thống (System Prompt chuyên Setup Ads):

3. Nhật ký Tin nhắn Telegram Live 0 tin

Đang chờ tin nhắn từ Telegram hoặc khung Simulator bên phải...

TG·AI

Trợ lý AI Setup Ads

OpenRouter AI · Chuyên biệt Setup Ads & Hội thoại tự nhiên

FB · Enomarker Case 1 · 4 Nhóm BAU · Line 21

Tùy chỉnh

Biến dùng lại

Lưu giá trị an toàn (META_ACCESS_TOKEN, TIKTOK_ACCESS_TOKEN, ID tài khoản, MAX_DAILY_BUDGET). Tự động đồng bộ vào file .env của MCP Server.

Hướng dẫn Setup & Sử dụng Hệ thống MCP Ads (Facebook Ads · TikTok Ads · Apify Post Resolver V2.0)

Tài liệu hướng dẫn từng bước từ khâu cài đặt Token, giải mã Link bài viết Facebook không có Post ID (pfbid... / share/p/...), vận hành Case 1 & Case 2 trên Webapp hoặc qua câu lệnh AI (Claude / ChatGPT / Cursor / Antigravity).

Tổng cộng: 67 MCP Tools 30 Facebook Core + 27 TikTok Core + 7 Workflow/Apify + 3 Shared Tích hợp Apify Post Resolver V2.0 & Telegram AI Bot

Bước 1 · Hướng dẫn Setup Token & Biến cấu hình (Làm 1 lần duy nhất)

1. Facebook Ads (Meta Marketing API)

Truy cập Meta Business Settings → System Users (hoặc Graph API Explorer).
Tạo Token với 3 quyền: ads_management, ads_read, pages_read_engagement.
Mở tab Biến cấu hình → Sửa biến META_ACCESS_TOKEN và dán Token vào.
Cập nhật FacebookAdsAccountId (ví dụ: act_123456789).

2. Apify Token (Lấy Post ID từ Link Facebook)

Khi khách gửi link bài viết dạng pfbid... hoặc facebook.com/share/p/... không có ID số.
Lấy API Token tại console.apify.com → Settings → Integrations.
Vào tab Biến cấu hình → Lưu vào biến APIFY_API_TOKEN.
Actor mặc định: topapi~facebook-post-details-scraper (dự phòng: lordfloofington~facebook-posts-scraper).

3. TikTok Ads & Chế độ Chạy thử (DRY_RUN)

Với TikTok Ads: Lưu TIKTOK_ACCESS_TOKEN và TIKTOK_ADVERTISER_ID trong tab Biến cấu hình.
Chế độ DRY_RUN=true (Mặc định): Bạn có thể test toàn bộ 66 Tools, Case 1, Case 2 ngay lập tức mà chưa cần Token thật và không tốn tiền.
Khi muốn đẩy lệnh thật lên Meta/TikTok: Vào tab Luật bảo vệ → Chuyển DRY_RUN sang false.

Bước 2 · Hướng dẫn vận hành 2 Case Thực chiến & Giải mã Link Facebook

Case 1: Tạo QC mới trong ~5 chiến dịch → Đổi tên QC → Đổi bài viết fb_workflow_bulk_ads_in_campaigns

Mở tab Quy trình 2 Case trên thanh công cụ.
Chọn Chiến dịch & Nhóm QC: Tích chọn các nhóm quảng cáo phù hợp nằm trong ~5 chiến dịch của bạn (hoặc nhập thêm ID nhóm).
Đổi tên quảng cáo mới: Nhập tên mẫu (có thể dùng {index} để đánh số thứ tự tự động hoặc {format} để gắn nhãn SINGLE/VIDEO).
Đổi bài viết quảng cáo: Nhập Page ID + Dán thẳng Link Facebook khách gửi (hoặc nhập Post ID). Hệ thống tự động bóc Post ID qua Apify và tạo quảng cáo đồng loạt ở trạng thái PAUSED.

Case 2: Copy chiến dịch → Đổi 3 tầng (Chiến dịch → Nhóm → Quảng cáo) fb_workflow_clone_and_customize_campaign

Tầng 1 (Chiến dịch): Chọn chiến dịch gốc cần Copy → Nhập Tên chiến dịch mới → (Tùy chọn) Đổi Mục tiêu quảng cáo (Objective) → Đổi Ngân sách ngày.
Tầng 2 (Nhóm quảng cáo): Đổi Ngày kết thúc (End Time) → (Tùy chọn) Đổi Mục tiêu Optimize (VD: sang CONVERSATIONS hoặc OFFSITE_CONVERSIONS).
Tầng 3 (Mẫu quảng cáo): Đổi Tên mẫu quảng cáo → Dán Link bài viết Facebook mới (hoặc Post ID mới) → Nhấn Thực thi Case 2 Ngay!

Quy luật Đặt tên 3 Cấp độ Chuẩn (Trích xuất từ Tài khoản `act_699835376319048` — Enomarker / FWD)

fb_generate_standard_names

Cấp 1 · Chiến dịch (Campaign)

FWD_<DD/MM/YYYY>_Facebook_<Aution|Reservation>_<Objective>_<Theme>-<MM.YYYY>_<SubObjective>_<Segment>

Lưu ý đặc trưng: Cấp Campaign dùng chữ Aution (thiếu chữ c), còn cấp Ad Set dùng Auction.
VD Brand: FWD_01/10/2026_Facebook_Aution_Reach and Frequency_BAU,ILP,NNL-10.2026_Awareness_HCMC, HAN
VD E-com: FWD_26/08/2026_Facebook_Aution_Conversion_Bảo hiểm tai nạn trực tuyến-08.2026_PROSPECTING-All

Cấp 2 · Nhóm quảng cáo (Ad Set — Mẫu 2A & 2B)

2A: FWD_25-44_All_TA: <Pillar>-<MM.YYYY>_Auction_<Opt>_<Geo> (line <XX>)
2B: FWD_25-44_All_<OptGoal>_TA: <SP>-<MM.YYYY>_PROSPECTING-<Nhóm> (line <XX>)

VD 2A: FWD_25-44_All_TA: BAU,ILP,NNL-10.2026_Auction_Reach_HCM,HN (line 17)
VD 2B: FWD_25-44_All_Conversion-optimize-purchase_TA: Bảo hiểm tai nạn trực tuyến-08.2026_PROSPECTING-All (line 15)

Cấp 3 · Quảng cáo (Ad — Mẫu 3A, 3B & 3C)

3A (BAU): <Pillar>_<Topic>_<PostID>_<Single|Multi|Video>
3B (Ecom): <Nhóm>_dark-post_post<X>[-tiktok]_<single|video>
3C (Banca): Banca Recruitment - <Tệp>_Nhóm <X.Y>_Ads ẩn[-OTP]_Single

VD 3A (Tự động ghép từ Apify): BAU - AWO_Chúc mừng ngày 20/10_1552367370261684_Multi
VD 3B: Nhóm All_dark-post_post7_single | Nhóm All_dark-post_post4.2-tiktok_video

Bước 3 · Kết nối MCP Server vào Antigravity / Claude / Cursor / ChatGPT

Tên kết nối MCP: mcp-ads
Server URL (Streamable HTTP): http://localhost:3456/mcp/...
Lệnh cài nhanh Claude CLI: claude mcp add --transport http mcp-ads http://localhost:3456/mcp/...

Cấu hình JSON chuẩn (Dán vào mcp_config.json hoặc claude_desktop_config.json):

Bước 4 · Mẫu câu lệnh Prompt tiếng Việt (Sao chép hoặc Chạy thử 1-Click)

Mẫu 1 (Case 1 + Apify Link): Tạo quảng cáo mới trong 5 chiến dịch từ Link bài viết Facebook khách gửi

Dùng kết nối mcp-ads:
Khách vừa gửi link bài viết Facebook: https://www.facebook.com/share/p/1awRNmLmbv/ (Page ID: 1029384756).
Hãy gọi fb_workflow_bulk_ads_in_campaigns để tự động lấy Post ID qua Apify và tạo quảng cáo mới trong 5 chiến dịch (camp_101, camp_102, camp_103, camp_104, camp_105) với các nhóm quảng cáo đã chọn, đổi tên quảng cáo thành "QC_BaiVietMoi_2610_#{index}" và giữ trạng thái PAUSED.

Mẫu 2 (Case 2 Full 3 Tầng): Copy chiến dịch → Đổi tên / mục tiêu / ngân sách → Đổi ngày kết thúc / optimize nhóm → Đổi mẫu QC

Dùng kết nối mcp-ads:
Hãy gọi fb_workflow_clone_and_customize_campaign để copy chiến dịch gốc "camp_101_sale_thang10":
1. Đổi tên chiến dịch thành "VN_Sale_Thang11_Copy_Moi", đổi mục tiêu sang OUTCOME_ENGAGEMENT, ngân sách ngày 600.000 VND.
2. Trong nhóm quảng cáo: đổi ngày kết thúc thành 2026-11-30T23:59:00+07:00 và đổi mục tiêu optimize sang CONVERSATIONS.
3. Qua phần quảng cáo: đổi tên mẫu quảng cáo thành "Mau_QC_Moi_Thang11_V1" và đổi bài viết sang link https://www.facebook.com/doctorcare.vietnam/posts/pfbid02y5FjRTs5BbkV2ag41VVZrctmSyMU19kGXrNz5o6Xmewy9NCk5SyS8Nqr79QA4buAl (Page ID: 1029384756).

Phân quyền thực thi cho Trợ lý AI

Kiểm soát các nhóm thao tác mà AI được phép thực hiện qua kết nối MCP. Quyền Xóa (Delete) mặc định bị khóa.

Đọc dữ liệu (Read)

Xem chiến dịch, báo cáo chỉ số

Bật / Tắt (Status)

Tạm dừng hoặc kích hoạt

Cập nhật (Update)

Chỉnh sửa ngân sách, giá thầu

Nhân bản (Copy)

Sao chép chiến dịch

Tạo mới (Create)

Luôn tạo ở trạng thái PAUSED

Xóa (Delete — Khóa)

Chặn AI xóa chiến dịch

Giới hạn Ngân sách & Chế độ Chạy thử (Dry-Run)

Mọi thay đổi tại đây sẽ cập nhật đồng bộ với danh sách biến trong tab Biến cấu hình.

Chế độ vận hành (DRY_RUN):

Đơn vị tiền tệ (ACCOUNT_CURRENCY):

Trần ngân sách/ngày (MAX_DAILY_BUDGET):

Nền tảng thực thi:

Tài khoản:

APIFY V2.0 + NAMING RULE

Giải mã Link Facebook (`pfbid...` / `share/p/...`) & Tự động Đặt tên Ad Chuẩn (`<Pillar>_<Topic>_<PostID>_<Format>`)

Tích hợp Facebook Post (Apify) v2.0 & quy luật đặt tên thực tế từ act_699835376319048: Tự động bóc Post ID + Format (Single / Multi / Video) và ghép tên Ad chuẩn Mẫu 3A để đẩy thẳng xuống Case 1 hoặc Case 2.

✦ AI Phân tích Cú pháp Brief Zalo / Khách gửi (Tự động Đặt tên · Chọn Bài · Lọc Nhóm QC)

Dán nguyên tin nhắn Brief chứa STT, Phase, Angle, Ngày air, Link air — hệ thống tự bóc tách cú pháp, giải mã Post ID & điền xuống Case 1 / Case 2.

1. Pillar (Tự điền hoặc lấy từ Phase trong Brief):

2. Topic / Content bài viết (Tự điền hoặc lấy từ Angle trong Brief):

CASE 1

Tạo quảng cáo mới trong ~5 chiến dịch (`act_699835376319048`) → Chọn nhóm QC → Đổi tên QC Chuẩn → Đổi bài viết

Danh sách 5 chiến dịch thực tế đang chạy của tài khoản Enomarker (FWD Vietnam) kèm các Nhóm quảng cáo chuẩn (line 15..20). Tự động ghép tên Ad theo công thức <Pillar>_<Topic>_<PostID>_<Single|Multi|Video>.

1. Chọn Chiến dịch (~5 chiến dịch thực tế) & tích chọn các Nhóm quảng cáo phù hợp:

Hoặc nhập thêm ID nhóm quảng cáo (cách nhau dấu phẩy):

2. Điền Pillar & Topic/Content → Tự động ghép Tên Quảng cáo:

Tên quảng cáo hoàn chỉnh (ad_name — tự động thay {post_id} & {format_title} từ Apify):

3. Đổi bài viết quảng cáo (Nhập Post ID HOẶC dán thẳng Link Facebook khách gửi):

Khi dán Link Facebook, hệ thống tự gọi Apify lấy {post_id} + {format_title} và điền thẳng vào tên quảng cáo!

CASE 2

Copy chiến dịch hiện có → Đổi Tên Chuẩn / Mục tiêu / Ngân sách → Đổi Tên / Ngày kết thúc / Optimize Nhóm → Đổi Tên & Mẫu QC

Tự động nhân bản chiến dịch gốc (VD: 120248916798760576 hoặc cụm BAU,ILP,NNL) và chuẩn hóa tên cả 3 tầng theo đúng công thức của act_699835376319048.

Bước 1 · Tầng Chiến dịch (Campaign Formula)

Chiến dịch gốc cần Copy (source_campaign_id):

Đổi tên chiến dịch mới chuẩn FWD (new_campaign_name):

Đổi mục tiêu quảng cáo (new_objective — Tùy chọn):

Đổi ngân sách ngày (new_daily_budget):

Bước 2 · Tầng Nhóm quảng cáo (Mẫu 2A / 2B + Line XX)

Tên Nhóm quảng cáo mới (new_adset_name):

Đổi ngày kết thúc (new_end_time):

Đổi mục tiêu Optimize (new_optimization_goal — Tùy chọn):

ID Nhóm quảng cáo cụ thể (Để trống = Toàn bộ nhóm trong chiến dịch):

Bước 3 · Tầng Quảng cáo (Điền Pillar + Topic/Content)

Pillar (Bạn điền):

Topic / Content (Bạn điền):

Tên mẫu quảng cáo (new_ad_name):

ID Trang / Fanpage (page_id):

Đổi mẫu quảng cáo (Nhập Post ID HOẶC dán Link Facebook):

NHẬT KÝ & KẾT QUẢ THỰC THI QUY TRÌNH (CASE 1 & CASE 2 & APIFY) SẴN SÀNG

Chọn Case 1 hoặc Case 2 ở trên và nhấn "Thực thi Ngay" để xem kết quả chi tiết...

Kịch bản test 1-Click:

check_connections

KẾT QUẢ PHẢN HỒI SẴN SÀNG

Bấm "Chạy Tool Ngay" để kiểm tra kết quả...

Nhật ký thực thi MCP Tools

Cài đặt dự án & Trợ lý Bot