1. HilltopAds MCPとは？何ができるのか | 広告ネットワーク HilltopAds

HilltopAds MCPとは？

MCPサーバー（Model Context Protocol） は、AIクライアント向けの HilltopAds公式コネクター です。一度接続すれば、AIはあなたのアカウントデータを読み取り、承認を得たうえで、キャンペーンの作成や更新などの操作を、安全かつ専用の通信チャネルを通じて実行できます。データを手動でコピー＆ペーストする必要はありません。

ログインIDやパスワードがAIクライアントに共有されることはありません。接続は、アカウント内で生成するAPIキーによって認証されます。

このコネクターは、一連の**ツール（操作）**を通じて、あなたの HilltopAds アカウントにアクセスします。AIはリクエストに応じて適切なツールを選択し、その結果を表、要約、あるいはグラフなどの分かりやすい形式で表示します。

何ができますか？

利用できるツールは、次の2種類に分かれています。

読み取り操作（Read Operations）：残高、広告インベントリ、統計情報、個別キャンペーンの詳細、キャンペーンのソースリストなどのデータを取得します。

実行操作（Action Operations）：キャンペーンの作成・更新、開始・停止、入札価格（Bid）やリンク先URLの変更、ソースのブラックリスト・ホワイトリストの管理など、アカウントに変更を加えます。

利用できるツールは、アカウントの種類（Advertiser、Publisher、またはその両方）によって異なります。現在、このコネクターでは27種類の操作が利用でき、その内訳はAdvertiser向け23種類、Publisher向け4種類です。

実行操作（Action Operations） は、必ずあなたの承認後に実行されます。AIクライアントでは、各ツールが読み取り専用または書き込み／削除のいずれかとして表示され、変更を実行する前に確認が求められます。

アカウント・レポート用ツール

ツール	説明
`advertiser_get_balance`	Advertiserアカウントの現在の残高を表示します。
`advertiser_list_inventory`	キャンペーンとその広告を一覧表示します。
`advertiser_get_stats`	日付、ゾーン、GEO、キャンペーン、OS、時間帯、トラフィックソースごとにフィルタまたはグループ化した統計情報を取得します。
`advertiser_get_campaign`	キャンペーンIDを指定して、キャンペーンの詳細情報を表示します。

キャンペーン管理ツール

注: このガイドの例では、アシスタントは各キャンペーンを**非アクティブ（Inactive）**の状態で作成します。これは、配信開始前に内容を確認できるようにするためのデフォルト設定であり、必須ルールではありません。キャンペーンを非アクティブで作成したい場合や、すぐに配信を開始したい場合は、その旨をリクエストで明示してください。

ツール	説明
`advertiser_create_campaign`	新しいキャンペーンを作成します。
`advertiser_update_campaign`	キャンペーン設定を部分的に更新します。
`advertiser_start_campaign`	承認済みのキャンペーンを開始します。
`advertiser_stop_campaign`	配信中のキャンペーンを停止します。
`advertiser_archive_campaign`	キャンペーンをアーカイブへ移動します。
`advertiser_unarchive_campaign`	アーカイブからキャンペーンを復元します。
`advertiser_set_bid`	ワイルドカードGEOの入札価格（Bid）を変更します。
`advertiser_set_destination_url`	Popunderキャンペーンのリンク先URLを変更します。
`advertiser_replace_domain`	Advertiserアカウント内のすべての広告でドメインを置き換えます。

ソースブラックリスト管理ツール

ツール	説明
`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モードに切り替えます。