Agency AI MCP

---

📋 目次

• 概要
• できること
• ツールのリファレンス
• 広告管理と自動操縦
• プラットフォーム
• 要件
• クイックスタート
• プロンプトの例
• FAQ
• リンク

---

🎯 概要

Agency AI MCP は、Claude と ChatGPT を Meta（Facebook、Instagram）および Google の広告アカウントを担当する CMO に変えます。やることリストではなく、「ブレンド ROAS を 3 以上に保ち、成果の出ているものを拡大する」といった目標を伝えるだけで、チャットを離れることなく、分析、開始、最適化、レポート作成を行います。

✨ パフォーマンス分析 – キャンペーンデータ、内訳、NCROAS、高度な KPI 🎯 戦略 – 予算に関するガイダンス、クリエイティブの提案、拡大計画 ⚡ 広告の作成と編集 – コンバージョンに最適化された広告の作成、予算の更新、キャンペーンの一時停止や開始 🤖 自動操縦 – Claude と ChatGPT のスケジュールタスクを使って、広告管理を定期的に実行 ⏱️ 高速で効率的 – 広告プラットフォームに直接接続する MCP よりも、トークン消費を抑えながら高速に応答

---

🎨 できること

📊 アナリスト

Meta と Google のキャンペーンデータ、パフォーマンスの内訳、NCROAS、高度な KPI を取得できます。成果が出ているものと、そうでないものを把握できます。

💡 Example: "Compare my top 5 campaigns by ROAS last month"

🎯 ストラテジスト

予算に関するガイダンス、クリエイティブの提案、拡大計画、チャネルを横断したキャンペーン計画の戦略を得られます。

💡 Example: "Which campaigns should I scale and why?"

⚡ 広告マネージャー

チャットを離れることなく、Meta と Google で新しい広告を作成し、成果の出ていない広告を一時停止し、予算を調整して、キャンペーンを数秒で開始できます。スケジュールを設定すれば、アカウントを自動で管理できます。

💡 Example: "Pause all campaigns with ROAS below 2:1"

---

🧰 ツールのリファレンス

ツールは 15 個あり、分析用の読み取りツールが 10 個、広告管理用の書き込みツールが 5 個です。

📖 読み取りツール

ツール	返される内容
get_brand_info	ブランドのプロフィールと経済性。店舗の商品、対象顧客、損益分岐 ROAS を確認できます
get_campaigns	Meta と Google のキャンペーン。費用、売上、ROAS、インプレッション数、クリック数、コンバージョン数、目的を確認できます
get_adsets	Meta の広告セット（1 日あたりの予算とパフォーマンスを含む）、または Google のアセットグループ
get_ads	指定した期間のパフォーマンスを含む Meta 広告。費用順に表示されます。また、create_ad のソース広告を選ぶためにも使用されます
get_ad_creative	Meta 広告 1 件のクリエイティブ。種類、メインテキスト、見出し、説明、CTA、ランディングページ、メディア URL を確認できます
get_performance_timeseries	接続されたプラットフォームごとの日別の費用、売上、ROAS。プラットフォームごとに 1 日 1 行で、それぞれに data_status（complete、partial、not_synced、error）と、プラットフォームごとの last_synced_at が含まれます。期間は最大 366 日です
get_pacing	プラットフォームごとの月初から現在までの費用と、設定した月間予算の比較。費用を取得できなかったプラットフォームは available: false とマークされ、費用額は表示されません。spendComplete: false は、その合計から当該プラットフォームが除外されていることを示します
get_anomalies	直近 30 日間で統計的に異常な費用／ROAS の日
get_recommendations	理由と信頼度を含む、AI による最適化の推奨事項
get_operation_status	キューに追加された広告作成の進行状況、結果、またはエラー

✍️ 広告管理ツール（書き込み）

ツール	変更内容
create_ad	新しい Meta キャンペーン、広告セット、または広告を作成します。コンバージョンに最適化された新しいクリエイティブ、または既存広告のクリエイティブを使用します
update_campaign	Meta と Google のキャンペーン名、1 日あたりの予算、ステータスのいずれか、または複数を変更します
update_adset	Meta の広告セット名、1 日あたりの予算、ステータスのいずれか、または複数を変更します。Google のアセットグループでは、名前またはステータスを変更します
update_ad	Meta 広告名またはステータスを変更します
set_campaign_status	1 回の呼び出しで、両プラットフォームにまたがる最大 25 件のキャンペーンを開始または一時停止します

---

⚡ 広告管理と自動操縦（書き込みツール）

5 つの書き込みツールを使うと、Claude または ChatGPT が広告を作成し、キャンペーンを編集して、広告アカウントを直接操作できます。あなたの承認なしに処理が実行されることはありません。アシスタントは実行前に、書き込み操作のたびにあなたの確認を求めます。詳しくは、以下の「ガードレール」をご覧ください。

🛠️ 各書き込みツールの機能

create_ad – 新しい Meta キャンペーン、広告セット、または広告を作成します。クリエイティブは、Agency AI が生成する新しいコンバージョン最適化済みのクリエイティブとコピー、または指定した既存広告（そのクリエイティブを再利用）のいずれかを使用します。作成する構成の範囲は placement で決まります。

placement	作成される内容
new-campaign	キャンペーン + 広告セット + 広告（1 日あたりの予算が必要です）
new-adset	既存キャンペーン内の広告セット + 広告
existing-adset	既存広告セット内の広告のみ

作成処理はバックグラウンドで実行され、operation_id が返されます。アシスタントに状況を確認するよう依頼すると、get_operation_status が呼び出されます。ソースの広告セットのスケジュールは引き継がれません。将来の日付を指定しない限り、新しい広告セットには終了日が設定されません。

update_campaign – Meta または Google のキャンペーン名を変更し、1 日あたりの予算を変更し、開始または一時停止します。各フィールドの結果は個別に報告されるため、「名前は変更されたが、予算は拒否された」という部分的な結果も、全面的な失敗として扱わず、そのまま返されます。

update_adset – Meta の広告セットについて、同じ 3 つのフィールドを変更します。Google のアセットグループで変更できるのは名前とステータスのみです。予算はキャンペーンに設定されています。

update_ad – Meta 広告の名前を変更するか、開始または一時停止します。Meta のみが対象です。Google Performance Max には個別の広告レベルがありません。

set_campaign_status – Meta と Google が混在する最大 25 件のキャンペーンを、1 回の呼び出しでまとめて開始または一時停止します。各キャンペーンは個別に成功または失敗し、結果にはすべての処理結果が一覧表示されるため、無効な ID があってもほかの処理が妨げられることはありません。

🤖 自動運転

書き込みツールを Claude と ChatGPT に組み込まれているスケジュールタスクと組み合わせれば、定期的な広告管理を自動化できます。ルールを平易な英語で一度設定するだけで、アシスタントがスケジュールに沿って実行します。

• 毎日午前9時にチェックし、損益分岐点を下回る ROAS の広告を一時停止する
• 毎週月曜日に、先週成果を上げた広告へ予算を再配分する
• 毎日異常をスキャンし、支出が膨らむ前に通常と異なる支出を通知する

🛡️ ガードレール

• 🔐 お客様のアカウントのみ – アカウントは検証済みの接続情報から特定され、アシスタントから渡された情報は使用されません。接続済みの Meta または Google アカウントに属さない ID は、書き込みが行われる前に拒否されます。
• ✅ 事前に確認 – 書き込みツールは Claude と ChatGPT に破壊的操作として宣言されます（readOnlyHint: false、destructiveHint: true）。そのため、アシスタントは実行前に確認を求め、クライアント側でも承認プロンプトを表示できます。サーバーも、書き込みの前にユーザーへ確認するようモデルに指示します。
• 💰 予算の上限 – Meta の1日あたりの予算は、チャットでもダッシュボードと同様に1～5,000ドル／日に制限されます。
• 📋 ダッシュボードと同じパイプライン – 書き込みは Agency AI ダッシュボードで使用されるものと同じサービスと所有権チェックを通じて処理され、すべての変更がアクティビティログに記録されます。
• 📊 利用状況を記録 – すべてのツール呼び出しがアカウントに記録されるため（ツール、所要時間、応答サイズ、エラー）、アシスタントの操作を監査できます。
• ↩️ 元に戻せます – 一時停止したものは、同じ方法で再度有効化できます。キューに追加された広告の作成は get_operation_status で確認できます。考えが変わった場合は、作成された広告を一時停止してください。

---

🛒 プラットフォーム

Agency AI MCP はあらゆる E コマースプラットフォームやウェブサイトで利用できます。Meta と Google の広告アカウントを接続すれば、上記の機能をすべて使用できます。

Shopify をお使いですか？ Agency AI Shopify アプリを使うと、広告費に照らし合わせたストアの売上、NCROAS、高度な KPI など、より詳細なデータを利用でき、最も正確な分析と自動化が可能になります。Shopify ストアにはこのアプリをおすすめします。

Shopify をお使いでない場合は、agencyai.app/mcpで Agency AI アカウントを作成し、Meta と Google の広告アカウントを直接接続してください。

---

✅ 要件

• ✔️ Agency AI アカウント – Shopify アプリをインストールするか、任意のプラットフォームでアカウントを作成してください
• ✔️ カスタムコネクターに対応したClaude（無料プランを含む）またはChatGPTのプラン
• ✔️ Agency AI に接続済みの広告アカウントが少なくとも1つあること（Meta および／または Google）

---

🚀 クイックスタート

エンドポイント URL

https://s.agencyai.app/mcp

ChatGPT ではこの URL が必要です。Claude はコネクターディレクトリで Agency AI を見つけます。

📱 Claude の設定

1. Claude（claude.ai）を開きます
2. プロフィールをクリックし、Settings → Connectors を選択します
3. Browse connectors をクリックし、Agency AI を検索します
4. Connect をクリックします
5. 求められたら、Agency AI アカウントでサインインします
6. ✅ 完了です。Claude に広告について質問してみましょう

見つからない場合は、Add custom connector をクリックして https://s.agencyai.app/mcp を貼り付けてください。

💬 ChatGPT の設定

1. ChatGPT（chatgpt.com）を開きます
2. プロフィールをクリックし、Settings → Connectors を選択します
3. Add connector をクリックします
4. 次を貼り付けます：https://s.agencyai.app/mcp
5. 求められたら、Agency AI アカウントでサインインします
6. ✅ 完了です。ChatGPT に広告について質問してみましょう

📖 詳しい手順が必要ですか？ 詳細な手順については、llms-install.mdをご覧ください。

---

💬 プロンプトの例

接続済みの Claude または ChatGPT で、次の質問を試してみてください。

📊 Analysis
"How did my Meta campaigns perform last 30 days vs prior 30?"
"Show me my top 10 best-performing ads by ROAS"
"Which campaigns are underperforming and why?"

🎯 Strategy
"Which ads should I iterate on and which should I cut?"
"Where should I shift budget this week?"
"Give me creative recommendations for my top 5 performers"

⚡ Ad Management
"Pause all campaigns with ROAS below 2:1"
"Create a new ad for our bestseller and launch it in a new campaign at $50/day"
"Raise Spring Drop's daily budget to $150"
"Every weekday at 9am, check my account and pause anything below breakeven"

---

❓ よくある質問

Agency AI MCP とは何ですか？ Meta と Google の広告アカウントを Claude と ChatGPT に接続する MCP サーバーです。パフォーマンス分析、予算の最適化、クリエイティブの提案、スケーリング戦略を担い、さらに広告の作成、キャンペーンの編集、アカウントの自動運用まで、すべてチャットで実行できます。

Shopify は必要ですか？ いいえ。Agency AI MCP は、あらゆる E コマースプラットフォームやウェブサイトで利用できます。Shopify ストアでは Agency AI Shopify アプリを通じて、より詳細なデータレイヤーと精度の高い自動化を利用できるため、Shopify をお使いの場合はこのアプリをおすすめします。

Claude や ChatGPT は、実際に広告を作成・編集できますか？ はい。アシスタントは、コンバージョンに最適化された新しい広告の作成、予算や名前の変更、Meta と Google のキャンペーン、広告セット、広告の一時停止や配信開始を実行できます。

承認なしに変更されることはありますか？ いいえ。書き込みツールは破壊的操作として宣言されているため、アシスタントは操作を実行する前に確認します。変更には予算上限が設定され、所有権が確認され、すべての操作がアクティビティログに記録されます。

Meta または Google の MCP に直接接続する場合と何が違いますか？ 1 つのコネクターで両方のプラットフォームに対応し、事前計算済みの KPI、戦略レイヤー、広告作成機能を備えています。広告プラットフォームに直接接続する MCP と比べて、トークン消費量を抑えながら、より速く応答します。

料金はいくらですか？ MCP の利用は Agency AI のプランに含まれています。利用を開始するには、agencyai.app/mcp でアカウントを作成してください。

---

🔗 リンク

リンク	目的
🌐 ウェブサイト	Agency AI の詳細を見る
🚀 利用を開始	アカウントを作成して接続する
🛍️ Shopify アプリ	Shopify App Store からインストールする
📧 サポート	サポートを受ける、またはフィードバックを送る

📄 ライセンス

このプロジェクトは Apache License 2.0 のライセンスに基づいています。詳細は LICENSE ファイルをご覧ください。