Google Ads MCP Server

Google Ads 관리를 위한 완전한 MCP 서버로, 전체 CRUD, 대시보드 보기, 보고서 및 Google Ads 패널에서 사용 가능한 모든 기능을 관리합니다.

기능 (85개 이상의 도구)

계정 및 고객

• list_accessible_customers — 접근 가능한 계정 나열

• get_customer_details — 계정 세부 정보

• list_customer_clients — MCC 하위 클라이언트

• update_customer — 설정 업데이트

• get_account_hierarchy — 계정 계층 구조

• get_change_history — 변경 내역

캠페인 (전체 CRUD)

• list_campaigns — 필터로 캠페인 나열

• get_campaign — 캠페인 전체 세부 정보

• create_campaign — 캠페인 만들기 (Search, Display, Shopping, Video, Performance Max 등)

• update_campaign — 이름, 상태, 입찰가, 날짜 업데이트

• remove_campaign — 캠페인 제거

• get_campaign_performance — 성과 지표

• copy_campaign — 캠페인 설정 복사

광고 그룹 (전체 CRUD)

• list_ad_groups — 광고 그룹 나열

• get_ad_group — 그룹 세부 정보

• create_ad_group — 광고 그룹 만들기

• update_ad_group — 설정 업데이트

• remove_ad_group — 그룹 제거

• get_ad_group_performance — 성과 지표

광고 (전체 CRUD)

• list_ads — 광고 나열

• get_ad — 광고 세부 정보

• create_responsive_search_ad — 헤드라인과 설명으로 RSA 만들기

• update_ad_status — 광고 활성화/일시중지

• remove_ad — 광고 제거

• get_ad_performance — 성과 지표

키워드 (전체 CRUD)

• list_keywords — 품질평가점수와 함께 키워드 나열

• add_keywords — 키워드 추가 (정확히 일치, 구문 일치, 광범위 일치)

• update_keyword — 입찰가, 상태, URL 업데이트

• remove_keyword — 키워드 제거

• get_keyword_performance — 노출 점유율 포함 성과

• get_search_terms — 검색어 보고서

• add_negative_keywords — 부정 키워드 추가 (캠페인 또는 그룹)

예산 및 입찰 전략

• list_budgets — 예산 나열

• create_budget — 예산 만들기

• update_budget — 금액/전달 방법 업데이트

• remove_budget — 예산 제거

• list_bidding_strategies — 전략 나열

• create_bidding_strategy — 전략 만들기 (Target CPA, Target ROAS 등)

• update_bidding_strategy — 전략 업데이트

• remove_bidding_strategy — 전략 제거

오디언스 및 타겟팅

• list_audiences — 오디언스/사용자 목록 나열

• get_audience_performance — 오디언스 성과

• list_campaign_targeting — 타겟팅 기준

• add_campaign_location_targeting — 지역 타겟팅

• add_campaign_language_targeting — 언어 타겟팅

• add_ad_schedule — 광고 일정 (dayparting)

• remove_campaign_criterion — 기준 제거

• get_geo_target_constants — 지역 상수 검색

• get_demographics_performance — 인구통계 성과

자산 및 확장

• list_assets — 모든 자산 나열

• create_sitelink_asset — 사이트링크 만들기

• create_callout_asset — 콜아웃 만들기

• create_structured_snippet_asset — 구조화된 스니펫 만들기

• create_call_asset — 통화 확장 만들기

• create_price_asset — 가격 확장 만들기

• create_promotion_asset — 프로모션 확장 만들기

• create_lead_form_asset — 리드 양식 만들기

• link_asset_to_campaign — 캠페인에 자산 연결

• link_asset_to_ad_group — 광고 그룹에 자산 연결

• remove_asset — 자산 제거

• get_asset_performance — 자산 성과

• list_campaign_assets — 캠페인의 자산

• remove_campaign_asset — 자산 연결 해제

전환

• list_conversion_actions — 전환 작업 나열

• get_conversion_action — 전환 세부 정보

• create_conversion_action — 전환 작업 만들기

• update_conversion_action — 전환 업데이트

• remove_conversion_action — 전환 제거

• get_conversion_performance — 전환 성과

보고서 및 대시보드

• execute_gaql_query — 사용자 지정 GAQL 쿼리 실행

• get_account_dashboard — 계정 전체 대시보드

• get_campaign_dashboard — 캠페인 상세 대시보드

• get_performance_by_device — 기기별 성과

• get_performance_by_network — 네트워크별 성과

• get_performance_by_hour — 시간별 성과

• get_performance_by_day_of_week — 요일별 성과

• get_geographic_performance — 지역별 성과

• get_landing_page_performance — 랜딩 페이지 성과

• compare_date_ranges — 기간 비교

라벨 및 공유 세트

• list_labels — 라벨 나열

• create_label — 라벨 만들기

• remove_label — 라벨 제거

• apply_label_to_campaign — 캠페인에 라벨 적용

• apply_label_to_ad_group — 광고 그룹에 라벨 적용

• list_shared_sets — 공유 목록 나열

• create_shared_set — 공유 부정 목록 만들기

• add_shared_set_criteria — 목록에 용어 추가

• link_shared_set_to_campaign — 캠페인에 목록 연결

추천 및 최적화

• list_recommendations — Google 추천 나열

• apply_recommendation — 추천 적용

• dismiss_recommendation — 추천 무시

• get_optimization_score — 최적화 점수

실험 및 변경

• list_experiments — A/B 테스트 나열

• list_experiment_arms — 변형 나열

• get_change_status — 최근 변경 사항

사전 요구 사항

1. Google Ads API가 활성화된 Google Cloud 프로젝트

2. OAuth2 클라이언트 ID (데스크톱 유형)

3. Google Ads 개발자 토큰 (ads.google.com > API 센터에서 획득)

4. Node.js >= 18

설치

npm install
npm run build

구성

옵션 1: 환경 변수

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

옵션 2: 대화형 설정

npm run auth

이렇게 하면 ~/.google-ads-mcp/credentials.json에 자격 증명 파일이 생성됩니다.

Claude Code에서 구성

~/.claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

사용법

구성 후 모든 도구가 MCP를 통해 사용 가능합니다. 예:

• "활성 캠페인을 모두 나열해 줘"

• "하루 예산 R$50으로 검색 캠페인을 만들어 줘"

• "지난 30일 성과 대시보드를 보여 줘"

• "이 키워드들을 광고 그룹 X에 추가해 줘: ..."

• "캠페인 Y를 일시중지해 줘"

• "검색어 보고서를 보여 줘"

• "Google이 내 계정에 추천하는 것은 무엇인가요?"

API 버전

이 서버는 Google Ads API v23 (2026년 1월 출시된 최신 버전)을 사용합니다.

프로젝트 구조

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions