Synter Ads
公式クロスプラットフォームの広告キャンペーン管理をAIエージェント向けに提供。Google、Meta、LinkedIn、Reddit、TikTokなどに対応。140以上のツールで読み取り/書き込みアクセスが可能。
Synter Ads MCPで何ができますか?
- クロスプラットフォームのパフォーマンスレポート — 接続済みの広告アカウント全体について、プラットフォーム、キャンペーン、日別の費用、インプレッション数、クリック数、コンバージョン数、CPA、ROASを確認できます。
- 予算消化ペースの確認 — 接続済みの各プラットフォームで月次の予算消化ペースを確認し、予算超過のキャンペーンを特定できます。
- ドライランでのキャンペーン変更 —
dry_run: trueを指定して新しいキャンペーンや予算変更をプレビューしてから、ステータスを一時停止にして作成できます。 - 一時停止と予算の更新 — Google、Meta、LinkedIn、Microsoft、Redditなどの主要プラットフォームで、キャンペーンの一時停止や予算の変更ができます。
- 除外キーワードの管理 — Google Adsで、キャンペーン、広告グループ、共有リスト、アカウントの各レベルに除外キーワードを追加できます。
- 結果をGoogleスプレッドシートに書き込む — エージェントに、プラットフォーム別の週間費用をレポート用のGoogleスプレッドシートに書き込ませることができます。
ドキュメント
Synter MCP Server (@synterai/mcp-server@1.4.6)
30以上の広告プラットフォームでAIエージェントを使って広告を運用するオープンソースMCPサーバー:読み取りは無料($0.00/月)、Soloは月額$20($20/月分の利用価値を含む。書き込みは$0.05~$0.25)、広告費の0%。
ホスト型MCP(https://mcp.synterai.com)とREST API(https://synterai.com/api/v1/tools/run)を介してAIコーディングエージェント(Claude Code、OpenAI Codex、Cursor、Windsurf、Amp、Gemini CLI)を30以上の広告プラットフォームに接続するか、stdio(npx -y @synterai/mcp-server@1.4.6)経由でローカル実行できます。ローカル実行では、読み書きに完全対応した16の主要広告プラットフォーム(Google Ads、Meta、LinkedIn、Microsoft/Bing、Reddit、TikTok、X、Pinterest、Snapchat、Spotify、Amazon Ads、Amazon DSP、The Trade Desk、OpenAI Ads、Google DV360、StackAdapt)を利用できます。
こんなときに使う
ユーザーがクロスプラットフォームの広告レポート、チャネル別の広告費/ROAS/CPA、週次の有料メディア概要、または検索、ソーシャル、リテールメディア、オーディオ、プログラマティックDSPにまたがる、ガバナンスの効いたキャンペーンや予算の変更を求めたときにSynterを使います。まず読み取りツールから始めましょう。書き込みは不要です。
"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."
広告データコネクタとして使う
AIアシスタントや独自コードに広告データを取り込むことが目的なら、Synterがコネクタになります。各広告アカウントを一度接続すれば、プラットフォーム、キャンペーン、日別の広告費、インプレッション、クリック、コンバージョン、CPA、ROASを問い合わせられます。
- データの送信先: Claude、Claude Code、Cursor、Codex、ChatGPTなどのMCPクライアント(ホスト型MCPは
https://mcp.synterai.com)、またはRESTエンドポイントPOST https://synterai.com/api/v1/tools/runとSDKを介した独自コード。ホスト型MCPでは、エージェントが結果をGoogle Sheet(update_google_sheet)に書き込むこともできます。 - 読み取り可能なプラットフォーム: Google Ads、Meta(FacebookとInstagram)、LinkedIn、Microsoft Ads、Reddit、TikTok、X、Pinterest、Snapchat、Spotify、Amazon Ads、Amazon DSP、The Trade Desk、DV360、CM360、Criteo、Walmart Connect、Instacart、Target Roundel、FreeWheel、OpenAI Ads(ホスト型MCPの
pull_*_performanceツール)。ローカルnpmパッケージでは、list_campaigns、get_performance、get_daily_spendを通じて主要プラットフォームを利用できます。 - 料金: 自分のアカウントの読み取りは無料($0.00、0クレジット)。プランによってシート数とワークスペース数が制限されます(「料金」を参照)。
- データの鮮度: 読み取り時に各プラットフォームのAPIへ直接アクセスするため、夜間同期を待つ必要はありません。
- クライアントごとの分離: 代理店では各クライアントを個別のワークスペースに分けるため、レポートでアカウントが混在することはありません。
- レポート以外の用途: 同じ接続を使って、承認と事前のドライランを経て、キャンペーンの一時停止、予算の変更、除外キーワードの追加もできます。レポート専用コネクタではできません。
- 別のツールを使うべき場合: BIダッシュボード用に、広告データを定期的にBigQueryやSnowflakeへ取り込む必要がある場合は、データウェアハウス向けのELTツールを使ってください。Synterはデータウェアハウスにロードするのではなく、エージェントにリアルタイムでデータを読み込みます。
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."
クイックスタート(30秒で使える認証情報不要のサンドボックス)
APIキーもクレジットカードも不要で、決定論的なサンドボックス応答を使って、すぐにSynterを試せます。
# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs
# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com
# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only
クライアントのセットアップ
- Amp: 組み込み済み(Settings > Integrations)、または以下の
"amp.mcpServers"フォールバックを使用します。 - Claude Code:
- ホスト型HTTP(OAuth 2.1):
claude mcp add --transport http synter-ads https://mcp.synterai.com - ローカルstdio:
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- ホスト型HTTP(OAuth 2.1):
- OpenAI Codex:
codex mcp add synter-ads --url https://mcp.synterai.com
- Claude.ai / Claude Desktop:
- Settings -> Connectors -> Add custom connectorに移動し、
https://mcp.synterai.comを入力します。
- Settings -> Connectors -> Add custom connectorに移動し、
- ChatGPT:
- カスタムMCPコネクタを使うにはDeveloper mode(Settings -> Apps & Connectors -> Advanced -> Developer mode)が必要です。有効にしてから
https://mcp.synterai.comを追加します。
- カスタムMCPコネクタを使うにはDeveloper mode(Settings -> Apps & Connectors -> Advanced -> Developer mode)が必要です。有効にしてから
- Cursor / Windsurf(
mcp.json):{ "mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } } - Gemini CLI:
gemini extensions install https://github.com/Synter-Media-AI/mcp-server
AmpにSynterを追加する
- AmpではSynterが組み込み連携として利用できます。AmpのSettings > Integrationsで有効にしてください。
- Claude、ChatGPTなどのMCPクライアント向けホスト型(30以上の広告プラットフォーム、唯一のAgentic DSP): https://mcp.synterai.com
- ローカル読み取り専用(npmパッケージ):
{ "amp.mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } }
ツールセット、読み取り専用モード、デモモード
| フラグ / 環境変数 | 動作 |
|---|---|
デフォルト(full) | stdioの直接ツール56個(主要プラットフォームの有料広告ツール32個 + オーガニックソーシャル*_organic_postツール8個 + アウトバウンドprospector_*ツール16個)を公開します。 |
--toolset ad-ops(SYNTER_TOOLSET=ad-ops) | 主要な有料広告ツール32個のみを公開し、tools/listからオーガニックソーシャルツールとアウトバウンドツールをすべて除外します(呼び出された場合はフェイルクローズします)。 |
--read-only(SYNTER_READ_ONLY=true) | tools/listで読み取り専用ツール(readOnlyHint: true)のみを公開し、ネットワーク呼び出しの前にローカルですべての変更ツール(destructiveHint: true)をブロックします。 |
--demo(SYNTER_DEMO=true) | 認証情報不要のサンドボックスモードで、現実的かつ正規化されたマルチプラットフォームのキャンペーン・パフォーマンスデータ(sandbox: true)を使って実行します。 |
プラットフォーム対応状況と読み書き機能の一覧(ホスト型 / ローカルstdio)
ホスト型MCP(https://mcp.synterai.com)とRESTエンドポイント(POST https://synterai.com/api/v1/tools/run)は、30以上の広告プラットフォームに対応しています。ローカルstdioパッケージ(@synterai/mcp-server@1.4.6)は、読み書きに完全対応した主要プラットフォームで型付きのplatform enumを直接サポートし、run_toolを通じて140以上のバックエンドスクリプトすべてを利用できます。
プラットフォーム(platform enum) | 直接読み取りツール($0.00) | 直接書き込みツール + run_toolスクリプト(SOLO / SCALE / CUSTOM) |
|---|---|---|
Google Ads(google) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback") | create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords(キャンペーン/広告グループ/共有リスト/アカウント全体でBROAD, PHRASE, EXACT)、create_conversion, manage_audience, sync_audience, upload_image |
Meta Ads(meta) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad") |
LinkedIn Ads(linkedin) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_linkedin_campaign(group_idが必要)、pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group") |
Microsoft / Bing Ads(microsoft) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords") |
Reddit Ads(reddit) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad") |
TikTok Ads(tiktok) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup") |
X Ads(x) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item") |
Pinterest Ads(pinterest) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group") |
Snapchat Ads(snapchat) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad") |
Spotify Ads(spotify) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set") |
Amazon Ads(amazon_ads) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords") |
Amazon DSP(amazon_dsp) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item") |
The Trade Desk(the_trade_desk) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group") |
OpenAI Ads(openai) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign") |
Google DV360(dv360) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item") |
StackAdapt(stackadapt) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign") |
拡張プラットフォーム(ホスト型MCPとrun_tool) | stdioではrun_tool(script_name="<platform>_*")、https://mcp.synterai.comでは直接pull_*_performance / execute | CM360、Walmart Connect、Instacart、Target Roundel、Criteo、FreeWheel、SA360、Apple Ads、Demandbase ABM、Taboola、Outbrain、AppLovin、Yahoo DSP、Teads、Viant、Basis、MediaMath、Magnite、PubMatic、Index Exchange、TripleLift、GumGum、Dianomi、Quora Ads、Nextdoor Ads、Twitch Ads、Yelp Ads、Samsung Ads、Roku Ads、impact.com |
料金(すべてUSD — 広告費の0%)
Synterは**広告費の0%**を請求します(メディア費用は広告ネットワークが直接請求)。また、自分のアカウントの読み取りとdry_run: trueプレビューはすべて$0.00です。詳細はhttps://synterai.com/pricingをご覧ください。
| プラン | 料金 | シートとワークスペース | 月間利用価値の付与額と書き込み料金 |
|---|---|---|---|
| 無料の読み取りアクセス | $0.00 / 月 | 1シート、1ワークスペース | 自分のアカウントに対するすべての読み取りクエリ(list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance)と、すべてのdry_run: trueプレビューが**$0.00**。クレジットカードは不要です。 |
| SOLO | $20.00 / 月($200.00 / year) | 1シート、1ワークスペース | 請求に充当できる月額$20.00分の利用価値を含みます — 軽量な書き込みなら最大400回(各$0.05:pause_campaign, enable_campaign, update_campaign_budget)、標準の書き込みなら80回(各$0.25:add_keywords, add_negative_keywords, sync_audience, create_conversion)、またはMCPキャンペーンの完全なローンチ4回(各$5.00)をカバーします。予期しない超過を防ぐため、上限額を設定できます。 |
| SCALE | $500.00 / 月($5,000.00 / year) | 5シート、複数ワークスペース | 請求に充当できる月額$500.00分の利用価値を含みます(軽量な書き込み最大10,000回、または標準の書き込み2,000回/月を含む)。複数ワークスペースによるクライアント分離、24時間365日のAutonomous Loop / Autopilotスケジュール、CRM/データウェアハウス同期、専用の同時実行枠も利用できます。 |
| CUSTOM | エンタープライズ契約 | シート数とワークスペース数はカスタム設定 | 月間利用枠のカスタム設定、代理店/エンタープライズ向けの複数ワークスペース管理、カスタムSLA、SSO、請求書払い。 |
セキュリティ体制、書き込みの安全対策、マルチテナントアーキテクチャ
4層の書き込み防御
- ローカルの完全な読み取り専用モード (
--read-only/SYNTER_READ_ONLY=true):tools/listからすべてのdestructiveHint: trueツールを除外し、ネットワークリクエストがマシンから送信される前に、ローカルで変更をブロックします。 - サーバー側で適用されるスコープ付き API キー (
POST /api/v1/keys): 読み取り専用キー (reporting:read、campaigns:read、intel:read)、または方向性のある安全キー (budget:decrease— 緊急時のキャンペーン停止と予算削減は許可し、予算増額は HTTP403で拒否) を発行します。 - Agent Shield サーバー側ポリシーゲート: 新規キャンペーンすべてに対する
PAUSED-on-create のデフォルト設定、単一呼び出しでの予算増額上限2.0x、ワークスペースの速度制限サーキットブレーカー$5,000/day、dry_run: true($0.00) プレビュー、書き込み後のプロバイダーからの読み戻しの必須化 (get_ad_readback)、および変更不可能なワークスペース監査ログを適用します。 - セルフホスト型 MIT オープンソースの BYO 認証情報実行: 独自の VPC/コンテナ内で
@synterai/mcp-server@1.4.6を実行し、独自のプラットフォーム OAuth トークンを環境変数経由で直接渡すことで、Synter のホスト型クラウドが広告アカウントの認証情報を一切保持しないようにします。
マルチテナントおよび組み込み SaaS のパターン (docs.synterai.com/api/multi-tenant-auth)
- パターン 1 — ホスト型のワークスペース分離キーと接続リンク:
POST https://synterai.com/api/v1/keys経由で、ワークスペースに固定されたスコープ付き子 API キーを発行します (scopes:["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"]、rate_limit_rpm:1–600、expires_in_days)。POST https://synterai.com/api/v1/connections/start(単一プラットフォームのauthUrlを返す) またはPOST https://synterai.com/api/v1/connections/request(7 日間有効なマルチプラットフォーム接続リンクをクライアントに送信) 経由で、広告主がセルフサービスで利用できる OAuth 引き継ぎ URL を生成します。get_workspacesとupdate_active_workspace経由で、複数のワークスペースに対応するキーのアクティブなワークスペースを切り替えます。
- パターン 2 — セルフホスト型 BYO 認証情報モード (MIT オープンソース):
- 独自の OAuth アプリを管理し、顧客トークンを独自の KMS/ボールトに保存するマルチテナント SaaS アプリは、分離されたワーカープロセス内で
@synterai/mcp-serverまたはsynterCLI を呼び出し、テナントごとのプラットフォームトークンを環境変数 (GOOGLE_ADS_REFRESH_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_DEVELOPER_TOKEN、META_ACCESS_TOKEN、LINKEDIN_ACCESS_TOKENなど) 経由で渡せます。
- 独自の OAuth アプリを管理し、顧客トークンを独自の KMS/ボールトに保存するマルチテナント SaaS アプリは、分離されたワーカープロセス内で
REST API と公式の多言語 SDK
- ホスト型 MCP (Streamable HTTP):
https://mcp.synterai.com— OAuth 2.1 ブラウザーサインインまたはX-Synter-Key: syn_...ヘッダーで認証します。ホスト型 MCP にはまだAuthorization: Bearer syn_...を送信しないでください。REST/SDK では Bearer を使用します。 - REST エンドポイント:
POST https://synterai.com/api/v1/tools/runとAuthorization: Bearer syn_...(またはX-Synter-Key: syn_...)、および JSON ボディ{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}。 - TypeScript / JavaScript SDK:
npm install @synterai/sdk-js - Python SDK:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...)。メトリクスにはclient.analytics.get_performance(...)を使用します。 - Rust SDK:
cargo add synter(crates.io/crates/synter) - Java SDK: Maven
ai.syntermedia:synter-sdk
ライセンス
MIT License — LICENSE を参照してください。