Từ lúc thêm connector tới câu trả lời đầu tiên

• Một Trợ lý AI hỗ trợ máy chủ MCP từ xa có đăng nhập OAuth: Claude, ChatGPT, Gemini, Cursor, VS Code, Claude Code, Gemini CLI hoặc tương tự.
• Một tài khoản Google để đăng nhập hecigo. Không cần tạo mật khẩu mới.
• Quyền xem trên tài khoản quảng cáo bạn muốn đọc. Quyền xem là đủ để đọc số liệu. Chỉ khi muốn thử đổi ngân sách mới cần quyền chỉnh sửa trên tài khoản đó.

Địa chỉ connector giống nhau với mọi Trợ lý AI. Bấm Mở nhanh để chép sẵn địa chỉ và mở đúng trang cài đặt của Trợ lý AI, hoặc chọn Trợ lý AI bên dưới để làm từng bước.

{
  "mcpServers": {
    "ads-insights": {
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

{
  "servers": {
    "ads-insights": {
      "type": "http",
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

claude mcp add --transport http ads-insights https://ads.hecigo.com/mcp

gemini mcp add --transport http --scope user ads-insights https://ads.hecigo.com/mcp

1

Đăng nhập bằng Google

Trang của hecigo mở ra. Bấm Đăng nhập bằng Google, chọn tài khoản nào cũng được. Lần đầu, hecigo tạo ngay một workspace mặc định chỉ có quyền đọc, không có công cụ đổi ngân sách, và gửi email chào mừng. Đã đăng nhập portal trên trình duyệt này trong 30 ngày thì trang nhận ra bạn luôn.

2

Cho phép, hoặc nối nền tảng trước

Workspace đã nối nền tảng quảng cáo: hecigo cho phép và đưa bạn về Trợ lý AI ngay. Chưa nối nền tảng nào: trang hiện một nút Nối tài khoản quảng cáo. Bấm là Trợ lý AI được kết nối, tab này quay về Trợ lý AI, và trang chọn nền tảng mở ở tab mới.

3

Muốn dùng workspace khác

Bấm Dùng tài khoản Google khác ngay dưới nút, rồi đăng nhập bằng tài khoản của workspace đó. Mã mời hoặc khoá workspace chỉ dành cho người được hecigo gửi, nằm trong mục thu gọn.

Khi hecigo tạm bật duyệt tay, bước 2 thành một yêu cầu truy cập: bạn nhận email khi được duyệt, rồi quay lại Trợ lý AI và kết nối lần nữa.

Trợ lý AI đọc được nền tảng đã nối vào workspace, kể cả khi connector đã thêm xong. Trang chọn nền tảng mở từ nút Nối tài khoản quảng cáo ở bước trên, từ mục Bước 1 trong portal tại ads.hecigo.com/portal, hoặc từ liên kết Trợ lý AI đưa khi bạn hỏi mà chưa nối gì. Liên kết đó dùng được 15 phút.

Portal hiện nền tảng nào đang được đọc, Trợ lý AI nào đang kết nối, và có nút ngắt từng nền tảng, từng Trợ lý AI. Ngắt Google Ads trong portal thì hecigo xoá quyền của mình; xem và thu hồi mọi quyền đã cấp tại myaccount.google.com/permissions.

Hỏi Trợ lý AI câu dưới. Trợ lý AI gọi công cụ ads_health, cho biết nền tảng nào đã nối và còn dùng được, và đưa liên kết nối nếu chưa nối gì.

Hỏi như hỏi một chuyên viên quảng cáo: nói rõ khoảng ngày, nền tảng và điều bạn cần quyết định. Trợ lý AI tự kết hợp các công cụ, số liệu lấy thẳng từ nền tảng. Các câu này chỉ lấy số liệu, không thay đổi gì trong tài khoản. Đổi ngân sách là việc riêng, chỉ có ở workspace được cấp quyền ghi (xem skill budget-adjust).

Connector cho Trợ lý AI đọc số liệu. Bộ skill của hecigo thêm cách làm: sáu quy trình viết sẵn mà Claude tự dùng khi câu hỏi khớp. Bộ skill chỉ chạy trên Claude (chat, Cowork, Claude Code). ChatGPT, Gemini hay Cursor không dùng skill của Claude, nhưng phần cốt lõi, như cách đọc chi phí Meta và so hai kỳ, đã nằm sẵn trong connector.

• meta-vn-diagnosis: Vì sao chi phí Meta tăng; nên tăng ngân sách, giữ, sửa hay dừng. Có cách tính cho shop bán qua inbox.
• weekly-ads-report: Báo cáo tuần cho chủ doanh nghiệp, so với tuần trước.
• roas-target-audit: ROAS và CPA thực tế so với target đang cài.
• search-term-cleanup: Search term tốn tiền mà không ra đơn, kèm danh sách từ khoá phủ định đề xuất.
• performance-max-audit: Soát Performance Max: asset yếu, tín hiệu tệp, ROAS từng asset group.
• budget-adjust: Đổi ngân sách an toàn: luôn lập kế hoạch trước, cho bạn xem chênh lệch, chỉ áp dụng sau khi bạn xác nhận. Việc xác nhận là quy trình skill làm theo, máy chủ không kiểm tra được. Chỉ có ở workspace được cấp quyền ghi.

/plugin marketplace add hecigo/ads-insights-plugin
/plugin install hecigo-ads-insights@hecigo

Có bản skill mới: với Sync automatically, Claude tự nhận; nếu Claude báo cần cấp quyền GitHub cho việc tự đồng bộ, vào Customize → Plugins → Add → Manage marketplaces, bấm ⋮ cạnh ads-insights-plugin → Check for updates. Gói Team và Enterprise: không thấy Add marketplace thì chủ tổ chức cần cho phép thành viên tự thêm.

• Chọn cùng khoảng ngày và bỏ ngày hôm nay. Các mốc như 7 ngày qua trong Ads Manager không tính hôm nay, còn số của hôm nay vẫn đang chạy.
• Ngày tính theo múi giờ của tài khoản quảng cáo, không theo múi giờ máy bạn.
• Cột Clicks của Meta gồm cả lượt bấm ảnh và bấm xem thêm. Muốn so lượt vào trang thì hỏi theo link click.
• Mỗi nền tảng ghi nhận chuyển đổi theo cửa sổ riêng, nên đừng cộng thẳng chuyển đổi của nền tảng này với nền tảng kia rồi so với một con số duy nhất.
• ROAS và giá trị chuyển đổi là số của chính nền tảng. Google tính theo các hành động chuyển đổi chính, Meta chỉ tính giá trị của đúng hành động được đếm. Muốn biết hành động nào đang được đếm thì hỏi soát chuyển đổi.

Cần người giúp?

Kẹt ở bước nào thì nhắn hecigo, kèm ảnh chụp màn hình bước đó.

Zalo hecigo · Messenger · hi@hecigo.com