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 server（DEXUN AdWhiz、Notion、GitHub 等）的能力。
DEXUN AdWhiz MCP server 提供 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 server 共提供 5 个工具，全部只读。每个工具都有完整的 JSON Schema 描述，AI 会自动决定何时调用哪个。
list_ad_accounts
只读已连接的 Google Ads、Meta Ads、TikTok Ads 账户及其连接状态。
list_recommendations
只读AI 当前的优化推荐（加预算 / 减预算 / 暂停），附原因、预期影响和置信度。
get_savings_summary
只读节省汇总：指向 dashboard 上的节省数据，并附你的订阅档位。
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 server 仅在本地运行，dxk_ API key 不会上传到任何第三方
- 调用用你的 API key 鉴权，与 REST API 共用同一套按档位的速率限制（可用 get_quota 查看）
- 对广告系列的修改都由你自己完成，不经过 MCP
- 随时通过 dashboard「设置 → API Keys」吊销 MCP 访问权限