Facebook Ads MCP Server

Facebook/Meta 広告 MCP サーバー

このプロジェクトでは、Meta 広告へのインターフェースとして機能する MCP サーバーを提供し、Meta 広告データへのプログラムからのアクセスと管理機能を実現します。

お使いのブラウザーは video タグに対応していません。

ワンクリックで簡単にセットアップ

セットアップをより簡単に行えるよう、すぐに使えるインストーラーをご用意しています。

👉 インストーラーをダウンロード - https://gomarble.ai/mcp

サポートや最新情報についてコミュニティに参加しましょう

👉 Slack コミュニティ - AI in Ads

Google 広告 MCP サーバーもお試しください

👉 Google Ads MCP - Google Ads MCP

このサーバーの機能

• MCP サーバーをローカルにインストールして設定します
• 環境のセットアップを自動で行います
• 処理中に Meta トークン認証を求めますが、これは省略可能です
• Meta アクセストークンが指定されていない場合、GoMarble のサーバーに接続し、代わりにトークンを作成します

重要な免責事項

このセットアップでは、Meta Developer Access Token を手動で取得する必要はありません。

代わりに、GoMarble のサーバーに安全に接続し、代わりにトークンを作成します。 GoMarble がトークンを保存することはありません。トークンは MCP サーバーで使用するため、マシン上にローカル保存されます。

---

セットアップ

前提条件

• Python 3.10+
• requirements.txt に記載されている依存関係

1. （任意ですが推奨）仮想環境を作成して有効化する：

   python3 -m venv venv
   source venv/bin/activate  # Windows では `venv\Scripts\activate` を使用
   

   仮想環境を使用すると、プロジェクトの依存関係を適切に管理できます[Source]。

2. 依存関係をインストールする：

   pip install -r requirements.txt
   

3. Meta アクセストークンを取得する： ads_read など、必要な権限を持つ Meta User Access Token を取得してください。Meta Developer ポータルから生成できます。こちらのリンクを参照してください。

MCP クライアントでの使用方法（例：Cursor、Claude Desktop）

このサーバーを MCP 対応クライアントに統合するには、以下のような設定を追加します（Claude）。YOUR_META_ACCESS_TOKEN を実際のトークンに置き換え、必要に応じて server.py へのパスを変更してください。

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
      // If using a virtual environment, you might need to specify the python executable within the venv:
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_META_ACCESS_TOKEN"
      // ]
    }
  }
}

設定を更新した後、MCP クライアントアプリを再起動してください。

(注：Windows では、環境に応じてコマンド構成を調整するか、cmd /k を使用する必要がある場合があります。)

サーバーのデバッグ

server.py を実行し、--fb-token 引数でアクセストークンを指定します。

python server.py --fb-token YOUR_META_ACCESS_TOKEN

利用可能な MCP ツール

この MCP サーバーは、META Ads のオブジェクトやデータを操作するためのツールを提供します。

ツール名	説明
アカウントとオブジェクトの読み取り
list_ad_accounts	トークンに紐付けられた広告アカウントの一覧を取得します。
get_details_of_ad_account	特定の広告アカウントの詳細を取得します。
get_campaign_by_id	特定のキャンペーンの詳細を取得します。
get_adset_by_id	特定の広告セットの詳細を取得します。
get_ad_by_id	特定の広告の詳細を取得します。
get_ad_creative_by_id	特定の広告クリエイティブの詳細を取得します。
get_adsets_by_ids	複数の広告セットの詳細を ID で指定して取得します。
コレクションの取得
get_campaigns_by_adaccount	広告アカウント内のキャンペーンを取得します。
get_adsets_by_adaccount	広告アカウント内の広告セットを取得します。
get_ads_by_adaccount	広告アカウント内の広告を取得します。
get_adsets_by_campaign	キャンペーン内の広告セットを取得します。
get_ads_by_campaign	キャンペーン内の広告を取得します。
get_ads_by_adset	広告セット内の広告を取得します。
get_ad_creatives_by_ad_id	広告に関連付けられたクリエイティブを取得します。
インサイトとパフォーマンスデータ
get_adaccount_insights	広告アカウントのパフォーマンスインサイトを取得します。
get_campaign_insights	キャンペーンのパフォーマンスインサイトを取得します。
get_adset_insights	広告セットのパフォーマンスインサイトを取得します。
get_ad_insights	広告のパフォーマンスインサイトを取得します。
fetch_pagination_url	ページネーション URL（インサイトなどから取得）からデータを取得します。
アクティビティ／変更履歴
get_activities_by_adaccount	広告アカウントの変更履歴を取得します。
get_activities_by_adset	広告セットの変更履歴を取得します。

(注：ほとんどのツールは、fields、filtering、limit、ページネーション、日付範囲などの追加パラメーターに対応しています。各ツールの引数の一覧と説明については、server.py 内の詳細な docstring を参照してください。)

(注：Meta のアクセストークンの有効期限が切れた場合は、新しいトークンを生成し、ツールを引き続き使用できるよう、MCP クライアントの設定ファイルを新しいトークンで更新する必要があります。)

依存関係

• mcp (>=1.6.0)
• requests (>=2.32.3)

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。

---

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の Facebook Ads Server を自動的にインストールするには：

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude