Hướng dẫn tích hợp MCP
Dùng Model Context Protocol để Claude, Cursor hoặc AI agent của riêng bạn tra cứu dữ liệu DEXUN AdWhiz: tài khoản quảng cáo đã kết nối trên cả ba nền tảng, đề xuất của AI và hoạt động gần đây. Chỉ đọc.
MCP là gì?
MCP (Model Context Protocol) là tiêu chuẩn mở do Anthropic ra mắt năm 2024, quy định cách các ứng dụng AI truy cập an toàn vào dữ liệu và công cụ bên ngoài. Hãy hình dung nó như "cổng USB-C cho AI" — một giao diện chung để mọi ứng dụng MCP (Claude Desktop, Cursor, agent của bạn) gọi được mọi máy chủ MCP (DEXUN AdWhiz, Notion, GitHub, v.v.).
Máy chủ MCP của DEXUN AdWhiz cung cấp 5 công cụ chỉ đọc: tài khoản quảng cáo đã kết nối, các đề xuất đang mở của AI, tóm tắt khoản tiết kiệm, hoạt động gần đây của tài khoản và hạn mức API của bạn. Máy chủ không thể thay đổi, tạm dừng hay tạo bất cứ thứ gì trong tài khoản quảng cáo của bạn. Mọi lệnh gọi đều được xác thực bằng API key của bạn và tính vào cùng giới hạn tần suất theo gói như REST API của chúng tôi.
Bắt đầu nhanh
Ba bước. Khoảng năm phút là bạn có thể hỏi trợ lý AI về tài khoản quảng cáo của mình.
Cấu hình Claude Desktop
Chỉnh sửa claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) và thêm:
# Claude Desktop config: ~/.../claude_desktop_config.json
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": {
"ADWHIZ_API_KEY": "dxk_live_..."
}
}
}
}Cấu hình Cursor
Qua .cursor/mcp.json ở cấp dự án hoặc cấu hình toàn cục:
# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": { "ADWHIZ_API_KEY": "dxk_live_..." }
}
}
}Kiểm tra
Khởi động lại Claude hoặc Cursor rồi thử prompt này. Nếu thấy AI gọi list_ad_accounts hoặc list_recommendations và trả về dữ liệu thật của bạn, bạn đã kết nối thành công.
Hỏi Claude:
“Liệt kê các tài khoản quảng cáo đã kết nối của tôi và tóm tắt các đề xuất đang mở của AI — nên thay đổi chiến dịch nào, và vì sao?”
Danh mục công cụ
Máy chủ MCP cung cấp 5 công cụ, tất cả đều chỉ đọc. Mỗi công cụ có JSON Schema đầy đủ, nên AI tự quyết định khi nào gọi công cụ nào.
list_ad_accounts
Chỉ đọcCác tài khoản Google Ads, Meta Ads và TikTok Ads đã kết nối cùng trạng thái kết nối.
list_recommendations
Chỉ đọcCác đề xuất tối ưu đang mở của AI (tăng ngân sách, giảm ngân sách, tạm dừng), kèm lý do, tác động dự kiến và mức độ tin cậy.
get_savings_summary
Chỉ đọcTóm tắt khoản tiết kiệm: dẫn tới các số liệu tiết kiệm trên bảng điều khiển, kèm gói của bạn.
get_recent_activity
Chỉ đọcHoạt động gần đây của tài khoản: đăng nhập, thay đổi API key, kết nối tài khoản quảng cáo và thay đổi gói đăng ký.
get_quota
Chỉ đọcGiới hạn API hiện tại: số yêu cầu mỗi phút, số còn lại và thời điểm đặt lại.
Ứng dụng AI của bạn liệt kê đúng các công cụ này, kèm tham số, qua yêu cầu MCP chuẩn tools/list.
Phiên ví dụ
Một cuộc trò chuyện mẫu (dữ liệu minh họa) cho thấy quyền truy cập chỉ đọc trông như thế nào:
Tôi đã kết nối những tài khoản quảng cáo nào với AdWhiz?
Bạn có ba tài khoản đã kết nối: Google Ads, Meta Ads và TikTok Ads, mỗi nền tảng một tài khoản. Cả ba đều đang ở trạng thái kết nối.
Hiện AI đang đề xuất gì?
Có 2 đề xuất đang mở: ① giảm ngân sách hằng ngày của chiến dịch Meta “Lookalike 1%” — ROAS của chiến dịch này thấp hơn mức trung bình của tài khoản suốt tuần qua; ② tăng ngân sách cho một chiến dịch TikTok Spark Ads. Mỗi đề xuất đều kèm lý do và mức độ tin cậy. Nếu muốn áp dụng, bạn hãy thực hiện trên nền tảng quảng cáo của mình — từ đây tôi không thể thay đổi gì.
Gần đây tài khoản của tôi có thay đổi gì không?
Trong 7 ngày qua: 2 lần đăng nhập, 1 API key mới và tài khoản TikTok Ads của bạn được kết nối lại. Không có ghi nhận nào khác.
Bảo mật & quyền truy cập
- Cả 5 công cụ đều chỉ đọc: AI có thể tra cứu dữ liệu nhưng không thể thay đổi ngân sách, tạm dừng quảng cáo hay tạo chiến dịch
- Máy chủ MCP chạy cục bộ — API key dxk_ của bạn không bao giờ rời máy để đến bên thứ ba
- Lệnh gọi được xác thực bằng API key của bạn và dùng chung giới hạn REST API theo gói (xem bằng get_quota)
- Mọi thay đổi với chiến dịch do bạn tự thực hiện, không qua MCP
- Thu hồi quyền truy cập MCP bất cứ lúc nào tại bảng điều khiển → Cài đặt → API Keys