Meta Ads MCP

Meta Ads MCP

AI アシスタント（Claude、ChatGPT、Perplexity、Cursor、または任意の MCP クライアント）が、自然な会話を通じて Facebook、Instagram、その他すべての Meta 広告面で、キャンペーンの開始、クリエイティブのアップロード、予算の更新、パフォーマンスの分析など、Meta Ads のすべてを一貫して実行できる Model Context Protocol（MCP） サーバーです。ホスト型リモート MCP として利用でき、開発者トークンもセルフホストも不要です。

これは Pipeboard MCP ファミリーの Meta Ads ノードです。5 つのリモート MCP サーバー（Meta、Google、TikTok、Snap、Reddit）と統合型の Pipeboard CLI で構成され、合計 230 以上のツールを利用でき、認証と安全性のモデルは共通です。単一プラットフォームの MCP を比較している場合、これはネットワークの 1 ノードです。以下の「Pipeboard MCP ファミリー」をご覧ください。

注： これは、Meta の公開 API を使用する独立したオープンソースプロジェクトです。その背後にあるホスト型サービス Pipeboard は、Meta Business Partner のバッジを取得した公式承認済み Meta アプリです。1 つのログインで Meta、Google、TikTok、Snap、Reddit Ads を管理でき（無料プランあり）、Meta 専用ではなく、セルフホストも不要です。Meta、Facebook、Instagram、およびその他の Meta ブランド名は、それぞれの所有者の商標です。

mcp-name: co.pipeboard/meta-ads-mcp

コミュニティとサポート

• Discord。コミュニティに参加しましょう。
• メールサポート。サポートが必要な場合は、メールでお問い合わせください。

目次

• Pipeboard MCP ファミリー
• 🚀 リモート MCP を始める（マーケターにおすすめ）
• Pipeboard CLI（MCP の代替手段）
• ローカルインストール（技術ユーザー向け）
• 機能
• 設定
• 利用可能な MCP ツール
• ライセンス
• プライバシーとセキュリティ
• テスト
• トラブルシューティング

Pipeboard MCP ファミリー

Pipeboard は、主要な広告プラットフォームごとにリモート MCP サーバーを提供し、さらに、それらすべてをまとめた単一バイナリの CLI も提供しています。5 つのサーバーはすべて、同じ OAuth、同じ tools/list による検出、同じ書き込み確認の安全性モデル、同じ Pipeboard API トークンを共有します。そのため、1 つのサーバーを習得したエージェントは、ほかのサーバーも扱えるようになります。

リモート MCP サーバー

プラットフォーム	リモート MCP URL	概要
Meta Ads MCP（Facebook + Instagram）	https://meta-ads.mcp.pipeboard.co/	42 個のツール — キャンペーン、広告セット、広告、クリエイティブ（ダイナミッククリエイティブのテストを含む）、画像のアップロード、インサイト、興味・行動・属性・地域によるターゲティング、ページ管理
Google Ads MCP	https://google-ads.mcp.pipeboard.co/	59 個のツール — キャンペーン、広告グループ、レスポンシブ検索広告、Performance Max、キーワード、GAQL クエリ、拡張機能（サイトリンク、コールアウト、構造化スニペット）、オーディエンス、アセットのアップロード、汎用の変更
TikTok Ads MCP	https://tiktok-ads.mcp.pipeboard.co/	59 個のツール — キャンペーン、広告グループ、広告、アイデンティティ、画像と動画のアップロード、オーディエンスとクリエイティブの管理、インサイト
Snap Ads MCP	https://snap-ads.mcp.pipeboard.co/	37 個のツール — 広告アカウント、キャンペーン、広告グループ、広告、クリエイティブ、メディアのアップロード、インサイト
Reddit Ads MCP	https://reddit-ads.mcp.pipeboard.co/	33 個のツール — アカウント、キャンペーン、広告グループ、広告、パフォーマンスレポート

5 つの広告プラットフォームにわたる 230 個以上のツールを、1 つの認証で利用できます。 これらの URL を Claude、Cursor、ChatGPT、Perplexity、または MCP 対応クライアントに設定してください。pipeboard.co で一度広告アカウントを接続すれば、すべてのクライアントからアクセスできます。

Pipeboard CLI — シェルから使える同じツール

Pipeboard CLI は、上記のすべての MCP ツールを型付きのシェルコマンドとして提供する単一の Go バイナリです。JSON-RPC よりもサブプロセス呼び出しを好む AI コーディングエージェント（Claude Code、Cline、OpenClaw、Codex）や自動化スクリプト向けに構築されています。

brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>

pipeboard meta-ads get-campaigns   --account-id act_123
pipeboard google-ads execute-gaql-query   --customer-id 1234567890 --query "..."
pipeboard tiktok-ads get-campaigns --advertiser-id 7605685552884596737

起動時間は 50 ミリ秒未満で、呼び出しごとの MCP ハンドシェイクは不要。5 つすべてのプラットフォームを 1 つのバイナリで利用できます。詳しくはpipeboard-cli リポジトリをご覧ください。

リポジトリごとに MCP を 1 つ用意するのではなく、ファミリーにする理由

• 1 つのアカウントですべてのプラットフォームを利用 — pipeboard.co で一度認証すれば、同じエージェントセッションから Meta + Google + TikTok + Snap + Reddit を管理できます
• クロスプラットフォームの質問には、クロスプラットフォームの回答が得られます —「先週、最も低コストで登録を獲得したチャネルは？」という質問に、実際に回答できます
• どこでも同じ安全性の基準 — 書き込みは明示的に行い、対応プラットフォームでは新しいキャンペーンは一時停止状態で開始します。また、確認プロンプトは 5 つすべてのサーバーで同じです
• トークン 1 つ、レート制限の上限 1 つ、失効手続きの場所 1 つ — OAuth フローやベンダーごとのインストールを個別に管理する必要はありません

単一プラットフォームの MCP ベンチマークでは、本質を見誤ります。価値はノードではなく、ネットワークにあります。

Pipeboard の比較

AI アシスタントから Meta Ads を利用する方法を選ぶ際の、率直な比較をご紹介します。

	Pipeboard	Meta の公式 MCP	オープンソース／セルフホスト可能なサーバー
プラットフォーム	Meta + Google + TikTok + Snap + Reddit を 1 つのログインで利用	Meta のみ	通常は Meta のみ
セットアップ	ホスト型のリモート MCP — 開発者トークン不要、約 2 分	Meta がホスト（Meta のみ）	セルフホストし、独自のトークンとアップグレードを管理
信頼性	Meta ビジネスパートナーの認定バッジ + 承認済み Meta アプリ	ファーストパーティ（Meta）	さまざま — 自分でコードを監査
安全性	書き込みのたびに明示的な確認が必要。新しいキャンペーンは一時停止状態で開始	Meta が定義	ガードレールは自分で構築
料金	無料プラン、その後は有料プラン	無料（オープンベータ）	無料ですが、インフラは自分で運用

Meta の公式コネクターは、最も安全な単一プラットフォーム向けの選択肢です。Pipeboard はクロスプラットフォーム向けの選択肢です。1 つの認証と 1 つの安全性モデルのもと、5 つの広告ネットワークを同じ会話形式で操作でき、無料プランと Meta ビジネスパートナーの後ろ盾もあります。セルフホストして保守することに問題がなければ、オープンソースのサーバーで完全な制御を実現できます。

リモート MCP を始める（推奨）

最も迅速で信頼性の高い始め方は、**🚀 Meta Ads リモート MCP を始める**ことです。当社のクラウドサービスはストリーム可能な HTTP トランスポートを使用しており、Meta Ads アカウントに信頼性と拡張性の高い方法でアクセスできます。技術的なセットアップは不要です。接続するだけで、AI を使ってキャンペーンの開始、更新、分析をすぐに行えます！

Claude Pro/Max ユーザー向け

1. claude.ai/settings/integrations にアクセスします（Claude Pro または Max が必要です）
2. 「Add Integration」をクリックし、次の情報を入力します。
   • 名前：「Pipeboard Meta Ads」（または任意の名前）
   • インテグレーション URL：https://meta-ads.mcp.pipeboard.co/
3. インテグレーションの横にある「Connect」をクリックし、表示される手順に従って次の操作を行います。
   • Pipeboard にログインする
   • Facebook Ads アカウントを接続する

これで完了です。Claude に Meta 広告キャンペーンの分析、パフォーマンスに関する分析情報の取得、広告の管理を依頼できるようになります。

上級者向け：直接トークン認証（Claude）

対話形式のフローを使わずにトークンで直接認証するには、インテグレーションを追加する際に次の形式の URL を使用します。

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

トークンは pipeboard.co/api-tokens で取得してください。

Cursor ユーザー向け

次の内容を ~/.cursor/mcp.json に追加します。リモート MCP を有効にしたら、「Needs login」をクリックしてログインを完了してください。

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/"
    }
  }
}

上級者向け：直接トークン認証（Cursor）

対話形式のログインフローを使わずに認証する場合は、Pipeboard API トークンを URL に直接含めることができます。

{
  "mcpServers": {
    "meta-ads-remote": {
      "url": "https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN"
    }
  }
}

トークンは pipeboard.co/api-tokens で取得してください。

その他の MCP クライアント向け

リモート MCP URL を使用します：https://meta-ads.mcp.pipeboard.co/

📖 AI クライアントの詳細なセットアップ手順はこちら

上級者向け：直接トークン認証（OpenClaw およびその他のクライアント）

トークン認証に対応した MCP クライアントでは、Pipeboard API トークンを URL の末尾に追加できます。

https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN

これにより対話形式のログインフローを省略し、すぐに認証できます。トークンは pipeboard.co/api-tokens で取得してください。

その他のプラットフォーム

Meta Ads は、ファミリーを構成する 5 つのリモート MCP サーバーの 1 つです。同じ方法でセットアップできる Google Ads、TikTok Ads、Snap Ads、Reddit Ads については、Pipeboard MCP ファミリーをご覧ください。

Pipeboard CLI（MCP の代替）

エージェントが JSON-RPC よりもシェルコマンドを好む場合、Pipeboard CLI では、ファミリー内のすべてのツールを型付きサブコマンドとして利用できます。クイックインストールについては上記のファミリーのセクションを、詳細なドキュメントについてはpipeboard-cli リポジトリをご覧ください。

ローカルインストール（技術に詳しい上級ユーザー向け）

🚀 代わりにリモート MCPを強くおすすめします。より高速で信頼性が高く、技術的なセットアップも不要です。

Meta Ads MCP はローカルのストリーム可能な HTTP トランスポートにも対応しており、スタンドアロンの HTTP API として実行して、ウェブアプリケーションやカスタムインテグレーションで利用できます。手順については、**ストリーム可能な HTTP セットアップガイド**をご覧ください。

機能

• キャンペーン管理：会話からキャンペーン、広告セット、広告を作成し、予算を更新、一時停止・再開、ターゲティングを変更できます。書き込み操作のたびに明示的な確認を行います
• クリエイティブの操作：AI クライアントを離れることなく、画像をアップロードしてクリエイティブを作成し、本文、見出し、説明、CTA を更新できます
• ダイナミッククリエイティブテスト：シンプルな広告（見出し／説明が各 1 つ）と、本格的な A/B テスト（見出し／説明が複数）に対応する 1 つの API
• AI によるキャンペーン分析：お好みの LLM にパフォーマンスを分析させ、実行可能なインサイトを見つけられます
• 戦略的な提案：広告費、ターゲティング、クリエイティブコンテンツを最適化するための、データに基づいた提案を受け取れます
• 予算の最適化：パフォーマンスの高い広告セットに予算を再配分するための提案を取得できます
• クリエイティブの改善：広告本文、画像、行動喚起に関するフィードバックを受け取れます
• 自動モニタリング：MCP 対応の任意の LLM にパフォーマンス指標を追跡させ、重要な変化を通知させることができます
• クロスプラットフォーム連携：Facebook、Instagram、すべての Meta 広告サーフェスで利用できます
• あらゆる LLM に対応：Claude Desktop、Cursor、Cherry Studio など、あらゆる MCP クライアントと互換性があります
• オープンソースだけではなく、パートナーの支援を受けています：Pipeboard が開発。Meta Business Partner の認定バッジを持ち、Meta から正式に承認されたアプリです。無料プランとホスト型リモート MCP を利用でき、セルフホストは不要です
• 検索機能の強化：汎用検索機能では、クエリに「page」または「pages」が含まれる場合、ページも検索します
• 簡単な認証：安全な OAuth 認証で簡単にセットアップできます
• クロスプラットフォーム対応：Windows、macOS、Linux で利用できます

設定

リモート MCP（推奨）

✨ こちらからリモート MCP を始めましょう。技術的なセットアップは不要です。Facebook 広告アカウントを接続して、AI にキャンペーンの分析を依頼するだけです。

ローカルインストール（高度な技術知識のあるユーザー向け）

セルフホストが必要な上級ユーザーは、ソースからパッケージをインストールできます。ローカルにインストールするには、独自の Meta Developer App を作成する必要があります。より簡単に利用するには、リモート MCP の使用をおすすめします。

利用可能な MCP ツール

1. mcp_meta_ads_get_ad_accounts

   • ユーザーがアクセスできる広告アカウントを取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
     • user_id：Meta ユーザー ID、または現在のユーザーを示す「me」
     • limit：返すアカウントの最大数（デフォルト：200）
   • 戻り値：アクセス可能な広告アカウントとその詳細のリスト

2. mcp_meta_ads_get_account_info

   • 特定の広告アカウントに関する詳細情報を取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
     • account_id：Meta 広告アカウント ID（形式：act_XXXXXXXXX）
   • 戻り値：指定されたアカウントの詳細情報

3. mcp_meta_ads_get_account_pages

   • Meta 広告アカウントに関連付けられたページを取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
     • account_id：Meta 広告アカウント ID（形式：act_XXXXXXXXX）、または現在のユーザーのページを示す「me」
   • 戻り値：アカウントに関連付けられたページのリスト。広告の作成と管理に役立ちます

4. mcp_meta_ads_get_campaigns

   • オプションのフィルターを指定して、Meta 広告アカウントのキャンペーンを取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
     • account_id：Meta 広告アカウント ID（形式：act_XXXXXXXXX）
     • limit：返すキャンペーンの最大数（デフォルト：10）
     • status_filter：ステータスでフィルターします（すべてを対象とする場合は空欄、または「ACTIVE」「PAUSED」など）
   • 戻り値：条件に一致するキャンペーンのリスト

5. mcp_meta_ads_get_campaign_details

   • 特定のキャンペーンの詳細情報を取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合はキャッシュされたトークンを使用します）
     • campaign_id：Meta Ads キャンペーン ID
   • 戻り値：指定したキャンペーンの詳細情報

6. mcp_meta_ads_create_campaign

   • Meta Ads アカウントに新しいキャンペーンを作成します

   • 入力：

     • access_token（任意）：Meta API アクセストークン（指定しない場合はキャッシュされたトークンを使用します）

     • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）

     • name：キャンペーン名

     • objective：キャンペーンの目的（ODAX、成果ベース）。次のいずれかを指定します：

       • OUTCOME_AWARENESS
       • OUTCOME_TRAFFIC
       • OUTCOME_ENGAGEMENT
       • OUTCOME_LEADS
       • OUTCOME_SALES
       • OUTCOME_APP_PROMOTION

       注：BRAND_AWARENESS、LINK_CLICKS、CONVERSIONS、APP_INSTALLS などの従来の目的は、新しいキャンペーンでは無効になり、400 エラーが発生します。上記の成果ベースの値を使用してください。一般的な対応関係：

       • BRAND_AWARENESS → OUTCOME_AWARENESS
       • REACH → OUTCOME_AWARENESS
       • LINK_CLICKS、TRAFFIC → OUTCOME_TRAFFIC
       • POST_ENGAGEMENT、PAGE_LIKES、EVENT_RESPONSES、VIDEO_VIEWS → OUTCOME_ENGAGEMENT
       • LEAD_GENERATION → OUTCOME_LEADS
       • CONVERSIONS、CATALOG_SALES、MESSAGES（販売重視のフロー）→ OUTCOME_SALES
       • APP_INSTALLS → OUTCOME_APP_PROMOTION

     • status：キャンペーンの初期ステータス（デフォルト：PAUSED）

     • special_ad_categories：該当する場合、特別広告カテゴリのリスト

     • daily_budget：アカウント通貨での日予算（セント単位）

     • lifetime_budget：アカウント通貨での通算予算（セント単位）

     • bid_strategy：入札戦略。次のいずれかを指定します：LOWEST_COST_WITHOUT_CAP、LOWEST_COST_WITH_BID_CAP、COST_CAP、LOWEST_COST_WITH_MIN_ROAS。

   • 戻り値：新しいキャンペーンの詳細を含む確認情報

   • 例：

     {
       "name": "2025 - Bedroom Furniture - Awareness",
       "account_id": "act_123456789012345",
       "objective": "OUTCOME_AWARENESS",
       "special_ad_categories": [],
       "status": "PAUSED",
       "buying_type": "AUCTION",
       "bid_strategy": "LOWEST_COST_WITHOUT_CAP",
       "daily_budget": 10000
     }
     

7. mcp_meta_ads_get_adsets

   • Meta Ads アカウントの広告セットを取得します。キャンペーンによる絞り込みも任意で指定できます
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合はキャッシュされたトークンを使用します）
     • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）
     • limit：返す広告セットの最大数（デフォルト：10）
     • campaign_id：絞り込みに使用する任意のキャンペーン ID
   • 戻り値：条件に一致する広告セットのリスト

8. mcp_meta_ads_get_adset_details

   • 特定の広告セットの詳細情報を取得します
   • 入力：
     • access_token（任意）：Meta API アクセストークン（指定しない場合はキャッシュされたトークンを使用します）
     • adset_id：Meta Ads 広告セット ID
   • 戻り値：指定した広告セットの詳細情報

9. mcp_meta_ads_create_adset

   • Meta Ads アカウントに新しい広告セットを作成します
   • 入力：
     • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）
     • campaign_id：この広告セットが属する Meta Ads キャンペーン ID
     • name：広告セット名
     • status：広告セットの初期ステータス（デフォルト：PAUSED）
     • daily_budget：アカウント通貨での 1 日の予算（セント単位）を文字列で指定します
     • lifetime_budget：アカウント通貨での通算予算（セント単位）を文字列で指定します
     • targeting：ターゲティングの仕様（年齢、地域、興味・関心など）
     • optimization_goal：コンバージョン最適化の目標（例：'LINK_CLICKS'）
     • billing_event：課金方法（例：'IMPRESSIONS'）
     • bid_amount：入札額（セント単位）。LOWEST_COST_WITH_BID_CAP、COST_CAP、TARGET_COST では必須です。
     • bid_strategy：入札戦略（例：'LOWEST_COST_WITHOUT_CAP'、'LOWEST_COST_WITH_MIN_ROAS'）
     • bid_constraints：入札制約の辞書。LOWEST_COST_WITH_MIN_ROAS では必須です（例：{"roas_average_floor": 20000}）
     • start_time、end_time：開始時刻と終了時刻（省略可能、ISO 8601）
     • access_token（省略可能）：Meta API アクセストークン
   • 戻り値：新しい広告セットの詳細を含む確認情報

10. mcp_meta_ads_get_ads

    • Meta Ads アカウントの広告を取得します。フィルタリングは任意です
    • 入力：
      • access_token（省略可能）：Meta API アクセストークン（指定されていない場合はキャッシュ済みトークンを使用します）
      • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）
      • limit：取得する広告の最大数（デフォルト：10）
      • campaign_id：フィルタリングに使用するキャンペーン ID（省略可能）
      • adset_id：フィルタリングに使用する広告セット ID（省略可能）
    • 戻り値：条件に一致する広告のリスト

11. mcp_meta_ads_create_ad

    • 既存のクリエイティブを使用して新しい広告を作成します
    • 入力：
      • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）
      • name：広告名
      • adset_id：この広告を配置する広告セット ID
      • creative_id：使用する既存のクリエイティブ ID
      • status：広告の初期ステータス（デフォルト：PAUSED）
      • bid_amount：入札額（セント単位、省略可能）
      • tracking_specs：トラッキングの仕様（省略可能）
      • access_token（省略可能）：Meta API アクセストークン
    • 戻り値：新しい広告の詳細を含む確認情報

12. mcp_meta_ads_get_ad_details

    • 特定の広告の詳細情報を取得します
    • 入力：
      • access_token（省略可能）：Meta API アクセストークン（指定されていない場合はキャッシュ済みトークンを使用します）
      • ad_id：Meta Ads 広告 ID
    • 戻り値：指定した広告の詳細情報

13. mcp_meta_ads_get_ad_creatives

    • 特定の広告のクリエイティブの詳細を取得します
    • 入力：
      • access_token（省略可能）：Meta API アクセストークン（指定されていない場合はキャッシュ済みトークンを使用します）
      • ad_id：Meta Ads 広告 ID
    • 戻り値：テキスト、画像、URL を含むクリエイティブの詳細

14. mcp_meta_ads_create_ad_creative

    • アップロードした画像のハッシュを使用して、新しい広告クリエイティブを作成します
    • 入力：
      • account_id：Meta Ads アカウント ID（形式：act_XXXXXXXXX）
      • name：クリエイティブ名
      • image_hash：アップロードした画像のハッシュ
      • page_id：広告に使用する Facebook ページ ID
      • link_url：リンク先 URL
      • message：広告コピー／テキスト
      • headline：シンプルな広告用の見出し（headlines とは併用できません）
      • headlines：ダイナミッククリエイティブのテスト用の見出しリスト（headline とは併用できません）
      • description：シンプルな広告用の説明文（descriptions とは併用できません）
      • descriptions：ダイナミッククリエイティブのテスト用の説明文リスト（description とは併用できません）
      • dynamic_creative_spec：ダイナミッククリエイティブ最適化の設定
      • call_to_action_type：CTA ボタンの種類（例：'LEARN_MORE'）
      • instagram_actor_id：Instagram アカウント ID（省略可能）
      • access_token（省略可能）：Meta API アクセストークン
    • 戻り値：新しいクリエイティブの詳細を含む確認情報

15. mcp_meta_ads_update_ad_creative

    • 既存の広告クリエイティブのコンテンツまたは設定を新しい内容に更新します
    • 入力：
      • creative_id：更新するMeta AdsクリエイティブのID
      • name：新しいクリエイティブ名
      • message：新しい広告コピー／テキスト
      • headline：シンプルな広告向けの単一の見出し（headlinesと併用できません）
      • headlines：ダイナミッククリエイティブテスト向けの新しい見出しリスト（headlineと併用できません）
      • description：シンプルな広告向けの単一の説明（descriptionsと併用できません）
      • descriptions：ダイナミッククリエイティブテスト向けの新しい説明リスト（descriptionと併用できません）
      • dynamic_creative_spec：新しいダイナミッククリエイティブ最適化設定
      • call_to_action_type：新しいコールトゥアクションボタンの種類
      • access_token（任意）：Meta APIアクセストークン（指定しない場合はキャッシュ済みのトークンを使用します）
    • 戻り値：更新されたクリエイティブの詳細を含む確認情報

16. mcp_meta_ads_upload_ad_image

    • Meta Adsクリエイティブで使用する画像をアップロードします
    • 入力：
      • account_id：Meta AdsアカウントID（形式：act_XXXXXXXXX）
      • image_path：アップロードする画像ファイルのパス
      • name：画像の任意の名前
      • access_token（任意）：Meta APIアクセストークン
    • 戻り値：ハッシュを含む画像の詳細を記載したJSONレスポンス

17. mcp_meta_ads_get_ad_image

    • Meta広告の画像を1回の操作で取得、ダウンロード、表示します
    • 入力：
      • access_token（任意）：Meta APIアクセストークン（指定しない場合はキャッシュ済みのトークンを使用します）
      • ad_id：Meta Ads広告ID
    • 戻り値：そのまま視覚分析に使用できる広告画像

18. mcp_meta_ads_update_ad

    • 新しい設定で広告を更新します
    • 入力：
      • ad_id：Meta Ads広告ID
      • status：広告のステータスを更新します（ACTIVE、PAUSEDなど）
      • bid_amount：アカウント通貨での入札額（USDの場合はセント単位）
      • access_token（任意）：Meta APIアクセストークン（指定しない場合はキャッシュ済みのトークンを使用します）
    • 戻り値：更新された広告の詳細と確認リンクを含む確認情報

19. mcp_meta_ads_update_adset

    • フリークエンシーキャップなどの新しい設定で広告セットを更新します
    • 入力：
      • adset_id：Meta Ads広告セットID
      • frequency_control_specs：フリークエンシー制御の仕様リスト
      • bid_strategy：入札戦略（例：'LOWEST_COST_WITH_BID_CAP'、'LOWEST_COST_WITH_MIN_ROAS'）
      • bid_amount：セント単位の入札額。LOWEST_COST_WITH_BID_CAP、COST_CAP、TARGET_COSTでは必須です。
      • bid_constraints：入札制約の辞書。LOWEST_COST_WITH_MIN_ROASでは必須です（例：{"roas_average_floor": 20000}）
      • status：広告セットのステータスを更新します（ACTIVE、PAUSEDなど）
      • targeting：targeting_automationを含むターゲティング仕様
      • access_token（任意）：Meta APIアクセストークン（指定しない場合はキャッシュ済みのトークンを使用します）
    • 戻り値：更新された広告セットの詳細と確認リンクを含む確認情報

20. mcp_meta_ads_get_insights

    • キャンペーン、広告セット、広告、またはアカウントのパフォーマンスインサイトを取得します
    • 入力：
      • access_token（任意）：Meta APIアクセストークン（指定しない場合はキャッシュ済みのトークンを使用します）
      • object_id：キャンペーン、広告セット、広告、またはアカウントのID
      • time_range：インサイトの期間（デフォルト：最大）
      • breakdown：任意の内訳ディメンション（例：年齢、性別、国）
      • level：集計レベル（ad、adset、campaign、account）
      • action_attribution_windows（任意）：コンバージョンデータのアトリビューション期間のリスト（例：["1d_click", "1d_view", "7d_click", "7d_view"]）。指定すると、actionsおよびcost_per_action_typeに各期間の追加フィールドが含まれます。'value'フィールドには常に7d_clickのアトリビューションが表示されます。
    • 戻り値：指定したオブジェクトのパフォーマンス指標

21. mcp_meta_ads_get_login_link

    • Meta Ads 認証用のクリック可能なログインリンクを取得します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
    • 戻り値：Meta 認証用のクリック可能なリソースリンク

22. mcp_meta_ads_create_budget_schedule

    • Meta Ads キャンペーンの予算スケジュールを作成します
    • 入力：
      • campaign_id：Meta Ads キャンペーン ID
      • budget_value：予算の増加額
      • budget_value_type：予算値の種類（"ABSOLUTE" または "MULTIPLIER"）
      • time_start：需要が高い期間の開始時刻を示す Unix タイムスタンプ
      • time_end：需要が高い期間の終了時刻を示す Unix タイムスタンプ
      • access_token（任意）：Meta API アクセストークン
    • 戻り値：作成された予算スケジュールの ID を含む JSON 文字列、またはエラーメッセージ

23. mcp_meta_ads_search_interests

    • キーワードで興味・関心のターゲティングオプションを検索します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • query：興味・関心の検索語（例："baseball"、"cooking"、"travel"）
      • limit：返される結果の最大数（デフォルト：25）
    • 戻り値：id、name、audience_size、path フィールドを含む興味・関心データ

24. mcp_meta_ads_get_interest_suggestions

    • 既存の興味・関心に基づいて、興味・関心の候補を取得します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • interest_list：候補を取得する興味・関心の名前のリスト（例：["Basketball", "Soccer"]）
      • limit：返される候補の最大数（デフォルト：25）
    • 戻り値：id、name、audience_size、description フィールドを含む興味・関心の候補

25. mcp_meta_ads_validate_interests

    • ターゲティングに使用する興味・関心の名前または ID を検証します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • interest_list：検証する興味・関心の名前のリスト（例：["Japan", "Basketball"]）
      • interest_fbid_list：検証する興味・関心の ID のリスト（例：["6003700426513"]）
    • 戻り値：各興味・関心の有効性と audience_size を示す検証結果

26. mcp_meta_ads_search_behaviors

    • 利用可能なすべての行動ターゲティングオプションを取得します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • limit：返される結果の最大数（デフォルト：50）
    • 戻り値：id、name、audience_size の範囲、path、description を含む行動ターゲティングオプション

27. mcp_meta_ads_search_demographics

    • デモグラフィックターゲティングオプションを取得します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • demographic_class：デモグラフィックの種類（'demographics'、'life_events'、'industries'、'income'、'family_statuses'、'user_device'、'user_os'）
      • limit：返される結果の最大数（デフォルト：50）
    • 戻り値：id、name、audience_size の範囲、path、description を含むデモグラフィックターゲティングオプション

28. mcp_meta_ads_search_geo_locations

    • 地理的ターゲティングの場所を検索します
    • 入力：
      • access_token（任意）：Meta API アクセストークン（指定しない場合は、キャッシュされたトークンを使用します）
      • query：場所の検索語（例："New York"、"California"、"Japan"）
      • location_types：検索する場所の種類（['country', 'region', 'city', 'zip', 'geo_market', 'electoral_district']）
      • limit：返される結果の最大数（デフォルト：25）
    • 戻り値：key、name、type、および地理的階層情報を含む場所データ

ライセンス

Meta Ads MCP は Business Source License 1.1 に基づいてライセンスされており、次のことを意味します。

• ✅ 個人および業務で無料で利用できます
• ✅ 必要に応じて変更およびカスタマイズできます
• ✅ 他者に再配布できます
• ✅ 2029 年 1 月 1 日に完全なオープンソース（Apache 2.0）になります

唯一の制限は、競合するホステッドサービスとして提供できないことです。商用ライセンスに関するご質問は、お問い合わせください。

プライバシーとセキュリティ

Meta Ads MCP は、安全なトークン管理と自動認証処理により、セキュリティのベストプラクティスに従っています。

• リモート MCP：認証はすべてクラウド上で安全に処理されるため、ローカルでトークンを保存する必要はありません
• ローカルインストール：トークンはローカルマシン上に安全にキャッシュされます

テスト

基本的なテスト

任意の MCP クライアントで Meta Ads MCP への接続をテストできます。

1. アカウントへのアクセスを確認：LLM に mcp_meta_ads_get_ad_accounts を使うよう依頼します
2. アカウントの詳細を確認：アカウント ID を指定して mcp_meta_ads_get_account_info を使います
3. キャンペーンを一覧表示：mcp_meta_ads_get_campaigns を試して、広告キャンペーンを確認します

ローカルインストールの詳細なテスト方法については、ソースリポジトリをご覧ください。

トラブルシューティング

💡 手軽な解決策：技術的なセットアップをスキップしましょう！

セットアップに関する問題を避ける最も簡単な方法は、🎯 Remote MCP をご利用いただくことです。ダウンロードも設定も不要です。広告アカウントに接続するだけで、すぐにキャンペーンに関する AI の分析情報を得られます！

ローカルインストールに関する問題

ローカルインストールに関する問題については、ソースリポジトリをご覧ください。最も簡単にご利用いただくには、代わりに Remote MCP の使用をおすすめします。