Facebook 広告 MCP サーバー

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

お使いのブラウザはビデオタグをサポートしていません。

簡単なワンクリックセットアップ

セットアップをより簡単にするために、すぐに使用できるインストーラーを提供しています。

⊞ Windows: 👉 gomarble_mcp_tools.exe をダウンロード
 MacOS: 👉 gomarble_mcp_tools.pkg をダウンロード

何をするのか

MCP サーバーをローカルにインストールして構成します
環境設定を自動的に処理します
プロセス中にFacebookトークン認証を求めるプロンプトが表示されますが、これはオプションです。
Facebookのアクセストークンが提供されていない場合は、GoMarbleのサーバーに接続して、代わりにトークンを作成します。

重要な免責事項

この設定では、Facebook 開発者アクセストークンを手動で取得する必要はありません。

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

設定

前提条件

Python 3.10以上
requirements.txtにリストされている依存関係

(オプションですが推奨) 仮想環境を作成してアクティブ化します。
python3 -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
仮想環境を使用すると、プロジェクトの依存関係をきれいに管理できます[ソース] 。
依存関係をインストールします:
pip install -r requirements.txt
**Facebookアクセストークンの取得：**必要な権限（例： ads_read ）を持つFacebookユーザーアクセストークンを取得してください。これはFacebook開発者ポータルから生成できます。こちらのリンクをクリックしてください。

MCP クライアント (例: Cursor、Claude Desktop) での使用

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

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_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_FACEBOOK_ACCESS_TOKEN"
      // ]
    }
  }
}

構成を更新した後、MCP クライアントアプリを再起動します。

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

サーバーのデバッグ

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

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

利用可能なMCPツール

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

ツール名	説明
アカウントとオブジェクトの読み取り
`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 (例: Insights) からデータを取得します。
アクティビティ/変更履歴
`get_activities_by_adaccount`	広告アカウントの変更履歴を取得します。
`get_activities_by_adset`	広告セットの変更履歴を取得します。

(注: ほとんどのツールは、 fields 、 filtering 、 limit 、 pagination 、 date ranges などの追加パラメータをサポートしています。各ツールの引数の完全なリストと説明については、 server.py内の詳細なドキュメント文字列を参照してください。)

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

依存関係

mcp (>=1.6.0)
リクエスト(>=2.32.3)

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Facebook 広告サーバーを自動的にインストールするには:

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

Facebook-Ads-MCP-Server

Integrations