Synter Ads
공식AI 에이전트를 위한 Google, Meta, LinkedIn, Reddit, TikTok 등 여러 플랫폼의 교차 플랫폼 광고 캠페인 관리. 읽기/쓰기 접근이 가능한 140개 이상의 도구.
Synter Ads MCP(으)로 무엇을 할 수 있나요?
- 플랫폼 전반의 캠페인 나열 —
list_campaigns를 사용하여 연결된 광고 계정의 모든 캠페인을 표시하도록 어시스턴트에 요청하세요. - 검색 캠페인 생성 —
create_search_campaign을 통해 키워드, 예산, 랜딩 페이지를 포함한 Google 검색 캠페인을 어시스턴트가 만들도록 하세요. - 성과가 낮은 광고 일시 중지 —
pause_campaign으로 과다 지출하거나 성과가 저조한 캠페인을 중단하도록 어시스턴트에 지시하세요. - 일일 예산 조정 —
update_campaign_budget을 사용하여 즉시 예산 변경을 요청하고 지출을 늘리거나 줄이세요. - 성과 지표 가져오기 —
get_performance를 사용하여 플랫폼 전반의 노출수, 클릭수, 지출, 전환 및 ROAS를 확인하세요. - 광고 소재 생성 —
generate_image및generate_video를 사용하여 캠페인용 AI 생성 이미지나 비디오를 요청하세요.
문서
Synter MCP Server
광고를 위한 가장 완벽한 MCP 서버.
19개 광고 플랫폼에 걸친 보고와 그중 14개 플랫폼에서의 전체 캠페인 생성(16개에서 쓰기 작업), 모든 주요 구매 채널을 아우르며 파괴적 작업에 대한 내장 확인 절차를 제공합니다.
캠페인 생성. 예산 조정. 저성과 캠페인 일시 중지. 크리에이티브 생성. 성과 데이터 수집. 이 모든 것을 자연스러운 대화로 처리하세요 — Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X 등에서 말이죠.
이것은 AI 에이전트에 신용카드를 부여한 최초의 Model Context Protocol (MCP) 서버입니다.
Synter 비교
공식 Google Ads MCP 서버는 설계상 읽기 전용입니다: Google 문서에 따르면 "엄격히 읽기 전용"이며 "입찰가를 수정하거나, 캠페인을 일시 중지하거나, 새 자산을 만들 수 없습니다." 대부분의 서드파티 광고 MCP 서버는 단일 플랫폼만 다룹니다. 우리는 Synter를 한 서버에서 모든 주요 구매 채널을 아우르며 작업의 양면을 모두 수행하도록 구축했습니다.
| Synter MCP | 공식 Google Ads MCP | 일반적인 서드파티 광고 MCP | |
|---|---|---|---|
| 접근 | 19개 플랫폼 읽기, 14개 캠페인 생성, 16개 쓰기 작업 | 읽기 전용(현재 릴리스) | 종종 읽기 전용 또는 부분 쓰기 |
| 플랫폼 | 19개 보고, 14개 전체 캠페인 생성(아래 목록) | Google Ads만 | 보통 단일 플랫폼 |
| 캠페인 생성 | ✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit 등 run_tool | ❌ | 드묾 |
| 예산 및 일시 중지 | ✅ | ❌ | 다양함 |
| AI 크리에이티브 생성 | ✅ 이미지, 비디오, 카피 | ❌ | ❌ |
| 오디언스 동기화 | ✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X | ❌ | ❌ |
| 안전성 | 파괴적 작업에 대한 확인 절차 | 해당 없음(읽기 전용) | 다양함 |
| 오픈소스 | ✅ MIT | ✅ | 다양함 |
보고 범위(19개 플랫폼): Google Ads, Microsoft Ads (Bing), Meta (Facebook and 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에 가입하고 Developer Settings에서 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_campaign | Performance Max 캠페인 생성 |
create_meta_campaign | Facebook/Instagram 캠페인 생성 |
create_linkedin_campaign | B2B용 LinkedIn 캠페인 생성 |
create_reddit_campaign | Reddit 캠페인 생성 |
pause_campaign | 모든 캠페인 일시 중지 |
update_campaign_budget | 일일 예산 변경 |
📈 성과 및 분석
| 도구 | 설명 |
|---|---|
get_performance | 노출, 클릭, 지출, 전환, ROAS 확인 |
get_daily_spend | 플랫폼별 일일 지출 내역 |
🎯 키워드 및 타겟팅
| 도구 | 설명 |
|---|---|
add_keywords | 캠페인 또는 광고 그룹에 키워드 추가 |
add_negative_keywords | 원치 않는 검색어 차단 |
🔄 전환 추적
| 도구 | 설명 |
|---|---|
create_conversion | 전환 액션 설정 |
list_conversions | 기존 전환 액션 목록 표시 |
diagnose_tracking | 추적이 올바르게 설치되었는지 확인 |
🎨 크리에이티브 생성
| 도구 | 설명 |
|---|---|
generate_image | AI 광고 이미지 생성 |
generate_video | AI 비디오 광고 생성 |
upload_image | 광고 자산으로 이미지 업로드 |
🔧 유틸리티
| 도구 | 설명 |
|---|---|
list_ad_accounts | 연결된 모든 광고 계정 목록 표시 |
run_tool | 140개 이상의 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/일 |
| B2B, 기업, 구직자 | $25/일 | |
| 틈새 커뮤니티, 기술에 능숙한 사용자 | $5/일 | |
| Microsoft (Bing) | 연령대가 높은 인구통계, B2B | $10/일 |
| TikTok | Z세대, 엔터테인먼트, 이커머스 | $20/일 |
캠페인 유형 설명
검색 캠페인: 누군가 특정 키워드를 Google에 검색하면 광고가 표시됩니다.
- 예시: 누군가 "최고의 CRM 소프트웨어"를 검색 → 광고가 표시됨
디스플레이 캠페인: 웹사이트와 앱 전반에 표시되는 이미지 광고.
- 예시: 뉴스 사이트의 배너 광고
Performance Max (PMax): Google의 AI가 모든 곳(Search, YouTube, Display, Gmail, Maps)에 광고를 표시합니다.
- 예시: Google이 최적의 게재 위치를 알아서 정합니다
비디오 캠페인: YouTube 및 파트너 사이트의 비디오 광고.
- 예시: YouTube 비디오 앞의 15초 광고
일반 용어
| 용어 | 의미 |
|---|---|
| 노출 | 광고가 표시된 횟수 |
| 클릭 | 광고를 클릭한 사람 수 |
| CTR | 클릭률(클릭 ÷ 노출 × 100) |
| CPC | 클릭당 비용 |
| 전환 | 원하는 행동(가입, 구매 등) |
| ROAS | 광고 지출 대비 수익(수익 ÷ 지출) |
첫 캠페인 체크리스트
첫 캠페인을 만들기 전에 필요한 것:
- ✅ 클릭 시 사용자가 이동할 랜딩 페이지 URL
- ✅ 도달하려는 대상에 대한 생각(위치, 관심사)
- ✅ 부담 없는 일일 예산(시작 시 $10-50)
- ✅ 광고용 헤드라인과 설명 몇 가지
전문가 팁: Google에서 검색 캠페인으로 시작하세요. 이해하기 가장 쉽고, 이미 당신이 제공하는 것을 찾고 있는 사람들에게 광고를 보여줍니다.
대화 예시
첫 캠페인 만들기
당신: 내 SaaS 제품에 대한 Google 검색 캠페인을 만들어줘. "팀 협업 소프트웨어"와 "프로젝트 관리 도구"를 검색하는 사람들을 타겟으로 해줘. 예산은 하루 $25. 랜딩 페이지는 https://myapp.com/signup
에이전트: 해당 키워드로 검색 캠페인을 만들겠습니다. 어떤 헤드라인을 사용할까요? 몇 가지 제안입니다:
- "Team Collaboration Made Simple"
- "Project Management for Modern Teams"
- "Start Free - No Credit Card"
성과 확인
당신: 이번 주 캠페인 성과가 어때?
에이전트: 지난 7일간의 성과입니다:
캠페인 지출 클릭 전환 ROAS Brand Search $142 89 12 4.2x Competitor Keywords $98 45 3 1.5x Display Retargeting $67 234 8 2.8x "Competitor Keywords" 캠페인이 저조합니다. 일시 중지하거나 타겟팅을 조정할까요?
부정 키워드 추가
당신: "무료 프로젝트 관리"로 클릭이 오고 있는데 우리는 무료 티어가 없어. 그 검색어를 차단해줘.
에이전트: "무료"를 캠페인의 부정 키워드로 추가했습니다. 이제 "무료"가 포함된 검색에는 광고가 표시되지 않습니다.
광고 크리에이티브 생성
당신: 마케팅 자동화 제품용 디스플레이 광고 이미지가 필요해. 다크 테마, 전문적, 1200x628.
에이전트: 이미지를 생성하는 중입니다...
생성 완료: "다크 배경의 데이터 시각화가 있는 마케팅 자동화 대시보드" 자산이 저장되었으며 다음 디스플레이 캠페인에서 사용할 준비가 되었습니다.
광고 계정 연결
각 플랫폼에서 광고를 관리하려면 Synter에 계정을 연결해야 합니다:
- syntermedia.ai/settings/credentials로 이동
- 각 플랫폼 옆의 "Connect"를 클릭
- OAuth 흐름 완료
- 이제 에이전트가 해당 플랫폼을 관리할 수 있습니다
지원 플랫폼(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 명시하지 않으면 Dry-Run
범용 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가 설정되지 않음"
API 키가 MCP 구성의 env 섹션에 있는지 확인하세요. 키는 syn_로 시작해야 합니다.
"유효하지 않거나 만료된 API 키"
- 전체 키를 복사했는지 확인하세요 (키가 길어요!)
- 키가 syntermedia.ai/developer에서 활성 상태인지 확인하세요
- 키에
tools:write범위가 있는지 확인하세요
"연결된 광고 계정 없음"
최소 하나의 광고 플랫폼을 연결해야 합니다:
- syntermedia.ai/settings/credentials로 이동하세요
- Google Ads(또는 다른 플랫폼) 옆의 "연결"을 클릭하세요
- OAuth 인증을 완료하세요
Claude/Cursor에 도구가 표시되지 않음
- AI 클라이언트를 완전히 다시 시작하세요 (새로 고침만 하지 말고)
- MCP 서버 로그에서 오류를 확인하세요
- 구성 파일 경로와 JSON 구문을 확인하세요
자주 묻는 질문
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를 만든 이유입니다.
리소스
- Synter 매뉴얼: syntermedia.ai/manual
- API 문서: docs.syntermedia.ai
- Claude 플러그인: github.com/Synter-Media-AI/plugin (Claude Code / Desktop용 스킬, 에이전트 및 이 MCP)
- 도구 참조: docs.syntermedia.ai/tools
- MCP 서버 비교: syntermedia.ai/blog/best-ad-platform-mcp-servers
- 무료 에이전트 스킬 (오픈소스 47개): github.com/Synter-Media-AI/free-skills (skills.sh에서도 확인 가능)
- 지원: hello@syntermedia.ai
라이선스
MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.
그들이 당신이 사용하지 못하게 하려는 MCP 확장입니다.
광고 예산을 가진 AI 에이전트가 모든 것을 바꾸기 때문입니다.