# 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`

### 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.

### 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.

### 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.

```json
{
  "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.

```json
{
  "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**.

```bash
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

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 chỉ đọc 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ý 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ý được kết nối, tab này quay về trợ lý, 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.

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ì.

> 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ệp** (`ads_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 target** (`ads_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 đếm** (`ads_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 term** (`ads_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 Max** (`ads_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êu** (`ads_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ách** (`ads_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ách** (`ads_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ụt** (`ads_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 Manager** (`ads_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](https://zalo.me/3108963776852260798) · [hi@hecigo.com](mailto:hi@hecigo.com)