キャンペーン階層 — キャンペーン(目的、チャネル、日次予算)→広告グループ(入札戦略+入札/ターゲット、オーディエンス)→広告/クリエイティブ。
Ads MCP Server
ADK-Rust Enterpriseの営業・マーケティングエージェント向けデジタル広告プラットフォーム。キャンペーン、広告グループ、広告/クリエイティブ、予算と入札、オーディエンス、日次パフォーマンス指標と派生KPIをカバーする19のMCPツール。
エージェントに何を提供するか
1つのMCP接続の背後にある目的特化型の機能です。
サーバーはドメインロジックを所有し、MCPクライアントが検出できるツール契約を公開します。ADK-Rustはその契約をエージェントに読み込み、選択したモデルプロバイダー向けに各スキーマを正規化し、接続のライフサイクルをエージェントのビジネスロジックの外に保持します。
オーディエンス — 興味・リマーケティング・類似・カスタム、推定サイズ付き。
指標&KPI — 日次インプレッション、クリック、支出、コンバージョン、収益を取り込み、広告グループおよび集計キャンペーンレベルでCTR、CPC、CPA、CVR、ROASを派生。
予算ペーシング — 今日の支出と日次予算の比較、ペーシングフラグ(支出不足/順調/過熱/予算枯渇)。
最適化 — 広告グループごとのルールベース提案:高ROAS勝者の拡大、損益分岐点以下またはゼロコンバージョングループの削減・一時停止、低CTRのフラグ付け、目標CPA超過のCPA検出。
アーキテクチャ
Ads MCP Serverがエージェントシステムにどのように適合するか。
モデルはサーバー背後のシステムの実装詳細や認証情報を必要としません。レビュー済みのツール定義を見ます。MCPクライアントが検出と呼び出しを処理し、サーバーは検証、ポリシー、ドメインシステムとの通信を所有します。
ADK-Rustエージェント
レビュー済みのツールカタログから機能を選択します。
MCPクライアント
スキーマを検出し、呼び出しを送信し、型付きコンテンツを受信します。
Ads MCP Server
リクエストを検証し、19の文書化されたツール契約を所有します。
ドメインシステム
API、データ、認証情報、ビジネスルールをサーバーの背後に保持します。
プロジェクトのドキュメントから
サーバーが公開するアーキテクチャ
ツールカタログ
エージェントはAds MCP Serverに何を依頼できますか?
各ツールには安定した名前、人間が理解できる目的、MCP初期化時に検出されるJSON入力契約があります。リスククラスはプロジェクトのレジストリマニフェストから取得されます(利用可能な場合)。
19の名前付きツール
create_campaignキャンペーン(ドラフト)を作成
internal writeget_campaignIDでキャンペーンを取得
read onlylist_campaignsステータス/チャネル別にキャンペーンを一覧表示
read onlyset_campaign_statusキャンペーンステータスを設定(支出に影響)— ゲート付き
external writeset_budgetキャンペーンの日次予算を設定 — ゲート付き(支出)
external writecreate_ad_groupキャンペーン下に広告グループを作成
internal writeget_ad_groupIDで広告グループを取得
read onlylist_ad_groupsキャンペーン内の広告グループを一覧表示
read onlyset_bid広告グループの入札/ターゲットを設定 — ゲート付き(支出)
external writecreate_ad広告/クリエイティブを作成
internal writelist_ads広告グループ内の広告を一覧表示
read onlycreate_audienceオーディエンスを作成
internal writeガバナンス
すべてのツールの効果を理解する。
サーバー接続は、その認証情報と展開環境の権限を継承します。以下の宣言はこのプロジェクトのREADMEとMCPレジストリマニフェストからのもので、アプリケーションはエージェントが受け取るツールや承認が必要な箇所を決定します。
- 支出に直接影響する3つの書き込みはゲート付き(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から抽出されます。展開前に公式ドキュメントで前提条件、環境変数、リリース固有のオプションを確認してください。
公式ドキュメント
プロジェクトメンテナの信頼できる情報源を続けてください。
このページはサーバーのわかりやすいマップを提供します。正確なスキーマ、前提条件、設定、例、テスト、リリース、セキュリティ更新についてはリポジトリが権威を保持します。
探索を続ける
業務オペレーションでさらに詳しく。
ソースレコード
このカタログエントリのリリースとリポジトリのメタデータ。
- バージョン
- 1.0.0
- ライセンス
- Apache-2.0
- ツール
- 19
- リビジョン
- dc3ea76c6b46
- 更新済み
- 2026年6月9日