hecigo Ads InsightsMCP server
← Về trang chính

Hướng dẫn

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

Khoảng 5 phút. Bạn cần một trợ lý hỗ trợ MCP như Claude, ChatGPT hay Cursor, một tài khoản Google và quyền xem tài khoản quảng cáo. Xong là hỏi được chi tiêu, ROAS, target giá thầu, search terms và cài đặt chiến dịch ngay trong trợ lý.

1

Trước khi bắt đầu

  • Một trợ lý hỗ trợ máy chủ MCP từ xa có đăng nhập OAuth: Claude, ChatGPT, Cursor, VS Code, Claude Code 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 chỉ đọc là đủ, và nên dùng đúng quyền đó.
2

Thêm connector

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

https://ads.hecigo.com/mcp
Hoặc mở thẳng trợ lý

Bấm là địa chỉ đã được chép sẵn. Cursor và VS Code tự điền; Claude và ChatGPT mở trang connector để bạn dán vào. ChatGPT cần bật Developer mode.

Claude

web, Desktop, ứng dụng di động, Cowork
  1. Mở Customize, chọn Connectors.
  2. Bấm +, chọn Add custom connector.
  3. Đặt tên Ads Insights, dán địa chỉ connector, rồi bấm Add.
  4. Bấm Connect ở connector vừa thêm. Trang đăng nhập của hecigo mở ra.
  5. Trong cuộc trò chuyện, bấm + ở góc dưới bên trái, chọn Connectors và bật Ads Insights.

Gói Free thêm được một custom connector. Gói Team và Enterprise: chủ tổ chức thêm connector trong Organization settings, thành viên chỉ cần bấm Connect. Thêm một lần là dùng được cả trên web, Desktop, Cowork và điện thoại.

Thêm connector
Add

Minh hoạ. Giao diện thật có thể khác đôi chút tuỳ phiên bản.

ChatGPT

bản web
  1. Mở Settings, vào Security and login, bật Developer mode.
  2. Mở Plugins tại chatgpt.com/plugins và bấm + để tạo app mới.
  3. Đặt tên Ads Insights, dán địa chỉ connector làm MCP server URL và chọn đăng nhập OAuth.
  4. Tạo app. ChatGPT mở trang đăng nhập của hecigo.
  5. Trong cuộc trò chuyện mới, bấm +, chọn Developer mode rồi chọn Ads Insights.

Developer mode có ở gói Plus, Pro, Business, Enterprise và Education, trên bản web. Tên các mục trong ChatGPT đổi theo phiên bản; không thấy thì xem trang trợ giúp của OpenAI về Developer mode.

Thêm connector
Create

Minh hoạ. Giao diện thật có thể khác đôi chút tuỳ phiên bản.

Cursor

trình soạn code
  1. Bấm Thêm vào Cursor ở mục Mở nhanh phía trên. Hoặc mở ~/.cursor/mcp.json để dùng cho mọi dự án, hay .cursor/mcp.json trong một dự án, rồi thêm đoạn cấu hình bên cạnh.
  2. Mở Customize ở thanh bên, tìm Ads Insights và bật công tắc.
  3. Khi Cursor yêu cầu đăng nhập Ads Insights, bấm để mở trang của hecigo trong trình duyệt.
{
  "mcpServers": {
    "ads-insights": {
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

VS Code

với trợ lý có hỗ trợ MCP
  1. Bấm Thêm vào VS Code ở mục Mở nhanh. Hoặc chạy MCP: Add Server trong Command Palette, chọn HTTP, dán địa chỉ connector và chọn Global hay Workspace. Cũng có thể thêm đoạn cấu hình bên cạnh vào .vscode/mcp.json.
  2. VS Code hỏi bạn có tin máy chủ này không trước khi chạy: xác nhận để khởi động Ads Insights. Lần đầu, VS Code mở trình duyệt để bạn đăng nhập hecigo.
  3. Trong khung Chat, bấm Configure Tools và bật các công cụ của Ads Insights.
{
  "servers": {
    "ads-insights": {
      "type": "http",
      "url": "https://ads.hecigo.com/mcp"
    }
  }
}

Claude Code

dòng lệnh
  1. Chạy lệnh bên cạnh trong terminal.
  2. Trong Claude Code, gõ /mcp và làm theo trình duyệt để đăng nhập. Hoặc chạy claude mcp login ads-insights.
claude mcp add --transport http ads-insights https://ads.hecigo.com/mcp

Trợ lý khác

hỗ trợ MCP
  1. Tìm mục thêm máy chủ MCP từ xa (remote MCP server, loại HTTP hoặc Streamable HTTP).
  2. Dán địa chỉ connector. Trợ lý phải hỗ trợ đăng nhập OAuth thì mới mở được trang đăng nhập của hecigo.
3

Đăng nhập và cho phép

Mọi công cụ của Ads Insights đều chỉ đọc, nên có thể cho trợ lý dùng mà không hỏi lại mỗi lầ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ý và kết nối lần nữa.

4

Nối tài khoản quảng cáo

Trợ lý chỉ đọ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ý đưa khi bạn hỏi mà chưa nối gì. Liên kết đó dùng được 15 phút.

Google Ads

Bấm Google Ads, chọn tài khoản Google có quyền xem tài khoản quảng cáo, rồi cấp quyền trên màn hình của Google. Google còn báo ứng dụng chưa xác minh: bấm Nâng cao, rồi Truy cập hecigo Ads Insights. Xong, trang kết quả có nút mở Claude, ChatGPT hoặc quay về portal.

Meta Ads

Đang chờ Meta duyệt quyền đọc quảng cáo cho hecigo. Cần dùng ngay thì nhắn hecigo để được nối giúp. Khi mở, bạn cấp quyền trên màn hình của chính Meta.

TikTok Ads

Đang chờ TikTok duyệt ứng dụng của hecigo. Khi mở, cách nối giống Google.

Portal hiện nền tảng nào đang được đọc, trợ lý nào đang kết nối, và có nút ngắt từng nền tảng, từng trợ lý. 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.

5

Kiểm tra kết nối

Hỏi trợ lý câu dưới. Trợ lý 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ì.

ads_health

Kiểm tra giúp tôi các nền tảng quảng cáo đã nối còn hoạt động không?

6

Câu hỏi theo việc

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ý tự kết hợp các công cụ, số liệu lấy thẳng từ nền tảng. Mọi câu đều chỉ đọc, không thay đổi gì trong tài khoản.

Báo cáo tuần cho chủ doanh nghiệpads_insights

Tóm tắt 7 ngày qua, bỏ hôm nay, so với 7 ngày trước đó: tổng chi, giá trị chuyển đổi, ROAS và chi phí mỗi chuyển đổi theo từng nền tảng. Nêu 3 chiến dịch kéo kết quả lên và 3 chiến dịch kéo xuống, kèm con số cho từng cái.

ROAS thực tế so với targetads_settings + ads_insights

Với từng chiến dịch Google đang chạy, đặt target ROAS hoặc target CPA đang cài cạnh ROAS và chi phí mỗi chuyển đổi thực tế 30 ngày qua. Chiến dịch nào lệch target quá 20%? Đừng đọc target từ tên chiến dịch.

Soát chuyển đổi đang được đếmads_settings

Liệt kê hành động chuyển đổi đang tính vào cột conversions và đang dùng để tối ưu giá thầu, kèm cửa sổ và mô hình ghi nhận. Có hành động nào kiểu xem trang hay mở app lần đầu đang làm phồng số chuyển đổi không?

Cắt tiền phí vào search termads_search_terms

30 ngày qua, search term nào tốn tiền mà không có chuyển đổi? Xếp theo chi phí, gom theo chủ đề, đề xuất danh sách từ khoá phủ định và đánh dấu term có tên đối thủ.

Soát Performance Maxads_asset_groups

Với từng asset group Performance Max: ad strength, ROAS 30 ngày, asset nào bị Google đánh giá LOW nên thay, và tín hiệu tệp, search theme có khớp sản phẩm đang bán không?

Kiểm tra nhắm mục tiêuads_settings

Chiến dịch nào có dấu hiệu nhắm sai: địa lý ngoài thị trường tôi bán, khớp vị trí theo quan tâm thay vì có mặt, thiếu loại trừ, hoặc chiến dịch Search đang bật Display Network?

Nội dung nào đáng tăng ngân sáchads_insights + ads_creatives

So các quảng cáo đang chạy 14 ngày qua theo chi phí mỗi chuyển đổi và ROAS. Với 3 quảng cáo tốt nhất và 3 kém nhất, đọc tiêu đề, nội dung, link đích và chỉ ra điểm khác nhau.

Chia lại ngân sáchads_insights + ads_entities

Dựa trên ROAS 30 ngày, ngân sách ngày hiện tại và impression share mất do ngân sách, chiến dịch nào nên tăng, giữ hay giảm ngân sách? Đề xuất con số cho từng chiến dịch và giải thích.

Vì sao chi tiêu tụtads_delivery + ads_entities

Hôm qua chi tiêu thấp hơn hẳn mọi ngày. Kiểm tra trạng thái tài khoản, trần chi tiêu, quảng cáo bị từ chối, chiến dịch không đủ điều kiện và ngân sách ngày, rồi nói nguyên nhân chính trước.

Đối chiếu với Ads Managerads_insights

Lấy chi tiêu, hiển thị, click và chuyển đổi tuần trước, từ Thứ Hai tới Chủ Nhật, theo từng chiến dịch và theo múi giờ của tài khoản, để tôi so với Ads Manager.

7

Đối chiếu số liệu

  • 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.
8

Xử lý lỗi thường gặp

Google báo ứng dụng chưa được xác minh

hecigo đang chờ Google xác minh quyền đọc Google Ads. Trong lúc đó màn hình của Google hiện cảnh báo này: bấm Nâng cao, rồi Truy cập hecigo Ads Insights để tiếp tục. hecigo vẫn chỉ đọc số liệu.

Nối Google Ads báo phải bật xác minh 2 bước

Từ 21/04/2026 Google bắt người cấp quyền Google Ads bật xác minh 2 bước, và một số tài khoản còn phải đăng nhập bằng passkey. Bật tại myaccount.google.com/security rồi bấm Nối ngay lần nữa. Kết nối đã có từ trước không bị ảnh hưởng.

Trợ lý báo không kết nối được

Gỡ connector rồi thêm lại. Trên trang của hecigo, xem tên workspace hiện ra có đúng không; sai thì bấm Dùng tài khoản Google khác.

Trợ lý nói chưa nối nền tảng nào

Trợ lý đang đọc một workspace chưa nối nền tảng. Mở portal xem tên workspace và mục Trợ lý đang kết nối, rồi bấm Nối ngay; hoặc dùng liên kết trợ lý đưa trong 15 phút.

Liên kết nối đã hết hạn

Liên kết từ trợ lý chỉ dùng được 15 phút. Hỏi lại trợ lý để lấy liên kết mới, hoặc mở portal và bấm Nối ngay.

Trợ lý không thấy công cụ hoặc tuỳ chọn mới

Trợ lý giữ danh sách công cụ từ lúc mở cuộc trò chuyện. Mở cuộc trò chuyện mới; vẫn chưa thấy thì tắt rồi bật lại connector trong cài đặt của trợ lý.

Trợ lý nói một nền tảng báo lỗi

Hỏi kiểm tra kết nối để xem lỗi cụ thể, rồi nối lại nền tảng đó trong portal.

Số lệch với Ads Manager

Xem mục đối chiếu ở trên. Thường do khác khoảng ngày, có tính hôm nay, hoặc đang so Clicks với link click.

Trợ lý không gọi Ads Insights

Bật connector trong cuộc trò chuyện, hoặc nói rõ “dùng Ads Insights” trong câu hỏi.

Không thấy chỗ thêm connector

Kiểm tra gói của trợ lý có hỗ trợ máy chủ MCP từ xa không, rồi xem trang trợ giúp chính thức của trợ lý đó.

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 · hi@hecigo.com