1. 什么是 HilltopAds MCP？它可以帮您做什么？

什么是 HilltopAds MCP？

MCP Server（Model Context Protocol） 是 HilltopAds 官方推出的 AI 客户端连接器。完成连接后，AI 可以读取您的账户数据，并在获得您的授权后，通过安全的专用通道执行操作，例如创建或更新广告活动，而无需您手动复制粘贴数据。

您的登录名和密码绝不会与 AI 客户端共享。连接通过您在账户中生成的 API Key（API 密钥） 进行授权。

该连接器通过一系列 工具（Tools） 将您的 HilltopAds 账户开放给 AI 使用。AI 会根据您的请求自动选择合适的工具，执行操作，并将结果整理成易于阅读的形式，例如表格、摘要，甚至图表。

这些工具分为两类：

读取操作（Read Operations）： 获取账户余额、广告资源（Inventory）、统计数据、单个广告活动详情，以及广告活动的流量来源列表等信息。

执行操作（Action Operations）： 对您的账户进行修改，例如创建或更新广告活动、启动或停止广告活动、调整出价（Bid）、修改目标 URL，以及管理流量来源黑名单和白名单。

您可使用的工具取决于您的账户类型：Advertiser（广告主）、Publisher（发布者），或同时拥有两种身份。目前，该连接器共支持 27 项操作，其中 23 项适用于广告主，4 项适用于发布者。

所有 执行操作（Action Operations） 都必须经过您的确认后才会执行。AI 客户端会明确标识工具属于只读还是写入/删除操作，并在执行任何修改之前请求您的确认。

工具	功能
`advertiser_get_balance`	查看广告主账户当前余额。
`advertiser_list_inventory`	查看您的广告活动及其广告素材。
`advertiser_get_stats`	按日期、广告位（Zone）、GEO、广告活动、操作系统、小时或流量来源筛选或分组查看统计数据。
`advertiser_get_campaign`	根据 Campaign ID 查看单个广告活动的完整详情。

注意： 在本指南后续示例中，AI 助手默认会将新建的广告活动设置为 Inactive（未启用） 状态，以便您在开始消耗预算前进行检查。这只是助手选择的默认设置，并非固定规则。如果您希望广告活动创建后保持未启用状态，或立即启动，请在您的请求中明确说明。

工具	功能
`advertiser_create_campaign`	创建新的广告活动。
`advertiser_update_campaign`	部分更新广告活动设置。
`advertiser_start_campaign`	启动已获批准的广告活动。
`advertiser_stop_campaign`	停止正在运行的广告活动。
`advertiser_archive_campaign`	将广告活动移至归档。
`advertiser_unarchive_campaign`	从归档中恢复广告活动。
`advertiser_set_bid`	修改 Wildcard GEO 的出价（Bid）。
`advertiser_set_destination_url`	修改 Popunder 广告活动的目标 URL。
`advertiser_replace_domain`	替换广告主账户中所有广告使用的域名。

工具	功能
`advertiser_get_blacklist`	查看广告活动的流量来源黑名单。
`advertiser_add_to_blacklist`	向黑名单中添加流量来源。
`advertiser_remove_from_blacklist`	从黑名单中移除流量来源。
`advertiser_clear_campaign_blacklist`	清空广告活动的黑名单。
`advertiser_set_blacklist`	替换整个黑名单，并将广告活动切换为 BLACKLIST 模式。

工具	功能
`advertiser_get_whitelist`	查看广告活动的流量来源白名单。
`advertiser_add_to_whitelist`	向白名单中添加流量来源。
`advertiser_remove_from_whitelist`	从白名单中移除流量来源。
`advertiser_clear_campaign_whitelist`	清空广告活动的白名单。
`advertiser_set_whitelist`	替换整个白名单，并将广告活动切换为 WHITELIST 模式。