> For the complete documentation index, see [llms.txt](https://help-cdp.hub-js.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help-cdp.hub-js.com/nang-cao/cau-hinh-va-su-dung-custom-mcp.md).

# Cấu hình và sử dụng Custom MCP

## I. Cấu hình thông tin kết nối

Để thiết lập và lấy thông tin kết nối MCP Server, bạn thực hiện theo các bước chi tiết sau:

### Bước 1: Bật tính năng MCP Server trong Cấu hình hệ thống

1. Nhấp vào biểu tượng bánh răng Cài đặt ở góc trên bên trái màn hình, sau đó chọn Cấu hình hệ thống.

<img src="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FSY8OVhN6JnPcNBqtmmH5%2FGiao%20di%E1%BB%87n%20ch%E1%BB%8Dn%20C%E1%BA%A5u%20h%C3%ACnh%20h%E1%BB%87%20th%E1%BB%91ng?alt=media&amp;token=e68dc1df-b00f-4cb1-9f70-b822accabe11" alt="Giao diện chọn Cấu hình hệ thống" height="261" width="472">

2. Tại danh mục menu bên trái, tìm và chọn mục MCP (kết nối AI).
3. Chuyển trạng thái tùy chọn Bật MCP server sang Có.

Cấu hình các thông số hạn mức kết nối (như giới hạn request/mcp mỗi phút, thời hạn access token, timeout, v.v.) rồi nhấn nút Lưu hoặc Lưu & Đóng ở góc phải.

### Bước 2: Lấy URL kết nối và Tạo Personal Access Token

4. Nhấp vào biểu tượng Cài đặt → chọn menu Kết nối AI (MCP) → chọn sub-menu Token & kết nối.

<img src="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FmqjKbSU0Cw5MLzqh4DYg%2FMenu%20K%E1%BA%BFt%20n%E1%BB%91i%20AI%20(MCP)%20-%3E%20Token%20%26%20k%E1%BA%BFt%20n%E1%BB%91i?alt=media&amp;token=ad1db37e-884b-4ac8-96b7-7e3601671617" alt="Menu Kết nối AI (MCP) -> Token &#x26; kết nối" height="459" width="467">

5. Tại khu vực Cách kết nối, bạn sao chép đường dẫn trong ô Địa chỉ MCP server để dùng kết nối trên các ứng dụng AI (Claude.ai, Cursor, Antigravity,...).
6. Bảng Ứng dụng đã kết nối (OAuth) ở dưới sẽ hiển thị danh sách các tài khoản/ứng dụng đã hoàn tất xác thực và đang truy cập vào hệ thống.

<img src="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FiRjch9GPl9sNgCnHmcWT%2FGiao%20di%E1%BB%87n%20Token%20%26%20k%E1%BA%BFt%20n%E1%BB%91i?alt=media&amp;token=022854bd-46e3-41c4-8781-cfa6797936ae" alt="Giao diện Token &#x26; kết nối" height="275" width="602">

<br>

## II. Cấu hình MCP trên AI

### 1. Hướng dẫn sử dụng MCP custom (ví dụ: CDP MCP) với Claude

Bước 1: Thêm connector

7. Mở phần Settings → Connectors (tên menu có thể khác tùy phiên bản giao diện).
8. Chọn thêm custom connector.
9. Nhập tên và URL của MCP server (copy tại mục I), rồi lưu.
10. Nếu server yêu cầu đăng nhập, hoàn tất bước xác thực khi được chuyển hướng.

Bước 2: Bật connector cho cuộc chat

* Mở cuộc chat mới và kiểm tra connector đã được bật trong phần công cụ của khung chat.
* Lần đầu Claude gọi tool, bạn có thể được hỏi quyền truy cập. Hãy chấp nhận nếu bạn tin tưởng server.

Bước 3: Kiểm tra kết nối

Gõ thử một câu hỏi đơn giản:

* “Bạn đang kết nối với tài khoản nào?” (Claude sẽ gọi tool whoami)
* “Liệt kê những gì CDP MCP hỗ trợ.”
* “Cho mình xem danh mục stage, pipeline và trạng thái dùng để lọc.”

Nếu Claude trả về thông tin tài khoản, kết nối đã hoạt động.

Bước 4: Chat để lấy dữ liệu

Bạn chỉ cần viết bằng ngôn ngữ tự nhiên, Claude sẽ tự chọn tool phù hợp.

| Nhóm       | Ví dụ câu hỏi                                                                                         |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| Khách hàng | “Tìm khách có SĐT 09xxxxxxxx”                                                                         |
| Đơn hàng   | “Danh sách đơn hàng của khách này”, “Đơn hàng tháng 10 đang chờ xử lý”                                |
| Deal       | “Khách này đang ở giai đoạn deal nào?”, “Có bao nhiêu deal quá hạn?”, “Deal có giá trị trên 500k”     |
| Ticket     | “Khách có ticket mở không?”, “Tổng hợp ticket khiếu nại cần xử lý”, “Có bao nhiêu trạng thái ticket?” |

### 2. Hướng dẫn sử dụng MCP custom với Gemini

Bước 1: Thêm Custom MCP Server vào Gemini

1. Truy cập vào trang web[ Gemini](https://gemini.google.com/).
2. Mở mục Settings (Cài đặt) → Chọn Connected Apps (hoặc mục Personal Intelligence nếu có).
3. Tìm đến phần Custom Apps > Nhấp vào ô nhập URL hoặc chọn Add a custom app.
4. Dán URL endpoint của Custom MCP Server của bạn vào > Bấm Next và làm theo các hướng dẫn xác thực (nếu server yêu cầu đăng nhập OAuth).

Bước 2: Chat để lấy dữ liệu

Bạn chỉ cần viết bằng ngôn ngữ tự nhiên, Gemini sẽ tự chọn tool phù hợp.

### 3. Hướng Dẫn Kết Nối & Sử Dụng Custom MCP Trên Antigravity

Bước 1: Gửi thông tin MCP Server cho AI ngay trong Chat

Bạn chỉ cần gửi link URL endpoint vào ô chat

Ví dụ: Kết nối giúp tôi MCP: {endpoint MCP}

→ AI sẽ nhận yêu cầu và tự động cấu hình:

* Mở và ghi cấu hình chuẩn vào file mcp\_config.json nằm ở %USERPROFILE%\\.gemini\config\mcp\_config.json.\
  P/s: Nếu chưa có, AI sẽ tạo mới file và ghi cấu hình.
* Kiểm tra thử kết nối mạng và báo lại ngay nếu server yêu cầu Token xác thực hoặc OAuth.

Bước 2: Authentication

Vì MCP có cơ chế bảo mật, nên cần kiểm tra quyền của người dùng vào hệ thống CDP, người dùng cần thực hiện đăng nhập để authen, thao tác cụ thể như sau:

* Tại menu bên trái của Antigravity nhấn chọn Customizations, sau đó chọn Installed.
* Tìm đến mục MCP Servers → Chọn MCP mình vừa kết nối và nhấn Authenticate

<img src="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FNUDkN96wnMJUewMpsHWx%2Funknown.png?alt=media&amp;token=ffd42fa5-897f-4278-bcb1-07c8b8056e45" alt="" height="429" width="602">

* Đăng nhập tài khoản CDP của bạn để hoàn thành thao tác&#x20;

\
Bước 3: Cách sử dụng MCP sau khi kết nối

Bạn không cần viết code hay gọi API, chỉ cần ra lệnh bằng ngôn ngữ tự nhiên&#x20;

Chỉ cần chat như giao việc cho đồng nghiệp. AI sẽ tự hiểu ngữ cảnh và tự chọn tool phù hợp để thực thi.

* Ví dụ đã chạy thành công vừa rồi:
* Bạn hỏi: "Kiểm tra tài khoản đang đăng nhập"\
  👉 AI tự động gọi tool whoami ➔ Trả về thông tin user thaont.
* Bạn hỏi: "Có bao nhiêu deal có giá trị trên 500k?"\
  👉 AI tự động gọi tool get\_deals\_by\_value\_range ➔ Lọc ra số deal và thống kê cho bạn.

### 4. Mẹo để kết quả chính xác

* Cho thông tin định danh rõ ràng: SĐT, tên hoặc ID khách hàng.
* Nói rõ điều kiện lọc: khoảng ngày, nhân viên phụ trách, pipeline, trạng thái.
* Dùng đúng tên giá trị: nếu không chắc tên stage hay trạng thái, hãy hỏi AI xem danh mục trước.
* Yêu cầu xử lý tiếp: sau khi có dữ liệu, bạn có thể nhờ AI tóm tắt, so sánh hoặc trình bày thành bảng.

Những điều cần biết khi dùng

* Một SĐT có thể khớp nhiều hồ sơ. Khi đó AI sẽ hỏi bạn chọn hồ sơ nào, và bạn có thể chọn một hoặc cả hai để so sánh.
* Mỗi lần gọi trả tối đa 100 dòng. Với danh sách dài (ví dụ 549 deal quá hạn), AI sẽ báo tổng số và chỉ xem chi tiết từng trang khi cần.
* Chỉ đọc, không chỉnh sửa. Các tool này chỉ tra cứu dữ liệu. Việc gộp hồ sơ, đóng ticket hay đổi trạng thái phải làm trong CDP.
* Không phải câu hỏi nào cũng trả lời được. Ví dụ, không có tool đếm khách theo việc “có số điện thoại”, và không tìm được ticket chỉ bằng mã ticket.
* Kiểm tra chất lượng dữ liệu. Trường is\_complete của ticket không phản ánh đúng việc ticket đã đóng ở nhiều pipeline. Nên đối chiếu khi dùng số liệu cho báo cáo.

Xử lý sự cố

* AI không gọi tool: kiểm tra connector đã bật cho cuộc chat này chưa.
* Lỗi xác thực: kết nối lại connector và đăng nhập lại.
* Kết quả rỗng: thử bỏ bớt điều kiện lọc hoặc kiểm tra lại tên giá trị lọc.

<br>
