Ads Uploader — Meta Ads MCP

Ads Uploader — Meta Ads MCP

Ads Uploader のMeta Ads MCPサーバーを使うと、Claude、ChatGPT、Cursor、Codex から Meta（Facebook と Instagram）の広告を配信し、管理できます。

---

Ads Uploader は、すでに配信している既存の広告をもとに、その設定を再利用可能なテンプレートに変換し、新しいメディア、コピー、CTA、ターゲティングを組み合わせて、大量の新しい広告を作成します。また、ソーシャルプルーフを維持したまま、既存の広告を投稿単位で複製することもできます。AI エージェントを接続し、作成したい広告を説明してください。

エージェント支援型と完全エージェント型。 エージェント支援型で広告を配信する場合、広告をヘッドレスで作成するのではなく、エージェントに保存済みのビルドを作成させることをおすすめします。ビルドは Ads Uploader のウェブアプリから確認、編集、配信できるため、洗練された UI で人が確認してから配信する手順を維持できます。

MCP にアクセスできる Ads Uploader の有料アカウントと、必要な権限を持つ接続済みの Meta アカウントが必要です。トライアルには MCP アクセスは含まれません。

このリポジトリには、公開ドキュメントとコネクター設定が含まれています。Ads Uploader はプロプライエタリ製品です。アプリケーション、バックエンド、MCP サーバーの実装は含まれていません。再利用許可の範囲については、ライセンスをご覧ください。

できること

• テンプレートから広告を作成 — 既存の広告から設定をコピーし、新しいメディア、テキスト、CTA、リンク、ターゲティングに差し替えます。
• 一括作成 — 1 回のジョブで複数のキャンペーンや広告セットにまたがる多数の広告を作成でき、広告ごとにテキストやクリエイティブのオプションを指定できます。
• 投稿単位で複製 — ページ投稿 ID を指定して既存の広告を複製することで、元の投稿の「いいね！」、コメント、シェアを新しいキャンペーンに引き継げます。
• パートナーシップ広告（ブランドコンテンツ広告） — 自身がアップロードしたメディアやインポートした Instagram 投稿を使って、クリエイターやブランドとのパートナーシップ広告を配信できます。スポンサーは共通または広告・広告セットごとに設定できます。（以下をご覧ください。）
• メディアパイプライン — 公開 URL、Google Drive フォルダー、またはローカルファイルからクリエイティブをインポートできます。
• 配信前のプレビュー — 仕様を解決し、Meta の権限を確認して、作成される内容を正確に確認できます。
• 複数アカウント対応 — アクセス権のあるすべての Meta 広告アカウント、ページ、接続済み Instagram アカウントを一覧表示し、操作できます。

Ads Uploader を選ぶ理由

Meta 広告の現場で10年間培った経験を基に、Ads Uploader は、エージェントに利用可能な中で最も深く、最も包括的な Meta（Facebook と Instagram）の広告作成ワークフローを提供します。キャンペーンを最初から最後まで実際に公開するために必要なすべてがそろっています。

• 公開中のあらゆる広告をテンプレート化 — 実績のある広告の設定をそのままコピーし、新しいメディア、テキスト、ターゲティングを使って再構築できます。
• 本格的な一括作成 — 1回のジョブでキャンペーンや広告セットをまたいで多数の広告を作成でき、広告ごと、広告セットごとにテキストを指定できます。
• パートナーシップ広告／ブランドコンテンツ広告 — メディアをアップロードして作成するパートナーシップ広告（Facebook と Instagram）や、インポートした Instagram クリエイター投稿に対応し、スポンサーやヘッダーモードを共有または広告／広告セットごとに設定できます。
• ソーシャルプルーフを維持した複製 — 投稿を基に複製し、いいね、コメント、シェアを新しいキャンペーンに引き継げます。
• クリエイティブの充実した機能 — カルーセル、フレキシブル、Multi-Media、Dynamic Optimization、クリエイティブの拡張機能、Advantage+ ターゲティング、CTA、URL タグ付けに対応しています。
• 人間が関与する設計 — 検証のみのプレビューや、ウェブアプリで仕上げられる保存済みビルドを利用できます。

Meta 広告を大規模に運用するチームが開発し、大規模な Meta 広告予算を管理するパフォーマンスマーケターや代理店から信頼されています。

インストール

Claude Code

claude mcp add --transport http ads-uploader https://adsuploader.com/api/mcp

Claude desktop / Claude.ai

設定 → コネクター → カスタムコネクターを追加 → URL を貼り付け、ブラウザーでサインインと同意を完了します。

https://adsuploader.com/api/mcp

ChatGPT

設定 → コネクター（カスタム MCP）→ サーバー URL https://adsuploader.com/api/mcp を追加 → プロンプトが表示されたらサインインします。

Cursor

Ads Uploader を Cursor に追加

このリポジトリには、Agent Plugins の plugin.json と mcp.json に加えて、ディレクトリ検索用の互換ファイル .mcp.json が含まれています。プラグインはホスト型サーバーに接続し、認証はブラウザーで行います。

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp"
    }
  }
}

サーバーを追加したら、Ads Uploader のサインインと同意のプロンプトを完了します。エージェントに広告アカウントの一覧表示を依頼し、接続を確認してください。

Grok

Grok Connectors を開き、New Connector → Custom を選択して、https://adsuploader.com/api/mcp を入力します。認証プロンプトに従ってください。前提条件とプロンプト例については、Grok 接続ガイドをご覧ください。このホスト接続は、エンドツーエンドのテスト待ちです。

Codex

~/.codex/config.toml に追加します。

[mcp_servers.ads-uploader]
command = "npx"
args = ["mcp-remote", "https://adsuploader.com/api/mcp"]

ローカル stdio パッケージ

ディスクから直接ファイルをアップロードする必要があるホスト向けです。Node.js 18 以降が必要です。

npm install -g @adsuploader/cli @adsuploader/mcp
ads login

{
  "mcpServers": {
    "ads-uploader": {
      "command": "ads-mcp"
    }
  }
}

ホスト型サーバーはブラウザーでの OAuth 認証を使用するため、トークンをコピーする必要はありません。ローカルパッケージは、ads login で保存された認証情報を読み込みます。接続を確認するには、エージェントに 「広告アカウントを一覧表示して」 と依頼してください。

ツール

各ツールには表示タイトルと読み取り専用／破壊的操作のヒントが付いているため、ホストは適切なガードレールを表示できます。

アカウントと検索（読み取り専用）

ツール	機能
ads_whoami	このセッションで認証されている Ads Uploader ユーザーを表示します
ads_list_accounts	利用可能な Meta 広告アカウントを一覧表示します
ads_list_campaigns	広告アカウント内のキャンペーンを一覧表示します（名前／ステータスで絞り込み）
ads_list_adsets	キャンペーン内の広告セットを一覧表示します
ads_list_ads	広告セット内の広告を一覧表示します
ads_get_ad	クリエイティブの詳細を含む広告を1件取得します
ads_list_pages	Facebook ページと、それらに接続されている Instagram アカウントを一覧表示します
ads_search_targeting	ビルド用の Meta ターゲティング値を検索します

プリセットと保存済みビルド

ツール	機能
ads_list_presets / ads_get_preset	保存済みの API プリセットと広告テキストプリセットを確認します
ads_save_preset	既存の広告を再利用可能なプリセットとして保存します
ads_list_builds / ads_get_build	保存済みのアップローダービルドを確認します
ads_save_build / ads_update_build	永続的な保存済みビルドを作成または編集します
ads_fork_build	保存済みビルドを新しい下書きとして複製します
ads_delete_build	保存済みビルドを削除します

メディア

ツール	機能
ads_upload	URL、Google Drive フォルダー、またはディスクからメディアをアップロードします
ads_upload_finalize	署名済みアップロードバッチを確定します
ads_list_uploads / ads_get_upload	バッチを一覧表示するか、取り込みジョブの状態を確認します

作成と複製

ツール	機能
ads_create	完全な AdSpec または保存済みビルドから広告を作成します（パートナーシップ広告を含む）
ads_preview	スペックを解決し、Meta の権限とパートナーシップのスポンサーを確認します。広告は作成しません
ads_duplicate_by_post	ページ投稿 ID で広告を複製し、ソーシャルプルーフを維持します
ads_duplicate_by_post_preview	投稿 ID による複製をプレビューします
ads_get_job / ads_get_duplication	実行中のジョブの状態を確認するか、再開します
ads_cancel_job	作成ジョブまたは取り込みジョブをキャンセルします

エージェントが従うべきパラメーターごとの詳細は、SKILL.md を参照してください。

パートナーシップ（ブランドコンテンツ）広告

ads_create と ads_preview では、次の2つの方法でパートナーシップ広告を利用できます。

• アップロードした自社メディアを使い、Facebook または Instagram でパートナーシップ広告を作成します。ページおよび／または Instagram アカウントからパートナー（セカンドアイデンティティ）を選び、キャンペーン全体または広告／広告セットごとに適用して、ヘッダーモード（両方のアイデンティティ、パートナーのみ、または動的）を選択します。Instagram のみのパートナーにも対応しています。
• URL、ショートコード、ソース ID、または広告コードを使って、既存の Instagram クリエイター投稿をインポートし、スポンサーとテキストを広告ごと、広告セットごと、または共通で設定します。

プレビューでは広告ごとの有効なスポンサーが報告され、作成前にファーストアイデンティティのパートナーシップ権限が確認されます。Facebook 投稿のインポート、投稿とアップロードを混在させたバッチ、およびインポートした投稿での Threads には対応していません。

プロンプトの例

• 「Sales 広告セットの広告をテンプレートとして使い、これらのクリエイティブ100件を配信してください。それぞれに固有の見出しとメインテキストも作成してください。」
• 「最も成果の高い販売広告を使い、メインテキストのフックを変えたバリエーションを20件作成して、新しい広告セットですべて一時停止状態にしてください。」
• 「これらのクリエイティブとコピーから保存済みビルドを作成し、Ads Uploader ウェブアプリで確認して配信するためのリンクを教えてください。」
• 「この Facebook 投稿の広告を Retargeting 広告セットに複製し、いいねとコメントを引き継いでください。」
• 「この Instagram クリエイター投稿を、当社ブランドをスポンサーとするパートナーシップ広告としてインポートし、作成前にスポンサーをプレビューしてください。」
• 「この Google Drive フォルダー内のクリエイティブをアップロードし、新しい広告セットで、商品ごとに固有のフックを使った広告を作成してください。」
• 「保存済みビルド『Q4 Prospecting』から作成される内容を、公開前にプレビューしてください。」
• 「『home fitness』の興味関心ターゲティングを検索し、上位の一致項目をビルドに追加してください。」

仕組み

• まずは下書き／プレビュー。 ads_preview は読み取り専用および検証のみの呼び出しで投稿、メディア、権限を解決します。広告を作成したり、コードを保存したりすることはありません。
• ウェブアプリに引き継ぎ。 エージェントはヘッドレスで起動する代わりに、保存済みビルドを作成してリンクを渡すことができます。Ads Uploader のウェブアップローダーでデータが反映されるため（開いているタブが自動的に読み込みます）、フル UI から確認して公開できます。
• 時間のかかるジョブも応答性を維持。 ホスト型サーバーは約 60 秒後に still_running と jobId を返すため、ツール呼び出しがプロキシのタイムアウトを超えません。ads_get_job で再開してください。
• トークンではなく OAuth。 ホスト型サーバーは、ブラウザーで OAuth 2.1（PKCE）を使って認証します。

詳細情報

• ドキュメント： https://adsuploader.com/docs/ad-configuration/mcp
• ウェブサイト： https://adsuploader.com/meta-ads-mcp
• セキュリティ： SECURITY.md · プライバシー： PRIVACY.md

サポート

ご質問や問題がある場合：[email protected]

ライセンス

LICENSE に明記されているドキュメント、例、およびコネクター設定は、MIT License の下で利用できます。ライセンスと著作権表示を保持すれば、これらのファイルを再利用および改変できます。plugin.json の license フィールドは、この公開コネクターパッケージとそのライセンスが適用されるファイルのみを対象とします。

Ads Uploader は引き続きプロプライエタリです。 ホスト型製品、アプリケーションおよびバックエンドのソースコード、MCP サーバーの実装、API／CLI の実装、ならびに別途配布される npm パッケージ（@adsuploader/mcp や @adsuploader/cli を含む）は、このライセンスの対象外です。パッケージまたはサービスへのリンクによって、その実装にライセンスが付与されることはありません。サービスの利用には、お客様のサブスクリプション、権限、および 利用規約 が引き続き適用されます。

assets/ ディレクトリ、ロゴ、ブランドアートワーク、および商標は MIT License の対象外です。対象外の素材に関するすべての権利は、それぞれの所有者に留保されます。提携または推奨を示唆する権利は付与されません。