Meta Ads MCP Server

AIと会話するだけで、Meta広告（Facebook / Instagram）を管理・分析できるMCPサーバー

普段Meta広告マネージャーでやっている操作 ― レポートの確認、キャンペーン作成、ターゲティング変更、予算調整、クリエイティブ管理まで ― を、AIとのチャットだけで完結できます。広告マネージャーを開く必要はありません。

特徴

• 30のツール — 読み取り18 + 書き込み12で、Meta広告の管理を網羅
• 安全設計 — 書き込み操作はデフォルトで dry_run（プレビューのみ）。新規作成はすべて PAUSED 状態
• OAuth対応 — ブラウザでFacebookログインするだけで認証完了。トークンは約60日間有効
• Claude Desktop / Claude Code / Cursor 対応 — MCP互換のAIクライアントならどれでも使用可能
• 依存最小 — Python + requests + python-dotenv のみ。追加SDKは不要

クイックスタート

1. リポジトリをクローン

git clone https://github.com/nishi0077/meta-ads-mcp.git
cd meta-ads-mcp

2. 依存パッケージをインストール

python -m venv .venv

# Mac/Linux:
source .venv/bin/activate
# Windows:
.venv\Scripts\activate

pip install -r requirements.txt

3. 環境変数を設定

cp .env.example .env

.env を編集して Meta App の情報を入力します（Meta App の作成方法はこちら）。

META_AUTH_TYPE=oauth
META_APP_ID=あなたのアプリID
META_APP_SECRET=あなたのApp Secret
META_AD_ACCOUNT_ID=act_xxxxxxxxxxxxx   # 任意。空でもOK
META_API_VERSION=v24.0

4. 初回認証

python meta_ads_server.py

ブラウザが開き、Facebookログイン画面が表示されます。ログインして「許可」するとトークンが保存されます（約60日間有効）。

5. AIクライアントに接続

#### Claude Desktop

設定ファイル（Mac: ~/Library/Application Support/Claude/claude_desktop_config.json / Windows: %APPDATA%\Claude\claude_desktop_config.json）に追加：

{
  "mcpServers": {
    "meta-ads": {
      "command": "/path/to/meta-ads-mcp/.venv/bin/python",
      "args": ["/path/to/meta-ads-mcp/meta_ads_server.py"]
    }
  }
}

Windows の場合、command は .venv\\Scripts\\python.exe に変更してください。

#### Claude Code

claude mcp add meta-ads -- python /path/to/meta-ads-mcp/meta_ads_server.py

#### Cursor

Cursorの設定 → MCP → 「Add new MCP server」で以下を設定：

• Name: meta-ads
• Type: command
• Command: python /path/to/meta-ads-mcp/meta_ads_server.py

使い方

接続したら、AIに話しかけるだけで使えます。

「アカウント一覧を見せて」

「過去30日間のキャンペーン成果を教えて」

「広告を年齢×性別でブレイクダウンして」

「キャンペーンの日予算を5,000円に変更して」

「このキャンペーンを一時停止して」

「25-45歳女性、日本向けの広告セットを作って」

「この画像をアップロードして、クリエイティブを作って」

「成果の悪い広告を停止して」

「2つの広告クリエイティブを比較分析して」

「全アカウントの今月の広告費を一覧して」

ツール一覧

読み取り系（18ツール）

書き込み系（12ツール）

安全設計

• 書き込み系はすべて `dry_run=true`（プレビュー）がデフォルト
• 「こう変わります」を確認してから dry_run=false で実行
• 新規作成はすべて PAUSED（停止）状態 で作成 — うっかり配信される心配なし

Meta App の作成

初回のみの作業です。5分程度で完了します。

1. App の作成

1. Meta for Developers にアクセスしてログイン
2. 「マイアプリ」→「アプリを作成」
3. 設定：

• ユースケース: 「その他」→「次へ」
• アプリタイプ: 「ビジネス」→「次へ」
• アプリ名: 好きな名前（例: My Meta Ads MCP）
• ビジネスアカウント: 自分のMeta Businessアカウントを選択

1. 「アプリを作成」

2. Marketing API の追加

1. アプリダッシュボードで「プロダクトを追加」
2. Marketing API を見つけて「設定」

3. App ID と App Secret の取得

1. 左メニュー「アプリ設定」→「ベーシック」
2. アプリID と App Secret をコピー

App Secret は絶対に他人に共有しないでください。

4. ビジネス認証（広告の作成・編集に必要）

読み取り専用（レポート確認等）はビジネス認証なしでも使えます。広告の作成・編集には認証が必要です。

1. Meta Business Settings →「セキュリティセンター」
2. 「ビジネス認証を開始」→ 書類をアップロード（通常 2〜7 営業日）

認証方式

トラブルシューティング

技術情報

• プロトコル: Model Context Protocol (MCP)
• API: Meta Graph API（直接リクエスト、SDK不使用）
• 認証: OAuth 2.0 + ローカルHTTPコールバック / System User Token
• APIバージョン: v24.0（.env で変更可能）

ライセンス

MIT License