Meta Ads MCP by Markifact

Meta Ads MCP Server

Claude、ChatGPT、Codex、Cursor、およびあらゆる MCP クライアント向けの Meta Ads MCP サーバーです。Meta Ads の操作を85種類提供します。即時実行される読み取り操作が40種類、承認を待ってから実行される書き込み操作が45種類あります。ホスト型で、OAuth ログインは1回だけ。ローカルへのインストールは不要です。

• セットアップガイド： markifact.com/meta-ads-mcp
• エンドポイント： https://api.markifact.com/mcp/meta-ads

これは、Markifact MCP server の Meta Ads エンドポイントです。Meta Ads を入口とする Markifact サーバーの全機能を利用でき、同じログインで、Meta や Google Analytics から Sheets、Slack まで、Markifact が接続する他のすべてのプラットフォームにもアクセスできます。Meta Ads だけを使う場合は、これをインストールしてください。

できること

• レポート。 キャンペーン、広告セット、広告のパフォーマンスを、配置、デバイス、年齢、性別、国、時間帯別に分析できます。アトリビューション期間、ROAS やフリークエンシーなどの計算指標、目標の達成結果にも対応しています。
• 変更。 Advantage+ の設定を含め、キャンペーン、広告セット、広告を作成・更新できます。メディアのアップロードを伴う、単一画像、動画、カルーセル、カタログ、Instagram 投稿のクリエイティブに対応しています。予算、入札、ステータス、スケジュール、ターゲティング、地域ごとの規制関連フィールドも設定できます。
• オーディエンスとアセット。 カスタム、類似、保存済みオーディエンス、リードフォーム、カタログと商品セット、メディアライブラリ、広告審査のフィードバック、広告アカウントにリンクされたページと Instagram アカウントを利用できます。
• 診断。 ピクセルと Conversions API の設定確認、非承認の理由、広告単位の審査フィードバック、競合調査用の Meta Ad Library に対応しています。

インストール

まずmarkifact.comでサインアップし（無料クレジット付き）、接続ページで Meta Ads を接続してから、クライアントにサーバーを追加してください。Meta Ads MCP セットアップガイドにも、スクリーンショット付きで同じ手順が掲載されています。

クライアント	手順
Claude（Web とデスクトップ）	Settings → Connectors → Add custom connector → URL https://api.markifact.com/mcp/meta-ads → Connect の順に進み、サインインします
Claude Code	claude mcp add --transport http meta-ads https://api.markifact.com/mcp/meta-ads を実行するか、claude plugin marketplace add markifact/markifact-mcp の後に /plugin install meta-ads@markifact を実行します
ChatGPT と Codex	Plugin Directory からMarkifact プラグインをインストールし、@Markifact を指定して呼び出します
Cursor	Settings → MCP → Add server → URL https://api.markifact.com/mcp/meta-ads の順に進みます（または、このリポジトリの mcp.json を ~/.cursor/mcp.json にコピーします）
Codex CLI	~/.codex/config.toml に [mcp_servers.meta_ads] を追加し、続けて url = "https://api.markifact.com/mcp/meta-ads" を追加します
Gemini CLI	gemini extensions install github.com/markifact/meta-ads-mcp を実行します
Windsurf	mcp.json のスニペットを MCP 設定に追加します
あらゆる MCP クライアント	https://api.markifact.com/mcp/meta-ads の Streamable HTTP に対応しています。OAuth 2.1 と PKCE を使用し、動的なクライアント登録も利用できます

クライアントごとの詳細は docs/clients.md をご覧ください。どのクライアントでも同じブラウザログインを行います。サーバーがチャット内で API キーやトークンを要求することはありません。

利用できるプロンプト

広告セット別の週次パフォーマンス

Pull Meta Ads performance by ad set for the last 7 days versus the previous 7. Include spend, impressions, CPM, CTR, results, cost per result and ROAS. Flag anything with cost per result up more than 25%. Do not make changes.

クリエイティブの疲弊

Which ads in the "Prospecting" campaign have frequency above 3 and CTR down more than 20% over the last 14 days? List them with spend and results.

配置の内訳

Break down last month's spend and results by placement for the whole account. Which placements have the worst cost per result?

一時停止状態でキャンペーンを開始

Create a Meta Advantage+ sales campaign for our Black Friday creative. Budget $200 a day, target US, use the uploaded video, and leave it paused so I can review it before it goes live.

プレビューしてから一時停止

List active ad sets with cost per result above $80 over the last 14 days, then pause them. Show me the list and wait for my approval before pausing anything.

アカウント、期間、指標を指定し、書き込み操作の前に読み取りを行うよう依頼してください。また、変更を許可するかどうかも明示してください。

書き込みの仕組み

すべての書き込み操作には承認が必要です。クライアントが変更を依頼すると、サーバーが変更内容を準備し、対象（アカウント、キャンペーン ID、現在の値、変更後の値）を正確に表示します。確認するまで、何も実行されません。読み取りには確認は不要です。サーバーがアクセスできるのは、認証済みの Meta Ads ログインで閲覧できるアカウントに限られます。

操作（85）

Markifact の操作レジストリから生成されています。

操作	内容	種類
meta_ads_check_catalog_diagnostics	Meta カタログのデータ品質、ポリシー、フィードに関する問題を確認し、重大度と影響を受ける項目を含む診断上の問題グループを集約して返します…	読み取り
meta_ads_create_ad_creative	生のクリエイティブペイロードから Meta 広告クリエイティブを作成し、新しい creative_id を返します。	書き込み、承認が必要
meta_ads_create_ad_from_creative	既存の広告クリエイティブ ID から新しい Meta 広告を作成します。	書き込み、承認が必要
meta_ads_create_ad_from_post	既存の Facebook ページ投稿または Instagram メディアから Meta 広告を作成します（メディアのアップロードやコピーの作成は行いません）。	書き込み、承認が必要
meta_ads_create_adset	予算、ターゲティング、最適化、宣伝対象オブジェクトの設定を含む、新しい Meta Ads 広告セットを作成します。	書き込み、承認が必要
meta_ads_create_campaign	目的、予算、ターゲティング、スケジュールなどの設定をカスタマイズできる、新しい Meta Ads キャンペーンを作成します。	書き込み、承認が必要
meta_ads_create_carousel_ad	画像または動画を含む 2～10 枚のカードで、新しい Meta カルーセル広告を作成します（一括モードのみ）。	書き込み、承認が必要
meta_ads_create_catalog_ad	商品セットを使用して、Advantage+ カタログ広告／ダイナミック広告（カルーセルまたは単一画像）を作成します（一括モード）。	書き込み、承認が必要
meta_ads_create_experiment	インスタントフォームを含む、既存のキャンペーン／広告セットのバリエーションを使用して、Meta 標準の A/B テストまたは広告調査を作成します。	書き込み、承認が必要
meta_ads_create_flexible_ad	複数のメディア（最大 10 件）とテキストのバリエーション（それぞれ最大 5 件）を含むフレキシブル広告を作成します。	書き込み、承認が必要
meta_ads_create_product_set	生の Meta フィルターをそのまま Meta に渡し、カタログ内に Meta 商品セットを作成する低レベルツールです。	書き込み、承認が必要
meta_ads_create_single_image_ad	単一画像のクリエイティブアセットを使用して、新しい Meta 広告を作成します。	書き込み、承認が必要
meta_ads_create_single_video_ad	単一動画のクリエイティブアセットを使用して、新しい Meta 広告を作成します。	書き込み、承認が必要
meta_ads_delete_product_set	Meta カタログから Meta 商品セットを完全に削除します。	書き込み、承認が必要
meta_ads_duplicate_ad	既存の Meta 広告のコピーを作成します。クリエイティブの強化設定を指定でき、コピーを別の広告セットに移動することもできます。	書き込み、承認が必要
meta_ads_duplicate_adset	既存の広告セットを複製して新しい Meta Ads 広告セットを作成します。関連する広告をコピーするか、別のキャンペーンに移動するかを選択できます。	書き込み、承認が必要
meta_ads_duplicate_campaign	既存のキャンペーンを複製して新しい Meta Ads キャンペーンを作成します。関連する広告セットと広告をコピーするかどうかを選択できます。	書き込み、承認が必要
meta_ads_generate_ad_previews	INSTAGRAM_FEED、FACEBOOK_FEED など、選択した配置向けに Meta 広告キャンペーンと広告クリエイティブのプレビュー iframe URL を生成します…	読み取り
meta_ads_get_account_details	ステータス、タイムゾーン、通貨、ビジネス情報、支出上限、設定など、Meta Ads のアカウント情報を詳しく取得します。	読み取り
meta_ads_get_account_history	Meta 広告アカウントの過去のアクティビティと変更を取得します	読み取り
meta_ads_get_ad	ID で Meta 広告を 1 件取得します。ステータス、審査フィードバック（ポリシーおよび配置ごとの却下理由）、配信上の問題などを含みます…	読み取り
meta_ads_get_ad_creative	ad_id または creative_id で Meta 広告クリエイティブを取得し、生のクリエイティブペイロードを返します。	読み取り
meta_ads_get_adset_settings	予算、ターゲティング、最適化、入札戦略、広告セットレベルのすべての設定など、Meta Ads の広告セット設定と構成を取得します…	読み取り
meta_ads_get_campaign_settings	予算、ステータス、目的、入札戦略、キャンペーンレベルのすべての設定など、Meta Ads のキャンペーン設定と構成を取得します…	読み取り
meta_ads_get_experiment	Meta 標準の A/B テストまたは広告調査、そのテストセル、利用可能な測定結果を読み取ります。	読み取り
meta_ads_get_media_details	image_hash または video_id を使用して、画像と動画の Meta メディア詳細を取得します。	読み取り
meta_ads_get_product_details	小売業者 ID（SKU）または Meta 商品 ID で、単一の Meta カタログ商品について、審査ステータスや却下理由などの詳細をすべて取得します。	読み取り
meta_ads_get_report	カスタマイズ可能な指標、ディメンション、フィルター、日付範囲、並べ替えオプション、組み込みの機能を使用して、Meta Ads（Facebook／Instagram）のデータを取得します…	読み取り
meta_ads_library	競合の調査を目的に、Meta の広告ライブラリから広告を検索、取得します	読み取り
meta_ads_list_account_block_lists	Meta Ads アカウントのパブリッシャーブロックリストを、適用済みリストのフィルターオプションとともに取得します	読み取り
meta_ads_list_ads	Meta 広告アカウントの広告を一覧表示します。特定の広告セットまたはキャンペーンの広告のみを対象にでき、停止中を含むすべてのステータスの広告とクリエイティブを取得できます…	読み取り
meta_ads_list_adsets	広告アカウント内のすべての広告セットを、ステータスと日付とともに一覧表示します	読み取り
meta_ads_list_campaigns	広告アカウント内のすべてのキャンペーンを、ステータスと日付とともに一覧表示します	読み取り
meta_ads_list_catalogs	接続ユーザーがアクセスできる Meta カタログを一覧表示します。	読み取り
meta_ads_list_experiments	ビジネスポートフォリオが所有する Meta 標準の A/B テスト、スプリットテスト、広告調査を一覧表示します。	読み取り
meta_ads_list_instagram_accounts	Meta Ads 接続に含まれる Facebook ページにリンクされた Instagram アカウントを、それぞれがリンクされているページとともに一覧表示します。	読み取り
meta_ads_list_instagram_media	Meta Ads 接続上の Instagram アカウントの投稿（リール、フィード投稿、ストーリーズ）を、パーマリンク、ショートコード、メディア ID とともに一覧表示します…	読み取り
meta_ads_list_media	Meta 広告アカウントのメディアライブラリ（動画と画像）を一覧表示します。名前／ファイル名による検索を Meta 側で適用することもできます。	読み取り
meta_ads_list_pages	Meta Ads 接続で利用できる Facebook ページを ID とともに一覧表示します。	読み取り
meta_ads_list_product_sets	Meta カタログ内の商品セットを、フィルターと商品数とともに一覧表示します。	読み取り
meta_ads_list_products	Meta カタログ内の商品を一覧表示または検索します。生の Meta フィルターを指定することもできます。	読み取り
meta_ads_list_report_fields	レポートを実行する前に、利用可能な Meta Ads のレポート指標とディメンションを検索、参照します。	読み取り
meta_ads_rename_ad	表示名を更新するために Meta Ads 広告の名前を変更します	書き込み、承認が必要
meta_ads_rename_adset	表示名を更新するために Meta Ads 広告セットの名前を変更します	書き込み、承認が必要
meta_ads_rename_campaign	表示名を更新するために Meta Ads キャンペーンの名前を変更します	書き込み、承認が必要
meta_ads_replace_ad_creative	既存のクリエイティブ（creative_id で指定）を既存の広告（ad_id で指定）に適用し、以前に適用されていたクリエイティブと置き換えます。	書き込み、承認が必要
meta_ads_search_targeting	Meta Ads のターゲティングオプションを検索します。地域（国、都市、地域、郵便番号）、ロケール（言語）、興味関心、学歴などを対象とします…	読み取り
meta_ads_select_accounts	Meta Ads アカウントを一度選択し、複数の meta_ads_get_report ノードで再利用します。アカウントを選び直す必要はありません。	読み取り
meta_ads_update_ad	広告名の変更や変更など、広告レベルの高度なケースや未対応のケースに使用する、Meta Ads 広告のフォールバックパッチツールです…	書き込み、承認が必要
meta_ads_update_ad_status	広告管理のために、Meta Ads 広告のステータス（active、paused、deleted）を更新します	書き込み、承認が必要
meta_ads_update_adset	高度なケースや未対応のケースに使用する、Meta Ads 広告セットのフォールバックパッチツールです。	書き込み、承認が必要
meta_ads_update_adset_audiences	Meta Ads 広告セットのオーディエンスターゲティングを更新します。カスタムオーディエンス、類似オーディエンス、興味関心、行動、学歴、職業、収入などを対象とします…	書き込み、承認が必要
meta_ads_update_adset_bid_value	Meta Ads 広告セットの入札額（Bid Cap／Cost Cap）または最小 ROAS を更新します。	書き込み、承認が必要
meta_ads_update_adset_budget	予算管理のために、Meta Ads 広告セットの予算（日予算または通算予算）を更新します。	書き込み、承認が必要
meta_ads_update_adset_language	Meta Ads 広告セットの言語ターゲティング（ロケール）を更新します。	書き込み、承認が必要
meta_ads_update_adset_locations	Meta Ads 広告セットの地域ターゲティングを設定または除外します。	書き込み、承認が必要
meta_ads_update_adset_placements	Meta Ads 広告セットの配置ターゲティングを更新します。	書き込み、承認が必要
meta_ads_update_adset_schedule	Meta Ads 広告セットの start_time および／または end_time（スケジュール）を更新します。	書き込み、承認が必要
meta_ads_update_adset_status	広告セット管理のために、Meta Ads 広告セットのステータス（active、paused、deleted）を更新します	書き込み、承認が必要
meta_ads_update_campaign	支出上限、特別な広告カテゴリ、宣伝対象オブジェクト、広告ごとの設定など、高度なケースや未対応のケースに使用する、Meta Ads キャンペーンのフォールバックパッチツールです…	書き込み、承認が必要
meta_ads_update_campaign_bidding_strategy	Meta Ads キャンペーンの入札戦略を更新します。	書き込み、承認が必要
meta_ads_update_campaign_budget	予算管理のために、Meta Ads キャンペーンの予算（日予算または通算予算）を更新します。	書き込み、承認が必要
meta_ads_update_campaign_status	キャンペーン管理のために、Meta Ads キャンペーンのステータス（active、paused、deleted）を更新します	書き込み、承認が必要
meta_ads_update_experiment	名前、スケジュール、テストセル、目的など、Meta の更新パラメーターを使用して、Meta 標準の A/B テストまたは広告調査を更新します。	書き込み、承認が必要
meta_ads_update_product_set	Meta 商品セットの名前、生の Meta フィルター、またはその両方を更新します。	書き込み、承認が必要
meta_ads_update_products	生の Meta items_batch リクエストをそのまま送信して、カタログ商品を作成、更新、削除する低レベルの一括ツールです。	書き込み、承認が必要
meta_ads_upload_media	Meta 広告アカウントに画像または動画を 1 件アップロードし、そのメディア参照（画像の場合は image_hash、動画の場合は video_id と自動生成された…）を返します	書き込み、承認が必要
meta_check_capi_health	Meta Ads ピクセルの Conversions API（CAPI）健全性指標を確認します。イベントマッチクオリティ、サーバーサイドトラッキング、カバレッジなどを対象とします…	読み取り
meta_create_custom_audience	Meta 広告アカウントにカスタムオーディエンスを作成します。	書き込み、承認が必要
meta_create_custom_conversion	ピクセルイベントまたは URL に対するルール（例：）で定義される Meta カスタムコンバージョンを広告アカウントに作成します	書き込み、承認が必要
meta_create_lead_form	リード獲得広告キャンペーン用に、連絡先フィールドやカスタムの適格性確認用質問などを含む Meta インスタントフォーム（リード獲得フォーム）を Facebook ページに作成します…	書き込み、承認が必要
meta_create_lookalike_audience	既存のソースカスタムオーディエンスから Meta 類似オーディエンスを作成します。	書き込み、承認が必要
meta_get_custom_audience	ID で単一の Meta カスタムオーディエンスまたは類似オーディエンスを取得し、ウェブサイトやエンゲージメントのルール、類似オーディエンスの仕様など、定義全体を返します…	読み取り
meta_get_lead_form	単一の Meta インスタントフォーム（リード獲得フォーム）の質問、イントロカード、サンクスページ、プライバシーポリシーなどの構成全体を取得します…	読み取り
meta_get_pixel_details	特定の Meta Ads トラッキングピクセルの構成などの詳細を取得します	読み取り
meta_get_pixel_stats	各種集計タイプと任意の日付フィルターを指定して、Meta Ads ピクセルの統計情報を取得します	読み取り
meta_list_account_pixels	Meta Ads アカウントに接続されたすべてのピクセルを、トラッキングと構成の詳細とともに一覧表示します	読み取り
meta_list_custom_audiences	Meta Ads アカウントのカスタムオーディエンスと類似オーディエンスを一覧表示します。	読み取り
meta_list_custom_conversions	Meta Ads アカウントに設定されたすべてのカスタムコンバージョンを一覧表示します。	読み取り
meta_list_lead_forms	Facebook ページのすべてのリード獲得フォームを一覧表示します	読み取り
meta_list_promotable_apps	Meta Ads アカウントで宣伝できるアプリを一覧表示します（ID、名前、プラットフォーム、ストア URL、アプリイベント）。	読み取り
meta_list_saved_audiences	Meta Ads アカウントの保存済みオーディエンス（再利用可能なターゲティングプリセット）を、ターゲティング仕様全体や読み取り可能なターゲティング情報とともに一覧表示します…	読み取り
meta_retrieve_leads	Meta Ads（Facebook および Instagram）のリード獲得キャンペーンからリードフォームの送信内容を取得します	読み取り
meta_update_custom_audience	Meta カスタムオーディエンスを更新します（名前、説明、ウェブサイトルール、保持期間、オプトアウトリンク、顧客ファイルのソース、類似オーディエンスの仕様など…）	書き込み、承認が必要
meta_update_lead_form_status	Meta インスタントフォーム（リード獲得フォーム）のステータス（ACTIVE、ARCHIVED、DELETED、DRAFT）を更新します。	書き込み、承認が必要
このサーバーは10個のMCPツールを公開します。find_operationsはこの一覧を検索し、get_operation_inputsは正確な入力スキーマを返し、run_operationは読み取りを実行し、run_write_operationは承認が必要な書き込みを実行します。残りのツールは接続、ファイル、メディアのアップロードを処理します。アーキテクチャに関する説明はメインリポジトリをご覧ください。

関連情報

• Meta Ads MCP セットアップガイド
• 公式 Meta Ads MCP と代替ツールの比較
• Meta Ads を Claude に接続する
• Meta Ads を ChatGPT に接続する
• Claude Code で Meta Ads MCP を使う
• Codex で Meta Ads MCP を使う

よくある質問

Meta 開発者アプリやシステムユーザートークンは必要ですか？

いいえ。Markifact は Meta の認定テクノロジープロバイダーであり、サーバーは Markifact のインフラストラクチャ上で動作します。広告アカウントへのアクセス権をすでに持つ Facebook ログインを認証すれば、サーバーがアクセスできるのは、そのログインで閲覧できる範囲に限られます。

クリエイティブをアップロードできますか？

はい。クライアントから画像や動画をアップロードすると、サーバーが新規または既存の広告に追加します。カタログや Instagram 投稿のクリエイティブにも対応しています。

キャンペーンを変更できますか？

はい。すべての変更内容はプレビューされ、チャットでの承認を待ってから実行されます。読み取りはすぐに実行されます。確認なしに書き込みが行われることはありません。

どの AI クライアントが使えますか？

OAuth に対応した MCP クライアントならどれでも使えます。Claude（ウェブ、デスクトップ、Code）、ChatGPT、Codex、Cursor、Windsurf、Gemini CLI などに対応しています。それぞれのインストール手順は上記をご覧ください。

料金はいくらですか？

サーバーは無料でインストールできます。Markifact アカウントが必要ですが、無料クレジットから利用を開始できます。プランについては料金ページをご覧ください。

サポートとポリシー

[email protected]にメールでお問い合わせいただくか、Issue を作成してください。SECURITY.md、PRIVACY.md、TERMS.mdをご覧ください。MIT ライセンスのもとで公開されています。