irinabuht12-oss/google-ads-meta-ads-mcp

Google Ads MCP server + Meta Ads MCP (Facebook Ads MCP) + Google Analytics MCP (GA4) + Search Console in one hosted remote MCP for Claude, ChatGPT, Cursor & n8n: OAuth login, no API keys, approval-gated writes, 7-day free trial. By Ryze AI.

이 저장소는 무엇인가요?

**google-ads-meta-ads-mcp**는 원격 Model Context Protocol (MCP) 서버의 소스 코드로, 세 가지 주요 광고 및 분석 API를 AI 어시스턴트(Claude, ChatGPT, Cursor, n8n, Windsurf 등)가 호출할 수 있는 "도구"로 노출합니다.

Google Ads API (캠페인, 키워드, 입찰, 보고 등)
Meta (Facebook/Instagram) Marketing API (캠페인, 광고 세트, 크리에이티브, 오디언스, 보고 등)
Google Analytics 4 Data API (표준, 실시간, 오디언스, 속성 설정 등)

서버는 오픈 소스 Model Context Protocol을 구현하여 LLM이 자연어 프롬프트를 통해 이러한 도구를 호출할 수 있게 합니다. Ryze AI는 서버를 https://connector.get-ryze.ai/mcp에서 호스팅합니다. 저장소에는 코드, 문서, 250개 이상의 사용 가능한 도구 카탈로그가 포함되어 있습니다.

누가 사용할까요?

역할	중요성
마케터 / 에이전시	단일 채팅 기반 인터페이스에서 Google Ads, Meta Ads, GA4를 관리하며, 쓰기 액세스는 승인 단계로 제어됩니다.
LLM 기반 워크플로우 빌더	MCP 엔드포인트를 Claude, ChatGPT, Cursor, n8n, Windsurf 등에 연결하여 광고 생성, 예산 조정, 성과 감사, 교차 플랫폼 보고를 자동화합니다.
AI 에이전트 개발자	MCP 사양을 사용하여 OAuth, API 키, 개별 SDK를 처리하지 않고도 사용자 지정 에이전트에 풍부한 광고 도구 상자를 추가합니다.
제품 팀	API를 자체 호스팅하지 않고 AI 기반 캠페인 관리를 원하는 고객에게 호스팅된 "광고 as a Service" 기능을 제공합니다.

핵심 기능 (README에 나열된 대로)

Google Ads (약 150개 도구)

검색, 디스플레이, 쇼핑, Performance Max, Demand Gen, 동영상, 앱 캠페인 CRUD
Keyword Planner를 통한 키워드 조사 (볼륨, CPC, 경쟁)
입찰 및 예산 도구, 포트폴리오 전략, 입찰 조정
크리에이티브 생성 (반응형 검색/디스플레이 광고, Demand Gen 광고, 앱 광고)
오디언스 타겟팅 (맞춤, 리마케팅, 고객 매칭, 결합)
전체 성과 분석 (지표, ROAS, 검색어, 부정 키워드 제안)
확장 (사이트링크, 콜아웃, 전화, 이미지, 가격, 프로모션, 리드 폼)
실험 및 A/B 테스트
전환 추적 설정 및 업로드

Meta Ads (약 80개 도구)

Facebook 및 Instagram 전반의 캠페인, 광고 세트, 크리에이티브 CRUD
예산, 일정, 게재 위치, 최적화 제어
오디언스 도구 (맞춤, 유사, 관심사/행동/인구통계)
리드 생성 폼 및 제품 카탈로그 관리
페이지 관리 (게시물, 부스트 게시물, 인사이트)
비즈니스 계정 관리 (사용자, 페이지, 픽셀)
세부 성과 인사이트 및 분석

Google Analytics 4 (약 20개 도구)

표준, 피벗, 실시간 보고서
오디언스, 세그먼트, 채널 그룹 목록
속성 설정 (데이터 스트림, 향상된 측정, 보존)
기여 모델 설정
이벤트 및 전환 관리
통합 링크 (BigQuery, DV360, 검색 광고, Firebase)
속성 수준 주석 및 메타데이터 쿼리

교차 플랫폼 기능

Google 및 Meta 캠페인 간 ROAS 비교
광고 지출과 GA4 전환 이벤트의 상관 관계
통합 예산 할당 권장 사항

연결 방법 (빠른 시작)

커넥터 URL 추가 (https://connector.get-ryze.ai/mcp) AI 어시스턴트의 Connectors UI에서 (Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, n8n 등).
로그인 Google Ads/GA4 속성을 소유한 Google 계정또는 Meta 광고 계정을 소유한 Facebook 계정으로. 서버는 OAuth 2.1 + PKCE를 처리합니다. 개발자 토큰이나 API 키가 필요 없습니다.
쓰기 승인 – 캠페인, 예산, 크리에이티브를 변경하는 모든 작업은 스테이징되며, 기본 API로 전송되기 전에 Ryze UI에서 승인해야 합니다.
프롬프트 시작 – 어시스턴트에게 캠페인 나열, 새 광고 생성, GA4 보고서 가져오기 등을 요청합니다. 어시스턴트는 자연어 요청을 적절한 MCP 도구 호출로 변환합니다.

README에는 어시스턴트별 설정 가이드(docs/SETUP_*.md)와 각 플랫폼의 예제 프롬프트가 제공됩니다.

제한 사항 및 고려 사항

호스팅 서비스 – 서버는 Ryze의 인프라에서 실행됩니다. 구독(유료 광고 플랜 $89/월, 7일 무료 평가판)을 사용해야 합니다. 코드는 오픈 소스이지만 호스팅 엔드포인트는 유료 제품입니다.
쓰기 게이트 – 모든 쓰기 작업은 예산 실수를 방지하기 위해 승인 단계를 거칩니다. 이로 인해 수동 체크포인트가 추가됩니다.
OAuth 범위 – 커넥터는 로그인한 사용자가 관리 권한이 있는 계정에서만 작업할 수 있습니다.
속도 제한 – 기본 Google 및 Meta API는 자체 할당량을 적용합니다. 대규모 자동화에는 추가 할당량 요청이 필요할 수 있습니다.
기능 동등성 – 목록이 광범위하지만 일부 틈새 Google Ads 또는 Meta Marketing API 기능은 아직 MCP 도구로 래핑되지 않았을 수 있습니다.

TL;DR

google-ads-meta-ads-mcp는 Google Ads, Meta Ads, GA4 API를 단일 원격 MCP 서버에 번들로 제공하여 AI 어시스턴트가 자연어 도구로 호출할 수 있게 합니다. 개별 API 키, 개발자 토큰, 자체 호스팅 서버의 필요성을 제거하고 마케터와 AI 에이전트 개발자에게 읽기/쓰기 액세스(승인 포함)를 제공합니다. 저장소에는 서버 구현, 250개 이상의 도구 카탈로그, 인기 있는 LLM 인터페이스용 단계별 연결 가이드가 포함되어 있습니다.