Facebook 広告 MCP サーバー

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

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

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

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

• ⊞ Windows: 👉 gomarble_mcp_tools.exe をダウンロード

•  MacOS: 👉 gomarble_mcp_tools.pkg をダウンロード

何をするのか

• MCP サーバーをローカルにインストールして構成します

• 環境設定を自動的に処理します

• プロセス中にFacebookトークン認証を求めるプロンプトが表示されますが、これはオプションです。

• Facebookのアクセストークンが提供されていない場合は、GoMarbleのサーバーに接続して、代わりにトークンを作成します。

重要な免責事項

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

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

Related MCP server: mcp-servers

設定

前提条件

• Python 3.10以上

• requirements.txtにリストされている依存関係

1. (オプションですが推奨) 仮想環境を作成してアクティブ化します。

   python3 -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`

   仮想環境を使用すると、プロジェクトの依存関係をきれいに管理できます[ソース] 。

2. 依存関係をインストールします:

   pip install -r requirements.txt

3. **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 広告のオブジェクトやデータを操作するためのツールを提供します。

(注: ほとんどのツールは、 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