Meta広告 MCPのつなぎ方と使えないときの見分け方｜実測95本のツールで踏んだ実装の罠【2026年】

Meta広告のMCPが使えないとき、僕がまず見るのは ads_get_ad_accounts が返す is_ads_mcp_enabled です。2026年8月21日に測り直したときも、僕の会社の主力の広告アカウントは false のままで、申請して直せるものでもありませんでした。

この記事では、Meta広告のMCPでできること、使えるアカウントの見分け方、つないだ後に踏んだ実装の罠を順に書きます。「つないだのに動かないのは、自分の設定のせい？」と迷っている方は、最初の章で切り分けられます。

Meta広告 MCPでできることと、使えないときの3つの原因

Meta広告のMCPは、Metaが用意したサーバーを通して、AIが広告の実績の取得や設定の変更を行える窓口です。使えない原因は、アカウントが対象外・ツールが未提供・セッションに載っていない、の3つが多いです。

Metaは2026年4月29日に、MCPと広告用のCLIをオープンベータとして発表しました。発表と開発者ドキュメントに、料金の記載は見当たりません（2026年11月4日に確認）。

接続先は https://mcp.facebook.com/ads です。開発者ドキュメントでは、実績のレポート、キャンペーンの作成と編集、カタログ、計測の状態、変更履歴などをツールとして扱えると説明されています。

2026年7月16日の更新では、ビジネスポートフォリオの管理者が、AIに許す操作の範囲を決めるルールの機能が加わりました。予算の変更からカタログの更新までが対象です。

原因1：広告アカウントがまだ提供の対象外

いちばん多いのは、つないだ広告アカウントがまだ対象になっていないケースです。そのアカウントで実績を取ろうとすると、次の文が返ってきます。

Ads MCP is gradually being rolled out. Please check back at a later date to use Ads MCP with this Ad Account.

ここでいう is_ads_mcp_enabled とは、広告アカウントの一覧を取るツールが、アカウントごとに返す「MCPを使えるか」の印です。

この印は、Business Suiteのルール画面が開けるかどうかとは一致しませんでした。そのため僕の会社では、使えるかの判定をこの値だけで決めています。

原因2：アカウントは対象でも、ツールごとに未提供

is_ads_mcp_enabled が true でも、すべてのツールが使えるとは限りません。変更履歴のツールや画像を上げるツールは、別の枠で順番に開放されていました。

その場合は This tool is new and is being gradually rolled out で始まる文が返ります。アカウントの印と、ツールごとの提供は分けて確かめる必要があります。

原因3：MCPを足したセッションにツールが載っていない

僕の会社では、Claude Codeの起動後にMCPを追加したところ、そのセッションにはMeta広告のツールが出てきませんでした。起動し直すと出るようになります。

Claude Codeの公式ドキュメントには、追加後に起動し直す必要があるかの記載は見当たりませんでした（2026年11月4日に確認）。これは僕の会社で起きたこととして読んでください。

3つのうち、自分で直せるのは3つ目だけです。僕なら、まず起動し直してから印を見て、false なら設定を疑わずに開放を待ちます。

Meta広告のMCPをつないで、使えるアカウントを確かめる手順

つなぐ作業はコマンド1行と認可の画面で終わります。時間をかけるべきなのは、どのアカウントで何が使えるかの確認です。

1. Claude Codeに登録する。公式の開始ガイドには claude mcp add --transport http --client-id <META_APP_ID> meta-ads https://mcp.facebook.com/ads が載っています
2. Claude Codeを起動し直し、/mcp から認可に進んで、Metaの画面で許可する
3. 権限は、最低限 ads_mcp_management と、ads_read か ads_management のどちらかが要る
4. ads_get_ad_accounts を呼び、アカウントごとの is_ads_mcp_enabled を一覧にする
5. true のアカウントで、使いたいツールを1回ずつ呼び、文で返る未提供の知らせが無いかを確かめる
6. Business Suiteの「設定＞統合＞広告MCPサーバー」で、AIに許す操作を絞る

公式の開始ガイドは、Metaの開発者アプリのIDを渡す形です。同じガイドには、アプリを持っていなくても使え、その場合は別のヘルプの手順に従うとも書かれています。

僕の会社が2026年8月20日につないだときは、アプリIDを渡さない1行で登録でき、Meta側でアプリも作りませんでした。手順の形が変わっている可能性があるので、つなぐ前に開始ガイドを見直してください。

--scope user を付けると、設定は ~/.claude.json に入り、すべてのプロジェクトで使えると公式ドキュメントにあります。僕の会社はこの形で、社内ノートのリポジトリに設定が入らないようにしています。

権限を操作ごとに絞る話はMCPとは（実際につないだ11の接続先）に書きました。この記事は、つないだ後の話に絞ります。

裏方で実際に起きた例：ツール95本と、黙って違う数字を返す罠

僕の会社では、2026年8月20日に認可した日のうちに、検証用の広告アカウントでツールを片端から呼んで仕様を確かめました。一覧を取るとツールは95本あり、当時の公式ドキュメントで数えた約29本を大きく上回っていました。

確かめた結果は社内の実装メモにまとめ、罠を4段階で75項目に分けています。いちばん重い段は「エラーにならず、違う数字を返す」もので、16項目ありました。

取得の時間が縮んだ話はインスタ広告の費用の記事に書きました。ここでは、その裏で手間がかかった点を並べます。

表の中で一番こわいのは、最後の期間の指定ミスです。僕なら、どの道具で呼ぶにしても、期間と内訳の値だけは自分の側で検査してから投げます。

不正な項目名を投げると、使える項目の一覧が返ってくる

fields に存在しない項目を入れると、エラーの中に、そのレベルで使える項目の全一覧が入って返ってきました。僕の会社では、これを実質の仕様書として扱っています。

社内で集めた項目の定義は101本です。レベルごとに使える項目が違い、たとえば広告のレベルでは配信の開始日時が取れず、共通の項目一覧を全レベルに使い回すと落ちました。

spend については、最初の実測では無効と返りました。一方、項目の定義を確かめるツールでは amount_spent の別名として扱われる場面もあり、扱いがそろっていません。迷わないよう、僕の会社では正式名で書いています。

breakdowns は「1回1つ」と書かれているが、2つは通った

ツールの説明には、内訳（年齢や性別など）は1回に1つだけと書かれています。実測では年齢と性別の2つを渡すと10行に分かれて返り、3つ渡すとHTTP 500で落ちました。

2つで動くのは説明と違う動きです。僕の会社では本番を1軸に固定し、2軸が要るときは2回に分けて取ってから掛け合わせています。

エラーが「普通の返事」の形で返ってくる

もう1つ実際に落ちたのが、エラーの返り方です。ここでいう文で返るエラーとは、失敗なのに例外にならず、普通の結果と同じ形で英語の文だけが届くものです。

対象外のアカウントや未提供のツール、不正な内訳の名前を渡したときがこの形でした。結果を表として読もうとした処理が、文を受け取って止まりました。

ほかにも、データが0の期間は数字の項目が行から丸ごと消え、0とも空とも返りませんでした。分析系のツールは全期間を maximum ではなく lifetime で指定し、不正な値でもエラーにならず空を返します。

2026年8月21日：主力は使えず、画像を上げるツールも未提供

翌日の2026年8月21日に測り直すと、主力のアカウントは is_queryable が true でも is_ads_mcp_enabled は false でした。実績を取るツールは拒否されています。

MCPが使えるアカウントでも、画像を上げる ads_creative_upload_image 自体がまだ提供されていませんでした。この時点で、広告の入稿はブラウザの自動操作のまま続けると決めました。

申請の手段は見つからず、待つしかありません。そこで僕の会社では、毎朝 ads_get_ad_accounts を自動で呼び、印が true に変わったら気づける仕組みを動かしています。

再発防止：全部の呼び出しを1つの入口に通す

罠の多くは、呼び出しを1つの入口にまとめると構造的に防げます。僕の会社では、Meta広告のMCPを業務の処理から直接呼ばない決まりにしました。

入口でやっていることは4つです。返事が文なら例外に変える、期間と内訳の値を一覧で検査する、20文字のIDを付ける、数字の文字列を数値に直す、の4つです。

1. 返事が文で届いたら、その場で失敗として止める
2. date_preset と breakdowns は、有効な値の一覧にあるものだけ通す
3. date_preset と time_range は同時に渡さない（併用すると time_range が黙って優先された）
4. 項目が無い行は0として扱い、日別のデータは欠けた日を自分で0で埋める
5. MCPを足したら、Claude Codeを起動し直してから使う

数字の確からしさは、つないだ直後に信じ切らないことで守っています。導入から1か月は、MCPの値と広告マネージャのCSVを並べて照合し、合うと確かめるまで報告の元データはCSVにすると決めました。

業務で使うときの注意：IGの名義・下書き・画像はMCPだけでは足りない

Meta広告のMCPは、実績を読む用途では強い一方で、入稿の前の確認や誤公開の検知はまだ画面に頼る部分が残ります。任せる範囲を先に決めておくのが安全です。

まず権限です。僕の会社が確かめたとき、つないだ直後はAIに許す8つの操作がすべて許可の状態でした。ルールを決めるには、そのポートフォリオの管理者権限が要ります。

クライアントが持つポートフォリオで自社が管理者でない場合は、ルールを設定できません。その場合は、つなぐのを見送るか、先方の管理者に設定を頼むことにしています。

次に名義です。Facebookページの名義は、広告のクリエイティブから機械で判定できました。Instagram側の名義に当たる項目はMCPでは取れず、最後はプレビューを画面で開いて人が見ています。

ほかに、作りかけの下書きのキャンペーンはMCPの一覧に出てきませんでした。誤って公開していないかの確認は、管理画面で見るしかありません。

画像を上げるツールは、手元のファイルを送る形ではなく、公開URLをMetaに読み込ませる形です。広告ライブラリの検索も、直近の50本までで、ページ送りや期間の指定はできませんでした。

ファイルの受け渡しでMCPがつまずくのは、Meta広告に限りません。Google Drive では、50KBを超えるPDFをMCPで置けなかった話をGoogle Drive MCPでファイルを置くときの罠に書きました。

最後に安全面です。外から来た文章を読み込む作業をしているセッションでは、Meta広告のMCPを使いません。作成系の操作をルールでブロックしておけば、意図しない変更の入口を減らせます。

まとめ

• Meta広告のMCPが使えるかは広告アカウントごとに違い、判定は ads_get_ad_accounts の is_ads_mcp_enabled で見る。管理画面の見え方では判断できない
• 印が true でも、変更履歴や画像を上げるツールは別の枠で順番に開放される。使いたいツールは1回ずつ呼んで確かめる
• 2026年8月20日の実測でツールは95本。fields 必須・内訳は1回1軸・20文字のIDが必須・数字は文字列で返る、などの罠を75項目記録した
• Instagramの名義と下書きのキャンペーンはMCPでは見えない。そこは画面での確認を残す
• 僕なら最初に、Claude Codeを起動し直してから印の一覧を取り、使えるアカウントで読み取りだけを試すところから始めます