文档

在 www.adwhiz.ai/pricing 创建账户并选择方案。所有方案包含所有工具——区别在于 API 调用量和可连接的 Google Ads 账户数量。

前往 www.adwhiz.ai/connect，通过 Google OAuth 授权您的 Google Ads 账户。AdWhiz 仅通过官方 Google Ads API 请求读写权限。您可以随时从 Google 账户设置中撤销访问。

AdWhiz 支持任何兼容 MCP 协议的工具——Claude Code、Cursor、Windsurf、OpenClaw、Copilot、Gemini CLI 等。提供两种认证方式：

Add the AdWhiz Google Ads MCP server to my project.
Server URL: https://mcp.adwhiz.ai/mcp
Type: streamable-http

{
  "mcpServers": {
    "adwhiz": {
      "type": "streamable-http",
      "url": "https://mcp.adwhiz.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "type": "streamable-http",
      "url": "https://mcp.adwhiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

如果您更喜欢手动设置，请直接将 AdWhiz MCP 服务器添加到 openclaw.json。提供两种传输选项：

{
  "mcpServers": {
    "adwhiz": {
      "transport": "http",
      "url": "https://mcp.adwhiz.ai/mcp"
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "transport": "http",
      "url": "https://mcp.adwhiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "adwhiz": {
      "command": "npx",
      "args": ["-y", "@adwhiz/mcp-server"],
      "env": {
        "ADWHIZ_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

如果您是 OpenClaw 代理，正在阅读此页面以自行安装 AdWhiz，请按以下步骤操作：

1. 1使用 HTTP + OAuth 传输（选项 A）——只需添加服务器 URL。无需 API 密钥，首次使用时会打开浏览器授权页面。
2. 2如果用户的 MCP 客户端不支持 OAuth，请回退到 HTTP + API 密钥（选项 B）。用户可在 https://www.adwhiz.ai/dashboard 创建 API 密钥。
3. 3如果 Node.js 可用且用户偏好本地执行，请使用 stdio 传输（选项 C）配合 API 密钥。
4. 4使用上方的配置代码片段，将相应的 mcpServers 条目添加到用户的 `openclaw.json` 配置文件中。
5. 5通过调用 `list_accounts` 工具验证连接——它应返回用户的 Google Ads 账户。
6. 6如果用户尚未完成 Google Ads OAuth，请引导他们访问 https://www.adwhiz.ai/connect 进行授权。

# Agent self-install summary:
# 1. Prefer HTTP + OAuth (no API key needed)
# 2. Fallback: HTTP + API key, or stdio + API key (needs Node.js)
# 3. Write mcpServers config to openclaw.json
# 4. Test with list_accounts tool
# 5. If Google Ads not connected → direct user to adwhiz.ai/connect
#
# Skill manifest: openclaw/skills/adwhiz/SKILL.md
# MCP endpoint: https://mcp.adwhiz.ai/mcp
# Auth: OAuth (auto) or Bearer API key
# npm package: @adwhiz/mcp-server (stdio only)

客户 ID

每个工具都需要 customer_id 参数——一个 10 位数字，无连字符（例如 9044845197）。如果不确定，请使用 list_accounts 工具查找。

微单位（货币）

Google Ads API 以微单位存储货币值：1,000,000 微单位 = $1.00。AdWhiz 在所有响应中自动将微单位转换为美元，您无需手动计算。

安全默认设置

新广告系列和新广告始终以暂停状态创建。您必须显式调用 set_campaign_status 或 set_ad_status，设置 status: ENABLED 后才能投放。

操作日志

每次修改（创建、更新、暂停、删除）都在服务端记录。随时在 AI 工具中使用 get_operation_log 查看通过 AdWhiz 进行的近期更改。

日期范围

效果工具接受 GAQL 日期预设字符串。常用预设：

AI 工具看不到 AdWhiz 工具

检查 MCP 配置文件（如 .mcp.json）是否在正确位置且 JSON 格式有效。确认控制面板中的 API 密钥正确。更改配置后请完全重启 AI 工具。

出现「订阅未激活」错误

您的订阅可能已过期或扣款失败。登录 www.adwhiz.ai/dashboard 检查订阅状态，或联系 support@adwhiz.ai。

出现「月度限额已用完」错误

您已用完当前计费周期的 API 调用配额。从控制面板升级方案，或等待下一个计费周期重置配额。

如何添加另一个 Google Ads 账户？

前往 www.adwhiz.ai/connect 再次完成 Google OAuth 流程。每次授权可访问一个 Google Ads 账户（或 MCC）。为每个要管理的账户重复此操作。

我的数据安全吗？

是的。AdWhiz 使用 AES-256-GCM 加密存储刷新令牌，通过官方 OAuth2 认证的 Google Ads API v23 与 Google 通信，且不长期存储原始广告数据。您可以随时从 Google 账户设置中撤销访问权限。