Trước khi bắt đầu
Bạn cần:- Claude Code đã cài và đăng nhập (chạy được lệnh
claudetrong terminal). - Một tài khoản Meta Business có quyền trên ad account bạn muốn đọc/quản lý.
- Đăng nhập Facebook được (kèm mã 2FA nếu tài khoản có bật).
Đây là remote MCP server do Meta host. Khác với cách cài server local (như Google Ads MCP), bạn không cài gì lên máy — chỉ thêm URL và xác thực một lần.
Phần A — Kết nối (Terminal)
Thêm Meta Ads MCP vào Claude Code
Chạy một lệnh duy nhất để đăng ký server qua transport HTTP:
Terminal
meta-adslà tên gọi tùy bạn đặt (sẽ hiện trong danh sách server).- Lệnh chỉ khai báo server; chưa đăng nhập — bước xác thực ở Bước 2.
Prompt cho Claude Code
Prompt cho Claude Code
Đăng nhập bằng OAuth
Trong Claude Code, gõ lệnh:
- Chọn meta-ads trong danh sách, rồi chọn Authenticate.
- Trình duyệt mở cửa sổ OAuth trên facebook.com. Đăng nhập, nhập mã 2FA nếu có.
- Chọn ad account (và Page) muốn cấp quyền, rồi chọn mức quyền (xem bảng bên dưới).
- Xác nhận. Cửa sổ báo thành công là xong; quay lại Claude Code.
Chọn mức quyền
Lúc đăng nhập OAuth, Meta cho bạn chọn một trong ba mức. Chọn mức thấp nhất đủ dùng.| Mức quyền | Làm được gì | Nên dùng khi |
|---|---|---|
| Read-only | Chỉ đọc: báo cáo, chỉ số, cấu trúc campaign | Phân tích, làm báo cáo — an toàn nhất |
| Read/write | Đọc + tạo/sửa campaign, ad set, quảng cáo, đối tượng | Muốn Claude trực tiếp chỉnh chiến dịch |
| Read/write/financial | Như trên + thao tác liên quan ngân sách/thanh toán | Chỉ khi cần đổi ngân sách qua Claude |
Dùng để làm gì?
Server chính thức có khoảng 29 công cụ, chia theo nhóm dưới đây. Bạn ra lệnh bằng ngôn ngữ tự nhiên, Claude tự chọn công cụ phù hợp.- Báo cáo & phân tích
- Quản lý chiến dịch
- Đối tượng & chẩn đoán
Đọc hiệu suất chiến dịch, không đổi gì (an toàn với mọi mức quyền).
Chi phí theo campaign
Chi phí theo campaign
Cho tôi chi phí, số kết quả và CPA của từng campaign trong 30 ngày qua, sắp theo chi phí giảm dần.
Ad set đốt tiền
Ad set đốt tiền
Liệt kê top 10 ad set tốn nhiều tiền nhất mà không ra chuyển đổi trong 14 ngày qua, để tôi cân nhắc tắt.
So sánh 2 kỳ
So sánh 2 kỳ
So sánh chi phí, ROAS và số chuyển đổi theo campaign giữa 7 ngày gần nhất và 7 ngày trước đó, chỉ ra chỗ lên/xuống mạnh.
Hiệu quả sáng tạo
Hiệu quả sáng tạo
Xếp hạng các quảng cáo (creative) theo CTR và CPA trong 30 ngày, chỉ ra mẫu nào nên nhân bản và mẫu nào nên dừng.
Nâng cao — Tự host server (tùy chọn)
Nếu bạn cần chạy MCP trên hạ tầng riêng, hoặc tích hợp lập trình sâu, có các server cộng đồng kết nối trực tiếp Meta Marketing API bằng access token (cần tạo Meta Developer App và token với quyềnads_read, business_management). Cách này phức tạp và tự bảo trì hơn hẳn MCP chính thức.
pipeboard-co/meta-ads-mcp
Server quản lý Facebook & Instagram Ads, có bản self-host và bản hosted.
Tài liệu Meta Ads AI Connectors
Trang chính thức của Meta về MCP và CLI.
Với hầu hết người dùng, MCP chính thức ở Phần A là lựa chọn nên dùng: không cần Developer App, không quản lý token, và Meta lo phần xác thực an toàn.
Xử lý lỗi
Server không hiện tool / /mcp báo chưa kết nối
Server không hiện tool / /mcp báo chưa kết nối
Triệu chứng: Chạy
/mcp thấy meta-ads nhưng không có tool, hoặc trạng thái chưa kết nối.Nguyên nhân: Chưa hoàn tất OAuth, hoặc phiên hiện tại chưa nạp server.Cách sửa: Chạy /mcp, chọn meta-ads → Authenticate, hoàn tất đăng nhập trên trình duyệt. Mở lại phiên Claude Code nếu vẫn chưa thấy tool.Cửa sổ OAuth không mở
Cửa sổ OAuth không mở
Triệu chứng: Chọn Authenticate nhưng trình duyệt không bật.Nguyên nhân: Trình duyệt chặn pop-up, hoặc chưa có trình duyệt mặc định.Cách sửa: Cho phép pop-up, đặt trình duyệt mặc định, rồi chạy lại
/mcp → Authenticate. Nếu terminal in ra một URL, mở URL đó thủ công.Không thấy ad account cần dùng
Không thấy ad account cần dùng
Triệu chứng: Đăng nhập xong nhưng thiếu tài khoản quảng cáo trong danh sách.Nguyên nhân: Tài khoản Facebook đăng nhập không có quyền trên ad account đó, hoặc bạn chọn nhầm Business.Cách sửa: Đảm bảo bạn có quyền trong Meta Business Suite. Chạy lại
/mcp → Authenticate và chọn đúng Business/ad account.Không thực hiện được thao tác chỉnh sửa
Không thực hiện được thao tác chỉnh sửa
Triệu chứng: Claude báo không có quyền tạo/sửa campaign hoặc đổi ngân sách.Nguyên nhân: Bạn cấp mức Read-only lúc đăng nhập.Cách sửa: Chạy lại
/mcp → Authenticate, chọn Read/write (hoặc read/write/financial nếu cần đổi ngân sách).Lỗi phiên hết hạn sau một thời gian
Lỗi phiên hết hạn sau một thời gian
Triệu chứng: Đang chạy được rồi báo lỗi xác thực.Nguyên nhân: Phiên OAuth hết hạn hoặc bị thu hồi.Cách sửa: Chạy
/mcp → Authenticate để đăng nhập lại. Token do Meta quản lý, bạn không cần chỉnh file config.Prompt để Claude tự chẩn đoán
Prompt để Claude tự chẩn đoán

