活动层级——活动(目标、渠道、每日预算)→ 广告组(出价策略 + 出价/目标、受众)→ 广告/创意。
它为代理提供什么
一个专门为单个 MCP 连接设计的能力。
服务器拥有其领域逻辑,并发布 MCP 客户端可发现的工具契约。ADK-Rust 可将该契约加载到代理中,为所选模型提供者规范每个模式,并将连接生命周期保持在代理业务逻辑之外。
受众——兴趣/再营销/相似/自定义,含估计规模。
指标与 KPI——摄取每日展示/点击/花费/转化/收入;派生 CTR、CPC、CPA、CVR、ROAS,支持广告组及汇总活动层级。
预算节奏——今日花费与每日预算对比,带节奏标志(花费不足/正常/过热/预算耗尽)。
优化——基于规则的广告组建议:扩大高 ROAS 胜出组,削减/暂停低于盈亏平衡或无转化组,标记低 CTR,捕捉超目标 CPA。
架构
Ads MCP Server 在代理系统中的作用。
模型无需了解服务器背后系统的实现细节或凭证。它看到审核过的工具定义。MCP 客户端负责发现和调用,服务器保持验证、策略和与领域系统的通信所有权。
ADK-Rust 代理
从审核过的工具目录中选择能力。
MCP 客户端
发现模式,发送调用,并接收类型化内容。
Ads MCP Server
验证请求并拥有 19 个已记录工具契约。
领域系统
维护服务器背后的 API、数据、凭证和业务规则。
来自项目文档
服务器发布的架构
工具目录
代理可以请求 Ads MCP Server 做什么?
每个工具都有稳定名称、易读的用途和 MCP 初始化时发现的 JSON 输入契约。风险类别来自项目的注册清单(如果有)。
19 个命名工具
create_campaign创建活动(草稿)
internal writeget_campaign按 ID 获取活动
read onlylist_campaigns按状态/渠道列出活动
read onlyset_campaign_status设置活动状态(影响花费)——受门控
external writeset_budget设置活动每日预算——受门控(花费)
external writecreate_ad_group在活动下创建广告组
internal writeget_ad_group按 ID 获取广告组
read onlylist_ad_groups列出活动中的广告组
read onlyset_bid设置广告组出价/目标——受门控(花费)
external writecreate_ad创建广告/创意
internal writelist_ads列出广告组中的广告
read onlycreate_audience创建受众
internal write治理
了解每个工具的作用。
服务器连接继承其凭证和部署环境的权限。以下声明来自本项目的 README 和 MCP 注册清单;您的应用程序仍决定代理接收哪些工具以及何处需要批准。
- 三项写操作直接影响花费且受门控(requires_approval,external_write):set_budget、set_bid 和 set_campaign_status(暂停/激活活动影响花费)。
- optimize 为只读——仅推荐;应用建议需通过门控工具。预算和出价受非负保护;结束活动为终态。
- 所有重要内容均记录审计轨迹(audit_log)。示例数据为虚构。
MCP 接口
当前文档声明的内容。
MCP 可传输工具、资源、提示、结构化结果、进度、取消和长时间运行的工作。此记录突出显示本仓库明确提及的现代协议特性。
安装并连接
遵循项目文档中的起点。
在拥有凭证和领域访问权限的环境中安装服务器。将其添加到您的 MCP 主机,验证发现的工具,并在交付生产代理前缩小工具集。
cargo install mcp-adslet toolset = McpToolset::from_stdio(
"mcp-ads",
["mcp-ads"],
).await?;
let agent = LlmAgentBuilder::new("agent")
.tools(toolset.tools().await?)
.build()?;命令和配置从公开的 README 中提取。部署前请确认官方文档中的先决条件、环境变量和特定版本选项。
官方文档
继续使用项目维护者的权威信息源。
此页面提供服务器的易懂地图。仓库对确切的模式、先决条件、配置、示例、测试、版本和安全更新保持权威。
继续探索