MCP 整合指南
透過 Model Context Protocol，讓 Claude、Cursor 或你的 AI 代理直接查詢 DEXUN AdWhiz 的資料——三平台已連結的廣告帳戶、AI 建議與近期動態。唯讀。
什麼是 MCP？
MCP（Model Context Protocol）是 Anthropic 於 2024 年推出的開放標準，定義 AI 應用如何安全地存取外部資料來源與工具。你可以把它想成「AI 時代的 USB-C」—— 一個統一介面，讓任何 MCP 用戶端（Claude Desktop、Cursor、自建代理）都能呼叫任何 MCP 伺服器（DEXUN AdWhiz、Notion、GitHub 等）的功能。
DEXUN AdWhiz MCP 伺服器提供 5 個唯讀工具：已連結的廣告帳戶、AI 目前的最佳化建議、節省金額摘要、帳戶近期動態，以及 API 配額。它無法修改、暫停或建立廣告帳戶中的任何內容。每次呼叫都以你的 API key 驗證，並與 REST API 共用同一套依方案分級的速率限制。
快速開始
三個步驟，大約 5 分鐘後就能向你的 AI 助理詢問廣告帳戶狀況。
在 Claude Desktop 中設定
編輯 claude_desktop_config.json（位置：macOS ~/Library/Application Support/Claude/，Windows %APPDATA%\Claude\），加入：
# Claude Desktop config: ~/.../claude_desktop_config.json
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": {
"ADWHIZ_API_KEY": "dxk_live_..."
}
}
}
}在 Cursor 中設定
透過專案層級的 .cursor/mcp.json 或全域設定：
# 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_..." }
}
}
}驗證連線
重新啟動 Claude 或 Cursor，然後試試這段提示詞。如果看到 AI 呼叫了 list_ad_accounts 或 list_recommendations 並回傳你的真實資料，就代表整合成功。
問 Claude：
「列出我連結的廣告帳戶，並整理 AI 目前的最佳化建議——建議調整哪些廣告活動？原因是什麼？」
工具清單
MCP 伺服器共提供 5 個工具，全部唯讀。每個工具都有完整的 JSON Schema 描述，AI 會自動判斷何時呼叫哪一個。
list_ad_accounts
唯讀已連結的 Google Ads、Meta Ads、TikTok Ads 帳戶及其連結狀態。
list_recommendations
唯讀AI 目前的最佳化建議（提高預算 / 降低預算 / 暫停），附上原因、預期影響與信心分數。
get_savings_summary
唯讀節省金額摘要：指向儀表板上的節省數據，並附上你的方案。
get_recent_activity
唯讀帳戶近期動態：登入、API key 變更、廣告帳戶連結與訂閱變更。
get_quota
唯讀目前的 API 速率限制：每分鐘可用請求數、剩餘次數與時段重設時間。
你的 AI 用戶端可透過標準的 MCP tools/list 請求，查看相同的工具清單與參數。
範例對話
一段範例對話（資料僅供示範），呈現唯讀存取的實際樣貌：
我在 AdWhiz 連結了哪些廣告帳戶？
你有 3 個已連結的帳戶：Google Ads、Meta Ads、TikTok Ads 各一個，狀態都正常。
AI 現在有什麼建議？
目前有 2 則待處理的建議：① 降低 Meta 廣告活動「Lookalike 1%」的每日預算——過去一週它的 ROAS 一直低於帳戶平均；② 提高一個 TikTok Spark Ads 廣告活動的預算。每則都附有原因與信心分數。若要執行，請在你的廣告平台中操作——我在這裡無法修改任何東西。
最近帳戶有什麼變動嗎？
過去 7 天：2 次登入、新增 1 個 API key，並重新連結了 TikTok Ads 帳戶。沒有其他紀錄。
安全與權限
- 5 個工具全部唯讀：AI 可以查看資料，但無法調整預算、暫停廣告或建立廣告活動
- MCP 伺服器僅在本機執行，dxk_ API key 不會上傳到任何第三方
- 呼叫以你的 API key 驗證，並與 REST API 共用依方案分級的速率限制（可用 get_quota 查看）
- 廣告活動的任何變更都由你自行完成，不經過 MCP
- 隨時可在儀表板「設定 → API Keys」撤銷 MCP 存取權限