Synter Ads

공식

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

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

  • 플랫폼 전반의 캠페인 목록화 — 연결된 광고 계정에서 list_campaigns로 모든 캠페인을 가져오도록 어시스턴트에 요청하세요.
  • 검색 캠페인 생성 — create_search_campaign을 사용하여 키워드, 광고, 예산이 포함된 Google 검색 캠페인을 시작하세요.
  • 성과 저조 캠페인 일시 중지 — 지출 또는 ROAS가 좋지 않을 때 pause_campaign으로 모든 캠페인을 즉시 중지하세요.
  • 성과 지표 가져오기 — get_performance로 노출수, 클릭수, 지출, 전환, ROAS를 확인하세요.
  • 광고 소재 생성 — generate_image 또는 generate_video를 사용하여 업로드 준비가 된 광고 자산을 생성하세요.
  • 140개 이상의 도구 실행 — 고급 작업을 위해 run_tool로 전체 Synter 카탈로그에 직접 접근하세요.

문서

Synter MCP 서버

npm version License: MIT

광고를 위한 가장 완벽한 MCP 서버.

19개 광고 플랫폼에 걸친 리포팅과 그중 14개 플랫폼에서의 전체 캠페인 생성(16개 플랫폼에서 쓰기 작업), 모든 주요 구매 채널을 아우르며, 파괴적 작업에 대한 내장 확인 기능을 제공합니다.

캠페인을 만들고, 예산을 조정하고, 저성과 캠페인을 일시 중지하고, 크리에이티브를 생성하고, 성과 데이터를 가져오세요. Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X 등 모든 채널에서 자연스러운 대화를 통해 가능합니다.

이것은 AI 에이전트에게 신용카드를 부여하는 최초의 Model Context Protocol (MCP) 서버입니다.

참고: Synter-Media-AI/plugin은 공식 설치 가능한 Claude 플러그인 저장소입니다. 이 저장소의 .claude-plugin/ 사본은 설치 소스가 아닙니다.


Synter 비교

공식 Google Ads MCP 서버는 설계상 읽기 전용입니다. Google 문서에 따르면 "엄격히 읽기 전용"이며 "입찰가를 수정하거나, 캠페인을 일시 중지하거나, 새 자산을 만들 수 없습니다." 대부분의 타사 광고 MCP 서버는 단일 플랫폼만 다룹니다. 우리는 하나의 서버에서 모든 주요 구매 채널을 아우르며 작업의 두 측면을 모두 수행하도록 Synter를 구축했습니다.

Synter MCP공식 Google Ads MCP일반적인 타사 광고 MCP
접근 권한19개 플랫폼에서 읽기, 14개에서 캠페인 생성, 16개에서 쓰기 작업읽기 전용(현재 릴리스)종종 읽기 전용 또는 부분 쓰기
플랫폼19개 리포팅, 14개 전체 캠페인 생성(아래 목록)Google Ads만보통 단일 플랫폼
캠페인 생성✅ Google 검색, 디스플레이, PMax, Meta, LinkedIn, Reddit 등 run_tool 통해❌드묾
예산 및 일시 중지✅❌다양함
AI 크리에이티브 생성✅ 이미지, 비디오, 카피❌❌
오디언스 동기화✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X❌❌
안전성파괴적 작업에 대한 확인해당 없음(읽기 전용)다양함
오픈 소스✅ MIT✅다양함

리포팅 범위(19개 플랫폼): Google Ads, Microsoft Ads (Bing), Meta (Facebook 및 Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360, OpenAI Ads (ChatGPT).

전체 캠페인 생성(14개 플랫폼): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands 및 Display), Amazon DSP, The Trade Desk, OpenAI Ads. Display & Video 360과 StackAdapt는 캠페인 생성 없이 쓰기 작업(일시 중지, 예산 및 라인 항목 업데이트, 오디언스 업로드)을 추가로 지원합니다. 나머지 4개(Walmart Connect, Instacart, Target Roundel, Criteo)는 현재 리포팅 전용입니다.

npx 패키지는 가장 일반적인 작업을 위한 타입화된 도구와 140개 이상의 Synter 도구 전체 카탈로그에 대한 run_tool 접근을 제공합니다. https://mcp.syntermedia.ai/mcp/의 원격 서버는 위의 모든 플랫폼에 대한 성과 조회를 포함한 전체 호스팅 도구 세트를 노출합니다.

레지스트리 스타일 MCP 검색의 경우 server.json이 기계 판독 가능한 소스입니다. package.json, manifest.json 및 이 README의 설정 예제와 일치하도록 유지하세요.


⚠️ 공정한 경고

AI 에이전트는 다음을 수행할 수 있습니다:

  • 캠페인을 생성하여 즉시 예산을 지출하기 시작할 수 있습니다
  • 입찰가를 조정하여 클릭당 지불 금액에 영향을 미칠 수 있습니다
  • 캠페인을 일시 중지할 수 있습니다(때로는 좋은 일입니다)
  • 키워드를 추가하여 광고를 보는 사람을 변경할 수 있습니다
  • 크리에이티브를 생성하고 계정에 업로드할 수 있습니다

우리는 파괴적 작업에 대한 확인 기능을 내장했습니다. 하지만 그래도 방금 만난 에이전트에게는 주지 않는 것이 좋습니다.


빠른 시작

1. API 키 받기

syntermedia.ai에서 가입하고 개발자 설정에서 API 키를 만드세요.

2. AI 클라이언트 구성

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Cursor: 프로젝트의 .cursor/mcp.json에 추가:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Amp: .amp/settings.json에 추가:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

원격(Streamable HTTP): ChatGPT, n8n, Zapier 또는 HTTP 전송을 지원하는 모든 MCP 클라이언트:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

로컬 설치가 필요 없습니다. Streamable HTTP 전송을 지원하는 모든 MCP 클라이언트에서 작동합니다.

3. 사용 시작

AI 클라이언트를 다시 시작하고 대화를 시작하세요:

"내 모든 Google Ads 캠페인을 보여줘"

"'프로젝트 관리 소프트웨어'에 대한 검색 캠페인을 하루 $50 예산으로 만들어줘"

"과다 지출 중인 캠페인을 일시 중지해줘"


전체 플러그인을 선호하시나요? (Claude Code / Claude Desktop)

이 패키지는 원시 MCP 서버입니다. Claude Code 또는 Claude Desktop을 사용하는 경우, Synter 플러그인은 이 동일한 서버를 준비된 스킬(/synter:launch, /synter:audience, /synter:optimize, …), 전문화된 에이전트, 지출 전 승인 안전 훅으로 감쌉니다:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

또한 자동화를 위한 헤드리스 Claude Agent SDK 러너도 포함합니다. 플러그인 저장소 또는 Claude 플러그인 가이드를 참조하세요. 도구만 필요하거나 다른 클라이언트를 연결하는 경우 이 MCP 패키지를 직접 사용하세요.


에이전트가 할 수 있는 일

📊 캠페인 관리

도구설명
list_campaigns연결된 모든 플랫폼의 캠페인 나열
create_search_campaign키워드와 광고로 Google 검색 캠페인 생성
create_display_campaign이미지로 Google 디스플레이 캠페인 생성
create_pmax_campaignPerformance Max 캠페인 생성
create_meta_campaignFacebook/Instagram 캠페인 생성
create_linkedin_campaignB2B용 LinkedIn 캠페인 생성
create_reddit_campaignReddit 캠페인 생성
pause_campaign모든 캠페인 일시 중지
update_campaign_budget일일 예산 변경

📈 성과 및 분석

도구설명
get_performance노출, 클릭, 지출, 전환, ROAS 가져오기
get_daily_spend플랫폼별 일일 지출 분석

🎯 키워드 및 타겟팅

도구설명
add_keywords캠페인 또는 광고 그룹에 키워드 추가
add_negative_keywords원치 않는 검색어 차단

🔄 전환 추적

도구설명
create_conversion전환 액션 설정
list_conversions기존 전환 액션 나열
diagnose_tracking추적이 올바르게 설치되었는지 확인

🎨 크리에이티브 생성

도구설명
generate_imageAI 광고 이미지 생성
generate_videoAI 비디오 광고 생성
upload_image광고 자산으로 이미지 업로드

🔧 유틸리티

도구설명
list_ad_accounts연결된 모든 광고 계정 나열
run_tool140개 이상의 Synter 도구를 직접 실행

광고 경험이 없으신가요? 문제없습니다.

광고를 실행해 본 적이 없다면 알아야 할 사항은 다음과 같습니다:

캠페인이란 무엇인가요?

캠페인은 프로젝트 폴더와 같습니다. 광고, 광고를 볼 사람, 지출 금액이 포함됩니다.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

어떤 플랫폼을 사용할 수 있나요?

플랫폼가장 적합한 용도최소 예산
Google Ads제품을 적극적으로 검색하는 사람들$10/일
Meta (Facebook/Instagram)시각적 제품, 광범위한 오디언스$5/일
LinkedInB2B, 기업, 구직자$25/일
Reddit틈새 커뮤니티, 기술에 능숙한 사용자$5/일
Microsoft (Bing)연령대가 높은 인구통계, B2B$10/일
TikTokGen Z, 엔터테인먼트, 전자상거래$20/일

캠페인 유형 설명

검색 캠페인: 누군가 특정 키워드를 Google에서 검색할 때 광고가 표시됩니다.

  • 예: 누군가 "최고의 CRM 소프트웨어"를 검색 → 광고가 표시됨

디스플레이 캠페인: 웹사이트와 앱 전반에 표시되는 이미지 광고.

  • 예: 뉴스 사이트의 배너 광고

Performance Max (PMax): Google의 AI가 모든 곳(검색, YouTube, 디스플레이, Gmail, 지도)에서 광고를 표시합니다.

  • 예: Google이 최적의 게재 위치를 자동으로 결정

비디오 캠페인: YouTube 및 파트너 사이트의 비디오 광고.

  • 예: YouTube 비디오 전 15초 광고

일반적인 용어

용어의미
노출광고가 표시된 횟수
클릭광고를 클릭한 사람 수
CTR클릭률(클릭 ÷ 노출 × 100)
CPC클릭당 비용
전환원하는 행동(가입, 구매 등)
ROAS광고 지출 대비 수익(수익 ÷ 지출)

첫 캠페인 체크리스트

첫 캠페인을 만들기 전에 필요한 것:

  1. ✅ 클릭 시 사람들이 이동할 랜딩 페이지 URL
  2. ✅ 도달하려는 대상에 대한 아이디어(위치, 관심사)
  3. ✅ 부담 없는 일일 예산(시작 시 $10-50)
  4. ✅ 광고용 헤드라인과 설명 몇 가지

전문가 팁: Google에서 검색 캠페인으로 시작하세요. 가장 이해하기 쉽고 이미 찾고 있는 사람들에게 광고를 표시합니다.


예시 대화

첫 캠페인 만들기

사용자: 내 SaaS 제품에 대한 Google 검색 캠페인을 만들어줘. "팀 협업 소프트웨어"와 "프로젝트 관리 도구"를 검색하는 사람들을 타겟팅해. 예산은 하루 $25. 랜딩 페이지는 https://myapp.com/signup

에이전트: 해당 키워드로 검색 캠페인을 만들겠습니다. 어떤 헤드라인을 사용할까요? 몇 가지 제안:

  • "팀 협업을 간단하게"
  • "현대 팀을 위한 프로젝트 관리"
  • "무료 시작 - 신용카드 불필요"

성과 확인

사용자: 이번 주 내 캠페인은 어떻게 되고 있어?

에이전트: 지난 7일간의 성과입니다:

캠페인지출클릭전환ROAS
브랜드 검색$14289124.2x
경쟁사 키워드$984531.5x
디스플레이 리타겟팅$6723482.8x

"경쟁사 키워드" 캠페인이 저성과입니다. 일시 중지하거나 타겟팅을 조정할까요?

부정 키워드 추가

사용자: "무료 프로젝트 관리"에 대한 클릭이 들어오는데 무료 티어가 없어. 차단해줘.

에이전트: 캠페인에 "무료"를 부정 키워드로 추가했습니다. 이제 "무료"가 포함된 검색에는 광고가 표시되지 않습니다.

광고 크리에이티브 생성

사용자: 마케팅 자동화 제품용 디스플레이 광고 이미지가 필요해. 다크 테마, 전문적, 1200x628.

에이전트: 이미지를 생성 중입니다...

생성됨: "다크 배경의 데이터 시각화가 있는 마케팅 자동화 대시보드" 자산이 저장되었으며 다음 디스플레이 캠페인에서 사용할 준비가 되었습니다.


광고 계정 연결

각 플랫폼에서 광고를 관리하려면 Synter에서 계정을 연결해야 합니다:

  1. syntermedia.ai/settings/credentials로 이동
  2. 각 플랫폼 옆의 "연결" 클릭
  3. OAuth 흐름 완료
  4. 이제 에이전트가 해당 플랫폼을 관리할 수 있습니다

지원 플랫폼(19개; ✅ = 리포팅 + 전체 캠페인 실행, 📊 = 리포팅):

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • Snapchat Ads ✅
  • Pinterest Ads ✅
  • Spotify Ads ✅
  • Amazon DSP ✅
  • The Trade Desk ✅
  • Amazon Ads 📊
  • Walmart Connect 📊
  • Instacart Ads 📊
  • Target Roundel 📊
  • Criteo 📊
  • Display & Video 360 📊
  • OpenAI Ads (ChatGPT) 📊

고급: 직접 도구 접근

고급 사용자를 위해 140개 이상의 Synter 도구를 직접 호출할 수 있습니다:

> Use run_tool to call google_ads_list_audiences

전체 도구 목록은 docs.syntermedia.ai/tools에서 확인하거나 에이전트에게 물어보세요:

> What tools are available for LinkedIn Ads?

기본 안전: execute 명시하지 않는 한 드라이런

범용 execute 도구는 명시적으로 동의하지 않는 한 첫 번째 호출에서 작업을 실행하지 않습니다. 기본적으로(dry_run: true) 요청을 검증하고 거기서 멈춥니다 — 아무것도 실행되지 않고, 비용도 발생하지 않습니다. 실제로 작업을 실행하려면 dry_run: false를 전달하세요. 비용이 발생하는 작업의 경우 계정 소유자의 승인을 받은 경우에만 실행하세요.


환경 변수

변수필수설명
SYNTER_API_KEY예Synter API 키
SYNTER_API_URL아니요API URL 재정의(기본값: https://syntermedia.ai)

로컬 개발

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

문제 해결

"SYNTER_API_KEY not set"

API 키가 MCP 구성의 env 섹션에 있는지 확인하세요. 키는 syn_로 시작해야 합니다.

"Invalid or expired API key"

  1. 전체 키를 복사했는지 확인하세요(키가 깁니다!)
  2. syntermedia.ai/developer에서 키가 활성 상태인지 확인하세요
  3. 키에 tools:write 범위가 있는지 확인하세요

"No ad accounts connected"

최소한 하나의 광고 플랫폼을 연결해야 합니다:

  1. syntermedia.ai/settings/credentials로 이동하세요
  2. Google Ads(또는 다른 플랫폼) 옆의 "Connect"를 클릭하세요
  3. OAuth 인증을 완료하세요

Claude/Cursor에 도구가 표시되지 않음

  1. AI 클라이언트를 완전히 다시 시작하세요(새로고침만 하지 마세요)
  2. MCP 서버 로그에서 오류를 확인하세요
  3. 구성 파일 경로와 JSON 구문을 확인하세요

FAQ

Google Ads용 MCP 서버가 있나요?

네, 두 종류가 있습니다. Google은 공식 Google Ads MCP 서버를 제공하며, 현재 릴리스에서는 읽기 전용입니다: 보고서, 지표, 메타데이터를 조회할 수 있지만 Google 문서에 따르면 "입찰가를 수정하거나, 캠페인을 일시중지하거나, 새 자산을 만들 수 없습니다." 저희 MCP 서버는 Google Ads를 읽기와 쓰기 모두 지원합니다: Search, Display, Performance Max 캠페인 생성, 키워드 및 부정 키워드 추가, 예산 조정, 캠페인 일시중지, Customer Match 오디언스 관리, 전환 추적 설정, 성과 데이터 조회가 가능합니다. 동일한 서버는 18개 이상의 다른 광고 플랫폼에서도 보고하며, 그중 11개 플랫폼에서 전체 캠페인 실행을 지원합니다.

Claude나 ChatGPT가 제 광고 캠페인을 관리할 수 있나요?

네. Synter MCP 서버를 연결하면 Claude(Claude Desktop, Claude Code), ChatGPT, Cursor 및 기타 MCP 호환 클라이언트가 14개 광고 플랫폼에서 캠페인 생성, 예산 조정, 성과 저조 캠페인 일시중지, 크리에이티브 생성, 오디언스 동기화(16개 플랫폼에서 쓰기 작업)를 수행하고 19개 전체 플랫폼에서 성과 데이터를 조회할 수 있습니다. Claude 및 기타 stdio 클라이언트는 npx @synterai/mcp-server와 SYNTER_API_KEY를 통해 연결합니다. ChatGPT 및 기타 HTTP 클라이언트는 https://mcp.syntermedia.ai/mcp/의 원격 서버에 X-Synter-Key 헤더로 연결합니다. 파괴적 작업에는 기본 제공 확인 절차가 있습니다.

공식 Google Ads MCP와 Synter의 차이점은 무엇인가요?

두 가지입니다: 쓰기 액세스와 플랫폼 범위. 공식 Google Ads MCP는 현재 릴리스에서 읽기 전용이며 Google Ads만 지원합니다. Synter는 19개 플랫폼에서 보고하며 그중 14개에서 전체 캠페인 생성을 지원합니다(Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads, The Trade Desk 포함). Google Ads 보고만 필요하다면 공식 서버가 좋은 선택입니다. 발견한 내용에 대해 조치를 취할 수 있는 에이전트가 필요하다면, Google 및 기타 모든 광고 플랫폼에서 — 그것이 바로 Synter를 만든 이유입니다.


리소스


라이선스

MIT 라이선스 — 자세한 내용은 LICENSE를 참조하세요.


Synter
그들이 당신이 사용하지 못하게 하려는 MCP 확장 프로그램.
광고 예산을 가진 AI 에이전트가 모든 것을 바꾸기 때문입니다.