Meta Marketing API（Facebook/Instagram広告・Ads MCP・Ads CLI）

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり

システムユーザートークン発行時に scope を指定でき、対応スコープの一覧に ads_read と ads_management が別々に載っている（公式のトークン生成ドキュメント）。そのため、API用トークンは ads_read などの読み取り系スコープだけで発行できると読める。ただし ads_read だけでMCP／CLIが動くか・書き込みツールが拒否されるかは公式ページに記載なし。MCP自体に読み取り専用モードの記載はない。

権限（スコープ）を選べるか あり

MCPのユーザーアクセストークンで要求する権限: ads_mcp_management・ads_read・ads_management・catalog_management・business_management・pages_show_list・instagram_basic。CLIはシステムユーザーアクセストークンで認証（CLI概要ページは必要な権限を載せていない。権限の一覧とシステムユーザーに必要な資産だけを付与する推奨はCLIの get-started ページに書かれていた内容で、再確認はしていない）。

危険な操作の既定

MCP: 公式ページに「Write tools create entities in a paused state; your AI client asks for confirmation before activation」とある（広告の作成・管理ページ）。ads_activate_entity は「starts spending budget」と説明。ads_boost_ig_post（投稿をブーストした広告にする）は一時停止で作られるかをページに記載なし。ads_update_entity で status や予算を変えられるかも記載なし。カタログ・Pixelの削除ツール（下記）に確認の記載は読んだページになし。CLI: delete コマンドは既定で確認プロンプトが出て、各 delete コマンドの --force で省略、グローバルの --no-input で対話プロンプトを無効化。campaign create の --status 既定は PAUSED。

削除ができるか できる

【MCP】広告の作成・管理: ads_delete_custom_audience。カタログ: ads_catalog_delete_product（商品）、ads_catalog_product_set_delete（商品セットとその絞り込みルール。商品自体は消えない）、ads_catalog_product_feed_delete（フィード。フィードが取り込んだ商品も非同期で削除される。他のデータソースからも供給される商品は残る）、ads_catalog_product_feed_delete_rule（フィードの変換ルール）、ads_catalog_event_source_disconnect（カタログとイベントソースのリンクの解除）。シグナルとデータセット: ads_pixel_event_delete（イベントルール）、ads_pixel_parameter_delete（パラメータ）。A/Bテスト: ads_experiment_abtest_update_test は「Edit or cancel」。キャンペーン・広告セット・広告そのものの削除ツールは広告の作成・管理ページに無い。【CLI】meta ads campaign / adset / ad / creative / catalog の delete（キャンペーン削除は子の広告セット・広告も、広告セット削除は子の広告も削除。有効な広告が使うクリエイティブは削除不可。dataset delete はなく dataset disconnect は広告アカウントとの共有解除）。【API】広告の削除。復元可否は記載なし。

取り消し方（キー・接続）

システムユーザーのアクセストークンは、公式ドキュメントのAPI手順で取り消せる。oauth/revoke に client_id・client_secret・revoke_token・access_token を付けてGETし、成功すると {"success":"true"} が返り、そのトークンは直ちに使えなくなる、と書かれている。Business Managerの画面でトークンを生成できるとの記載はあるが、画面での取り消し手順は読んだページになし。MCP（OAuth接続）の切断・取り消し手順は広告MCPのoverview・get-startedページに記載なし。（根拠: https://developers.facebook.com/docs/business-management-apis/system-users/install-apps-and-generate-tokens/）

根拠のページ

つなぎ方（公式の資料にある範囲）

できる操作

読み取りでできる操作

• 【MCP】パフォーマンスレポート・インサイト、広告アカウント・Page・クリエイティブ・広告画像/動画・広告プレビュー・カスタムオーディエンス・Instagramアカウントの取得、Meta広告ライブラリ検索、アクティビティログ、A/Bテスト・リフト調査の詳細取得
• 【CLI】`meta ads campaign list`、`meta ads insights get --fields spend,impressions,ctr,cpc` など
• 【API】インサイト・分析の取得

書き込みでできる操作

• 【MCP】キャンペーン・広告セット・広告・クリエイティブの作成（一時停止状態で作成）、ads_update_entity での更新、カスタムオーディエンスの作成・更新、Instagram投稿のブースト、カタログ・A/Bテストの作成と管理。更新系として ads_catalog_update_catalog / update_product / update_product_set / update_product_feed、ads_pixel_event_update（イベントルールの有効化・無効化）、ads_pixel_parameter_update もある
• 【CLI】キャンペーン・広告セット・広告・クリエイティブ・カタログ・データセットの create / update
• 【API】キャンペーン・広告セット・広告の作成と更新

管理者操作（削除・課金・設定変更など）

• 【MCP】ads_activate_entity は一時停止中のキャンペーン・広告セット・広告を有効化し、予算の消化（広告費の発生）が始まる。公式ページには、AIクライアントが有効化前に確認を求めると書かれている
• 【MCP】削除・取り消し系のツール: 「広告の作成・管理」ページは ads_delete_custom_audience（カスタムオーディエンス削除）のみ。カタログのページ: ads_catalog_delete_product（商品）、ads_catalog_product_set_delete（商品セットとその絞り込みルール。商品自体は消えない）、ads_catalog_product_feed_delete（フィード。フィードが取り込んだ商品も非同期で削除される。他のデータソースからも供給される商品は残る）、ads_catalog_product_feed_delete_rule（フィードの変換ルール）、ads_catalog_event_source_disconnect（カタログとイベントソースのリンクの解除）。シグナルとデータセットのページ: ads_pixel_event_delete（イベントルール）、ads_pixel_parameter_delete（パラメータ）。A/Bテストのページ: ads_experiment_abtest_update_test は「Edit or cancel an existing A/B test」。キャンペーン・広告セット・広告そのものの削除ツールは、「広告の作成・管理」の28ツールにはない。
• 【CLI】campaign / adset / ad / creative / catalog の delete（確認プロンプトあり、各 delete コマンドの --force で省略）。子要素も削除される
• 【API】広告の一時停止・削除、広告セット単位の予算・請求・スケジュール設定

制限

• Marketing API のアクセス層: Limited（既定）とFull。Fullには直近15日で500回以上のMarketing API成功呼び出し、直近500回のエラー率15%未満が必要。システムユーザー数は Limited で一般1・管理者1、Full で一般10・管理者1
• スコア方式: 読み取り1点、書き込み3点。Limited 最大60点（減衰300秒・ブロック300秒）、Full 最大9,000点（減衰300秒・ブロック60秒）
• 作成・編集の上限は アプリ×広告アカウントで 100 リクエスト/秒
• 広告予算の変更: 広告セットごとに4回/時、広告アカウントの支出上限の変更は10回/日
• 広告作成はアカウントの1日の支出上限に応じて上限がある
• 標準アクセスは Business アプリが自動付与。他者のアカウントを扱うには高度なアクセス（App Review）が必要

認証・料金・日本語・実機検証

認証方式

MCP: Facebook Login for Business のOAuth（FacebookアカウントまたはMeta Managed Account）か、ユーザーアクセストークン（Bearer）。CLI: システムユーザーアクセストークン。API: OAuthの scope パラメータで権限を要求（例 scope=ads_management）。

公表されている料金（2026年10月16日確認）

未確認（API・MCP・CLIの利用料は公式ページに記載なし。広告配信の費用は広告予算として別途かかる） 料金ページ

日本語対応

未確認。Marketing API概要ページを locale=ja_JP で開いたところ英語のままだった。管理画面（広告マネージャ）の日本語は未確認。

Claude Code実機検証

未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）