MCP 経由で Meta Ads を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Meta Ads をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Meta Ads + Cursor

AI に Facebook と Instagram の広告を分析させます。キャンペーン、広告セット、広告、年齢、国、配置ごとの消化金額、リーチ、クリック、コンバージョンに加え、キャンペーン、クリエイティブ、オーディエンス、変更履歴を確認できます。確認のうえで、広告の一時停止や配信開始、予算の変更もできます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

META_ADS_ACCESS_TOKEN, META_ADS_ACCOUNT_ID

ステップ 1 — 認証情報を取得

1. https://developers.facebook.com/apps/creation/ を開き、ユースケース Create & manage ads with Marketing API でアプリを作成して、ビジネスポートフォリオに接続します。これでアプリに ads_read、ads_management、business_management の権限が追加されます。
2. おすすめは有効期限のないトークンです。Business Settings（https://business.facebook.com/settings）で Users → System users を開き、システムユーザーを追加します（ロールは Admin、読み取り専用なら Employee）。Assign assets で広告アカウントを割り当てます（Manage campaigns、読み取り専用なら View performance）。Generate token をクリックしてアプリを選び、有効期限に Never を選んで ads_read にチェックを入れます。ステータスや予算を変更する場合は ads_management も選びます。Meta から先にビジネスポートフォリオの認証（Business Settings → Security Center）を求められることがあります。それが済むまではステップ 3 のトークンを使ってください。
3. テスト用のより手早い方法: Graph API Explorer（https://developers.facebook.com/tools/explorer/）でアプリを選び、ads_read と ads_management を付けた User Token を取得します。このトークンは 1 から 2 時間で切れるため、Access Token Debugger（https://developers.facebook.com/tools/debug/accesstoken）で開いて Extend Access Token をクリックし、60 日間有効なトークンにします。
4. トークンを META_ADS_ACCESS_TOKEN に貼り付けます（EA で始まります。Bearer という語は付けずに貼り付けてください）。広告アカウント ID は act_ を付けて META_ADS_ACCOUNT_ID に入力します（例: act_1234567890）。番号は Ads Manager のアドレスバーに表示されます（act=1234567890）。
5. コネクターをインストールし、meta_ads_list_ad_accounts を実行します。トークンでアクセスできるすべての広告アカウントが、ステータス、通貨、タイムゾーンとともに表示されます。

アクセスレベル: 新しいアプリは Limited access（旧 Standard）です。自社ビジネスの広告アカウントにはこれで足りますが、レート制限が厳しくかかります。他社の広告アカウントには、App Review を経た Full access（旧 Advanced）が必要です。Require App Secret（App settings → Advanced）はオフのままにしてください。オンにすると、Meta がコネクターの呼び出しを拒否します。

必ず先に確認します: meta_ads_update_status はキャンペーン、広告セット、広告の一時停止や配信開始を行い、meta_ads_update_budget は 1 日の予算または通算予算を変更します。どちらもすぐに反映され、広告費に影響します。配信開始で費用が発生し始め、一時停止で配信が止まります。AI は対象（名前と ID）、現在の値と新しい値を示し、あなたの承認を待ちます。広告が配信されるのは、広告、その広告セット、そのキャンペーンがすべて ACTIVE のときだけです。予算はアカウント通貨の最小単位による整数です（2000 は 20.00 EUR）。JPY や KRW などの通貨には補助単位がありません。

読み取れるデータ: 広告アカウント、キャンペーン、ターゲティングを含む広告セット、配信されない理由付きの広告、クリエイティブ、カスタムオーディエンスと類似オーディエンス、変更履歴（誰がいつ何を変更したか）、パフォーマンスです。インサイトでは、アカウント全体または個別のキャンペーン、広告セット、広告について、過去 7 日間や先月などの定型期間、または最大 37 か月前までの任意の日付で、消化金額、リーチ、クリック、コンバージョンを確認でき、必要に応じて日別にし、年齢、性別、国、地域、配置ごとに分けられます。

よくあるエラー: 190: トークンが無効か期限切れです。新しいトークンを作成してください。10 または 200 から 299: 権限が不足しているか（294 は ads_management の不足）、トークンにこの広告アカウントへのアクセス権がありません。100: パラメーターが誤っています。サブコード 1487534 の場合はリクエストが大きすぎるので、期間を短くするか内訳を減らしてください。4、17、613、80000、80004 はレート制限です。数分待ってください。

このコネクターは何も作成しません。キャンペーン、広告セット、広告、クリエイティブ、オーディエンスの作成や編集、メディアのアップロード、リード獲得フォーム、ピクセル、Conversions API の管理は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Meta Ads のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「先月 Facebook と Instagram でいくら使いましたか。購入単価が最も低かったキャンペーンはどれですか。」
• 「過去 30 日間の消化金額とクリックを、年齢、性別、配置ごとに分けて見せてください。」
• 「今配信されていない広告はどれですか。その理由も教えてください。」
• 「成果が最も良いキャンペーンの 1 日の予算を 20% 上げてください。ただし変更する前に、現在の予算と新しい予算を見せてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続