Synter Ads

공식

AI 에이전트를 위한 Google, Meta, LinkedIn, Reddit, TikTok 등 여러 플랫폼의 교차 플랫폼 광고 캠페인 관리. 읽기/쓰기 접근이 가능한 140개 이상의 도구.

Synter Ads MCP(으)로 무엇을 할 수 있나요?

  • 크로스 플랫폼 실적 보고서 — 연결된 광고 계정에서 플랫폼, 캠페인, 날짜별 지출액, 노출수, 클릭수, 전환수, CPA 및 ROAS를 요청합니다.
  • 예산 집행 속도 점검 — 연결된 플랫폼 전반의 월간 예산 집행 속도를 검토하고 예산을 초과 지출하는 캠페인을 표시합니다.
  • 드라이 런을 통한 캠페인 변경 — 새 캠페인을 만들거나 예산을 변경하기 전에 dry_run: true로 미리 확인한 다음 PAUSED 상태로 생성합니다.
  • 일시중지 및 예산 업데이트 — Google, Meta, LinkedIn, Microsoft, Reddit 및 기타 주요 플랫폼에서 캠페인을 일시중지하거나 캠페인 예산을 변경합니다.
  • 제외 키워드 관리 — Google Ads에서 캠페인, 광고 그룹, 공유 목록 또는 계정 수준으로 제외 키워드를 추가합니다.
  • Google Sheet에 결과 기록 — 에이전트가 플랫폼별 주간 지출액을 보고용 Google Sheet에 기록하도록 합니다.

문서

Synter MCP Server (@synterai/mcp-server@1.4.6)

30개 이상의 광고 플랫폼에서 AI 에이전트로 광고를 운영하는 오픈 소스 MCP 서버: 무료 읽기($0.00/월), Solo 월 $20(사용 가치 $20/월 포함, 쓰기 작업당 $0.05~$0.25), 광고비의 0%.

npm version License: MIT Add Synter to Amp

호스팅 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)입니다. 요금제에 따라 좌석 및 워크스페이스 수가 제한됩니다(Pricing 참조).
  • 데이터 최신성: 요청 시 각 플랫폼의 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
  • 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를 입력하세요.
  • ChatGPT:
    • 사용자 지정 MCP 커넥터를 사용하려면 Developer mode(Settings -> Apps & Connectors -> Advanced -> Developer mode)를 활성화한 다음 https://mcp.synterai.com를 추가하세요.
  • 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 추가하기

  1. Amp에서 Synter는 기본 제공 통합 기능입니다. Amp의 Settings > Integrations에서 활성화하세요.
  2. Claude, ChatGPT 및 기타 MCP 클라이언트, 호스팅 방식(30개 이상의 광고 플랫폼, 유일한 Agentic DSP): https://mcp.synterai.com
  3. 로컬 읽기 전용(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_budgetcreate_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_budgetcreate_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_budgetpause_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_budgetcreate_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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 / executeCM360, 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

요금(100% 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시간 연중무휴 Autonomous Loop / Autopilot 일정, CRM/웨어하우스 동기화, 전용 동시성 지원.
CUSTOM엔터프라이즈 계약사용자 지정 좌석 및 워크스페이스사용자 지정 월간 사용 한도, 에이전시/엔터프라이즈용 다중 워크스페이스 관리, 사용자 지정 SLA, SSO, 청구서 결제.

보안 태세, 쓰기 보호 장치 및 멀티테넌트 아키텍처

4계층 쓰기 방어

  1. 로컬 하드 읽기 전용 모드 (--read-only / SYNTER_READ_ONLY=true): tools/list에서 모든 destructiveHint: true 도구를 제거하고, 네트워크 요청이 컴퓨터에서 나가기 전에 로컬에서 변경 작업을 차단합니다.
  2. 서버에서 적용하는 범위 지정 API 키 (POST /api/v1/keys): 읽기 전용 키(reporting:read, campaigns:read, intel:read) 또는 방향성 안전 키(budget:decrease — 긴급 캠페인 일시 중지와 예산 감액은 허용하지만 예산 증액은 HTTP 403로 거부)를 발급합니다.
  3. Agent Shield 서버 측 정책 게이트: 모든 신규 캠페인에 PAUSED-on-create 기본값을 적용하고, 단일 호출 예산 증액 한도를 최대 2.0x로 제한하며, $5,000/day 작업 공간 속도 회로 차단기, dry_run: true ($0.00) 미리보기, 필수 쓰기 후 공급자 재조회(get_ad_readback), 변경 불가능한 작업 공간 감사 로그를 제공합니다.
  4. 자체 호스팅 MIT 오픈 소스 BYO 자격 증명 실행: 자체 VPC/컨테이너에서 @synterai/mcp-server@1.4.6를 실행하고, 자체 플랫폼 OAuth 토큰을 환경 변수를 통해 직접 전달하여 Synter의 호스팅 클라우드가 광고 계정 자격 증명을 전혀 보관하지 않도록 합니다.

멀티 테넌트 및 임베디드 SaaS 패턴 (docs.synterai.com/api/multi-tenant-auth)

  1. 패턴 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을 통해 광고주가 직접 사용할 수 있는 OAuth 핸드오프 URL을 생성합니다(단일 플랫폼 authUrl 반환). 또는 POST https://synterai.com/api/v1/connections/request를 사용해 클라이언트에게 7일간 유효한 멀티 플랫폼 연결 링크를 전송합니다.
    • get_workspaces 및 update_active_workspace을 통해 여러 작업 공간을 사용하는 키의 활성 작업 공간을 전환합니다.
  2. 패턴 2 — 자체 호스팅 BYO 자격 증명 모드(MIT 오픈 소스):
    • 자체 OAuth 앱을 관리하고 고객 토큰을 자체 KMS/볼트에 저장하는 멀티 테넌트 SaaS 앱은 격리된 작업자 프로세스에서 @synterai/mcp-server 또는 synter CLI를 호출하고, 테넌트별 플랫폼 토큰을 환경 변수로 전달할 수 있습니다(GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN 등).

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를 참조하세요.