Google Ads MCP 서버: 개발자 통합 가이드

모델 컨텍스트 프로토콜 (MCP)은 대규모 언어 모델 (LLM)이 외부 데이터 및 애플리케이션과 안전하게 상호작용할 수 있도록 지원하는 개방형 표준입니다. Google Ads MCP 서버는 Google Ads API에 대한 표준화된 브리지를 제공하여 AI 에이전트가 자연어를 사용하여 캠페인 데이터를 분석하고 검색할 수 있도록 합니다.

기술 개요

이 MCP 서버를 구현하면 Google Ads API 인증, 리소스 가져오기, 데이터 파싱을 위한 맞춤 '글루 코드'를 작성할 필요가 없습니다. 서버는 LLM이 자율적으로 검색하고 호출할 수 있는 특정 도구를 노출합니다.

주요 사양

  • 프로토콜: MCP (모델 컨텍스트 프로토콜)
  • 모드: 읽기 전용 (현재 버전)
  • 언어: Python
  • 전송: 표준 입력/출력 (stdio)
  • 인증: OAuth 2.0 또는 서비스 계정

상호작용 루프의 작동 방식

  1. 요청: 사용자가 '이번 주 캠페인 실적은 어때?'와 같은 질문을 제출합니다.
  2. 검색: LLM이 사용 가능한 도구를 검사하고 google-ads-mcp 검색 기능을 식별합니다.
  3. 실행: MCP 서버는 기본 Python 로직을 실행하여 Google Ads API를 쿼리합니다.
  4. 컨텍스트 삽입: 구조화된 결과가 LLM의 컨텍스트 창으로 반환됩니다.
  5. 대답: LLM이 데이터를 인간이 읽을 수 있는 대답으로 합성합니다.

시작하기

다음 단계에 따라 Google Ads MCP 서버를 구성하고 사용하세요.

기본 요건

구성하기 전에 Google Ads 개발자 콘솔에서 다음 사용자 인증 정보를 확인하세요.

  • 개발자 토큰: 고유한 22자리 액세스 문자열입니다.
  • 프로젝트 ID: Google Cloud 프로젝트 식별자입니다.
  • 사용자 인증 정보 파일: 승인된 credentials.json (OAuth 2.0 또는 서비스 계정)

구성

서버를 MCP 호환 호스트에 통합하려면 호스트의 MCP 구성 파일 (예: settings.json)을 사용합니다. 이 구성의 정확한 위치와 파일 이름은 호스트의 문서를 참고하세요.

JSON

{
  "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/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

핵심 기능 (도구)

서버는 계정 검색 및 실적 보고를 위해 설계된 도구를 노출합니다.

  • list_accessible_customers: 인증된 사용자가 액세스할 수 있는 Google Ads 고객 ID 및 계정 이름 목록을 반환합니다.
  • search: Google Ads 쿼리 언어 (GAQL) 요청을 실행하여 캠페인 측정항목, 예산, 상태를 가져옵니다.

시작을 위한 샘플 프롬프트

서버가 할 수 있는 작업 묻기:

What can the google-ads-mcp server do?

고객에 대해 질문하기:

What customers do I have access to?

캠페인에 대해 질문하기:

How many active campaigns do I have?
How is my campaign performance this week?

커뮤니티 리소스 및 지원