개요

Google Ads MCP 서버는 Google의 공식 오픈소스 Model Context Protocol(MCP) 구현체입니다. 이 서버는 대규모 언어 모델(LLM)과 Google Ads API 사이의 안전하고 표준화된 연결 브릿지 역할을 합니다.

이 서버를 통해 AI 에이전트는 자연어 질문(예: "이번 주 내 캠페인 성과는 어때?" 또는 "상위 성과 키워드 목록을 보여줘")을 사용해 캠페인 데이터, 성과 지표, 예산, 키워드, 계정 정보를 조회할 수 있습니다. 커스텀 API 코드 작성이나 복잡한 인증 흐름 관리 없이도 가능합니다.

현재는 읽기 전용(캠페인 생성이나 수정 같은 쓰기 작업 불가)으로 제공되며, Gemini CLI/Code Assist 같은 도구에 최적화되어 활발히 관리되고 있습니다. Claude Desktop, Cursor 및 기타 MCP 클라이언트와도 완벽히 호환됩니다.

주요 기능

자연어 접근: "이번 주 내 캠페인 성과는 어때?" 또는 "상위 성과 키워드 목록을 보여줘" 같은 질문으로 구조화된 답변 획득.
GAQL 지원: 강력한 맞춤형 리포트 작성을 위한 Google Ads Query Language 전체 접근.
다중 계정 지원: 접근 가능한 고객 및 관리자 계정을 나열하는 도구 제공.
로컬 및 안전: 적절한 OAuth/서비스 계정 자격 증명으로 사용자 기기에서 완전히 실행.
별도 연결 코드 불필요: MCP 표준을 통해 AI 클라이언트가 자동으로 도구를 발견하고 사용.
Python 기반: GitHub 저장소에서 pipx로 직접 손쉬운 설치.

작동 방식

이 서버는 로컬 MCP 엔드포인트(stdio 전송 방식)로 실행됩니다. AI 클라이언트에 연결되면:

LLM이 사용 가능한 도구(search 및 list_accessible_customers)를 발견합니다.
사용자 질문을 바탕으로 GAQL 쿼리를 생성합니다.
서버는 Google Ads API를 통해 인증하고 깔끔하게 구조화된 결과를 반환합니다.
결과는 분석 및 요약을 위해 LLM 컨텍스트로 다시 주입됩니다.

설정 및 설치

필수 조건

Google Ads 개발자 토큰
Google Ads API가 활성화된 Google Cloud 프로젝트
OAuth 자격 증명(credentials.json) 또는 서비스 계정
Python + pipx 설치

빠른 시작

pipx를 통해 실행:

pipx run git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

필수 환경 변수와 함께 MCP 클라이언트(예: Gemini의 settings.json 또는 Claude/Cursor 설정)를 구성합니다:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": ["run", "--spec", "git+https://github.com/googleads/google-ads-mcp.git", "google-ads-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json",
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token"
      }
    }
  }
}

사용 가능한 도구

search: 캠페인, 광고, 키워드, 지표, 예산 등을 가져오기 위한 모든 GAQL 쿼리 실행.
list_accessible_customers: 접근 가능한 모든 고객 ID와 이름 반환(관리자 계정에 유용).

사용 사례

캠페인 분석: 실시간 성과 요약 확인, 저조한 성과를 보이는 광고 식별, 또는 계정 간 지표 비교
보고 자동화: 주간 보고서 생성 또는 Google Ads 대시보드 접속 없이 트렌드 발견을 AI에 요청
키워드 및 경쟁사 통찰: 자연어 질의를 통한 키워드 성과 확인 및 최적화 아이디어 도출
에이전시 워크플로: AI 에이전트가 다중 계정에 걸친 클라이언트 보고 및 진단 지원
다중 MCP 오케스트레이션: 전환 퍼널 마케팅 에이전트 구성을 위해 다른 MCP 서버(Notion, 캘린더, 분석)와 결합

제한 사항 및 보안 참고사항

현재 릴리스에서는 읽기 전용 모드 (캠페인 생성 또는 수정 불가)
데이터는 연결된 AI 에이전트/LLM에 노출됨 — 신뢰할 수 있는 클라이언트만 연결하세요
유효한 Google Ads 자격 증명 및 개발자 토큰 필요
분석 및 진단에 최적화됨; 향후 릴리스에서 전체 쓰기 기능이 추가될 수 있음

시작하기

최신 코드, 이슈 및 업데이트는 공식 저장소 github.com/googleads/google-ads-mcp를 방문하세요. 또한 Google Ads API MCP 개발자 가이드를 확인하세요.

Google Ads MCP 서버는 에이전트 기반 광고를 향한 중요한 진전입니다 — Google Ads 데이터를 대화형 AI 네이티브 자원으로 전환합니다.

개요