Google Ads MCP 입문: 연결 확인부터 첫 성과 리포트까지

Google Ads MCP로 광고 성과를 조회하는 흐름과 첫 결과 확인법을 설명합니다. 현재 인증 요건, 계정 선택, 비용 단위와 검색어 검토 순서를 정리했습니다.

홍승협(준이아빠)게시 2026.08.01수정 2026.10.04약 23분

지금까지 100명 넘게 읽었어요, 83%가 끝까지 읽었어요

#Google 광고 #자동화 #AI #마케팅 실무

Google Ads MCP 입문: 연결 확인부터 첫 성과 리포트까지 대표 이미지

준이아빠AI가 일하는 법AI 친구들의 작업실 구경하기 ↗

구글 애즈 MCP로 어떤 리포트를 만들 수 있을까요?
읽기 전용이라는 뜻과 조회의 범위
준비물은 Cloud 프로젝트와 계정 접근 권한입니다
로컬 연결은 네 단계로 확인합니다
리포트는 어떻게 물어봐야 할까요?
숫자가 나와도 끝이 아닌 경우
3줄 요약

세 줄로 먼저 읽기

Google Ads MCP는 구글이 공식 배포하는 읽기 전용 오픈소스 서버로, 클로드나 제미나이 같은 AI가 광고 계정의 성과를 조회하게 합니다.
2026년 9월 9일 개발자 토큰이 종료돼 새 연결에는 Cloud 프로젝트의 API 접근 수준과 ADC 인증, 대상 계정의 조회 권한이 필요합니다.
비용은 cost_micros를 100만으로 나눈 계정 통화 값이며, 서버는 입찰 변경이나 제외어 등록을 하지 않으므로 바꿀 내용은 광고 화면에서 직접 바꿉니다.

구글 애즈 MCP는 구글이 공식 배포하는 광고 계정 조회용 오픈소스 서버입니다. 클로드나 제미나이 같은 AI 도구에 연결해 두면 광고 관리자 화면을 열지 않고도 계정 성과를 말로 묻고 표나 리포트로 받습니다.

첫 목표는 계정 하나의 지난 7일 캠페인 표를 받아 광고 화면의 숫자와 맞춰 보는 것입니다. MCP를 연결하는 일과 정기 리포트가 자동으로 실행되도록 예약하는 일은 별개라서, 이 글은 연결과 첫 조회까지 다룹니다.

MCP라는 용어가 처음이라면 비전문가를 위한 MCP 쉽게 이해하기에 개념을 풀어 두었습니다. 짧게 말하면 AI가 외부 서비스에 접근하는 방식을 하나로 맞춘 규격입니다.

구글 애즈 MCP로 어떤 리포트를 만들 수 있을까요?

연결한 뒤에는 필요한 지표와 기간을 문장으로 요청합니다. 답을 받으면 AI가 어떤 계정과 조회 조건을 골랐는지도 함께 봅니다. 목적이 다른 리포트 두 가지를 예로 듭니다.

첫 번째는 계정 전체를 훑는 주간 성과 리포트입니다. 매일 아침이나 매주 월요일에 보는 형태입니다.

그림은 리포트 구성 예시이고 숫자는 예시 값입니다. 비용, 클릭, 전환 같은 지표를 조회한 뒤 AI에게 표와 그래프로 정리해 달라고 하면 이런 화면을 만들 수 있습니다. CTR은 클릭률, CPC는 클릭당 비용입니다. 검색 노출 점유율은 노출될 수 있었던 기회 가운데 실제로 노출된 비율이며, 캠페인 유형에 따라 제공되지 않기도 합니다. 비율이라서 캠페인끼리 더해 계정 전체 값을 만들 수 없습니다.

두 번째는 검색 캠페인에서 비용에 비해 성과가 낮은 검색어를 찾는 진단 리포트입니다.

이 그림도 구성 예시입니다. ‘절감 가능 비용’은 예시 계산값이고 확정된 절감액이 아닙니다. 전환 0건은 조회 기간과 측정 조건 안에서 전환이 잡히지 않았다는 뜻이라서, 전환이 늦게 잡히는 업종이면 나중에 전환이 생기기도 합니다. 검색어는 고객이 입력한 말이고, 키워드는 광고주가 등록한 조건입니다. 검색어 보고서에는 실제 검색어가 모두 나오지 않습니다. 검색어 비용 비율을 적을 때는 분모가 조회된 검색어의 비용인지 전체 캠페인 비용인지 함께 적습니다.

두 리포트 모두 조회에서 끝납니다. 제외 후보 검색어는 찾아 주지만 제외어로 등록하지는 않습니다. 이유는 다음 절에 있습니다.

읽기 전용이라는 뜻과 조회의 범위

현재 공식 서버에는 입찰 변경, 캠페인 중지, 소재 생성 기능이 없습니다. 읽기 전용이어도 조회한 광고 데이터는 연결한 AI 서비스로 넘어가므로, 회사 계정이라면 그 AI 서비스의 데이터 취급 조건을 미리 봅니다.

공식 서버로 할 수 있는 일

작업	가능 여부	쓰는 도구
접근 가능한 계정 목록	제공	list_accessible_customers
캠페인, 검색어 성과 조회	제공	search
조회할 필드 정보 확인	제공	get_resource_metadata
입찰 변경, 캠페인 중지	제공하지 않음	–
소재 생성, 제외어 등록	제공하지 않음	–

설치 설정에 따라 도구 이름 앞에 접두어가 붙기도 합니다.

도구는 세 개지만 조회할 수 있는 항목은 훨씬 많습니다. search 도구 하나가 Google Ads의 조회 언어인 GAQL로 캠페인, 키워드, 검색어 같은 여러 보고서를 조회하기 때문입니다. 쿼리에 존재하지 않는 필드나 함께 쓸 수 없는 필드를 넣으면 오류가 나고, 문법이 맞아도 기간이나 집계 대상을 잘못 고르면 엉뚱한 숫자가 나옵니다. 그래서 숫자를 받을 때는 사용한 계정, 기간, 필드와 쿼리도 함께 보여 달라고 합니다.

PMax(실적 최대화 캠페인)의 소재 성과도 일부는 API로 조회할 수 있습니다. 반면 자동 입찰의 내부 판단이나 특정 결과가 나온 원인은 조회 대상이 아닙니다. 필드별 단위와 지원 범위는 API 필드와 지표 입문에 정리했습니다.

연결 방식은 두 가지입니다. 내 컴퓨터에서 서버를 실행해 AI 앱과 바로 주고받는 stdio 방식과, Google의 프로그램 실행 서비스인 Cloud Run에 서버를 직접 배포해 HTTP 주소로 연결하는 방식입니다. 두 방식 모두 Google Ads MCP 통합 가이드에 설명이 있습니다. 이 글은 설치가 간단한 stdio 방식을 다룹니다.

준비물은 Cloud 프로젝트와 계정 접근 권한입니다

Google은 2026년 9월 9일 개발자 토큰을 종료하고 API 접근 관리를 Cloud 프로젝트로 옮겼습니다. 그래서 새 연결에는 GOOGLE_ADS_DEVELOPER_TOKEN을 넣지 않고, API 사용 신청도 Cloud Console에서 합니다.

연결 전에 갖출 다섯 가지

1. Cloud 프로젝트Google Ads API 사용 설정
접근 수준 Explorer 이상
2. 광고 계정 권한인증할 사용자가
대상 계정을 조회 가능
3. 인증 파일로컬 연결은
ADC 파일
4. MCP 지원 앱로컬 서버를
실행할 수 있는 AI 앱
5. 실행 도구Python 환경과
pipx

OAuth는 사용자가 앱에 계정 접근을 승인하는 방식입니다. ADC(Application Default Credentials)는 프로그램이 쓸 Google 인증 정보를 정해진 위치에서 찾는 방식입니다. OAuth 클라이언트 설정 파일과 승인 뒤에 만들어지는 ADC 파일은 서로 다른 파일입니다.

MCC는 여러 광고 계정을 묶어 관리하는 상위 관리자 계정입니다. 새 API 신청은 MCC 없이도 할 수 있습니다. 관리자 계정을 거쳐 접근한다면 로그인 기준이 되는 관리자 ID와 실제로 조회할 광고 계정 ID를 따로 적어 둡니다.

접근 수준 안내에 따르면 실제 계정을 조회하려면 Cloud 프로젝트의 접근 수준이 Explorer, Basic, Standard 가운데 하나여야 합니다. Test 수준은 테스트 계정만 조회합니다. 현재 수준은 Cloud Console의 프로젝트 화면에 표시됩니다.

로컬 연결은 네 단계로 확인합니다

ADC를 쓰는 로컬 연결 순서입니다. 단계마다 무엇이 보이면 다음으로 넘어가는지 함께 적었습니다. 이미 연결이 되는 환경이라면 다시 설치하지 않고 4단계만 합니다.

로컬 연결 순서와 성공 표시

1. 저장소 확인설치 요건과 버전
조직은 검토한 버전 기록
2. 인증adwords 범위로 승인
ADC JSON 파일 생성
3. 앱에 등록mcpServers 설정 추가
도구 목록이 보이면 성공
4. 작은 조회계정 목록 뒤 캠페인 표
광고 화면 합계와 같으면 성공

1. 공식 서버와 실행 방식을 확인합니다

공식 저장소에서 설치 요건과 현재 버전을 봅니다. pipx는 Python으로 만든 명령형 프로그램을 다른 프로그램과 분리된 환경에서 실행하는 도구입니다. 아래 설정은 Git 주소에서 저장소 코드를 받아 바로 실행하므로, 회사에서 쓴다면 검토한 버전을 기록해 둡니다.

2. 광고 계정에 접근할 인증을 준비합니다

공식 README의 ADC 설정을 따릅니다. 사용자 인증이라면 광고 계정에 접근할 수 있는 Google 사용자로 승인하고, 승인 범위에 Google Ads API의 adwords가 들어가게 합니다. 승인이 끝나면 생성된 ADC JSON 파일의 경로를 3단계에서 씁니다. 프로젝트 ID만 적거나 OAuth 클라이언트 JSON을 ADC 파일 대신 넣으면 인증이 끝나지 않습니다.

인증 파일 내용과 토큰은 AI에게 하는 질문이나 보고서에 넣지 않습니다. 오류를 공유할 때도 값은 지우고, 오류 코드와 몇 단계에서 났는지만 남깁니다.

3. 사용하는 앱의 MCP 설정에 등록합니다

다음은 mcpServers 형식을 쓰는 앱의 설정 예시입니다. 설정 파일의 이름과 위치는 앱마다 다르므로 쓰는 앱의 MCP 안내를 따릅니다. 기존 설정 파일이 있다면 전체를 덮어쓰지 말고 google-ads-mcp 항목만 추가합니다.

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": ["run", "--spec", "git+https://github.com/googleads/google-ads-mcp.git", "google-ads-mcp"],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/adc.json"
      }
    }
  }
}

두 예시 값을 실제 프로젝트 ID와 ADC 파일의 절대 경로로 바꿉니다. 관리자 계정을 거쳐 조회할 때만 GOOGLE_ADS_LOGIN_CUSTOMER_ID를 추가하거나 지원되는 호출 인자로 관리자 ID를 넘깁니다. ID에는 하이픈을 넣지 않습니다. 저장한 뒤 앱에서 MCP 서버를 다시 연결해 도구 목록에 세 도구가 보이면 등록이 끝난 것입니다. pipx를 찾지 못한다는 오류가 나면 같은 설정을 다시 추가하지 말고, pipx가 설치됐는지와 앱이 쓰는 실행 경로에 pipx가 있는지 봅니다.

4. 계정 목록 다음에 작은 조회를 합니다

먼저 ‘이 서버로 직접 접근할 수 있는 계정 ID를 보여 줘’라고 요청합니다. 목록에 관리자 계정만 보이면 하위 계정은 관리자 계정을 거쳐 조회하는 구조입니다. 이때는 대상 하위 계정 ID와 관리자 ID 설정을 맞춘 뒤 캠페인 조회를 요청합니다.

대상 광고 계정: 내가 지정한 계정 ID
기간: 오늘을 제외한 지난 7일, 계정 시간대 기준
캠페인 ID와 이름, 비용, 클릭, 전환수를 표로 보여줘.
계정 통화를 먼저 확인하고 cost_micros를 100만으로 나눠줘.
원화 환산은 하지 말고 계정 통화를 표시해줘.
조회에 사용한 기간, 필터와 GAQL도 함께 보여줘.

cost_micros는 비용을 100만 배 한 정수로 돌려주는 필드라서, 100만으로 나눠야 계정 통화 금액이 됩니다. 표를 받으면 광고 화면에서 같은 기간과 조건으로 비용 합계를 띄워 맞춰 봅니다. 두 합계가 같으면 첫 리포트 확인이 끝납니다.

실패한 단계로 원인 좁히기

증상	먼저 볼 것
서버 연결 자체가 안 됨	pipx 실행 경로와 인증 파일 경로
계정 목록은 나오는데 캠페인 조회가 실패	대상 계정 권한과 관리자 ID 설정
표는 나오는데 합계가 광고 화면과 다름	기간, 시간대, 통화 단위

웹 브라우저에서 쓰는 AI 앱에 연결하려면 HTTP 서버를 운영하고, 그 앱의 연결 기능과 인증을 따로 갖춰야 합니다. Cloud Run 배포에는 운영 비용과 서버 관리가 따르고, 로컬 연결에는 이런 배포가 필요하지 않습니다.

리포트는 어떻게 물어봐야 할까요?

같은 리포트를 매주 받으려면 계정 ID, 기간, 통화, 지표 정의를 먼저 정해 두고 질문마다 똑같이 씁니다. 아래 네 단계는 계정 전체에서 시작해 검토할 대상을 좁혀 가는 순서입니다.

성과 리포트 질문 순서

1. 계정 상태지난 7일 캠페인
비용 순 표
2. 예산 손실예산 부족 손실
10% 넘는 캠페인
3. 검색어 후보클릭 50회 이상
전환 0건, 30일
4. 질문 저장질문, 지표 정의
리포트 양식

1단계: 계정 상태 확인

가장 먼저 하는 질문입니다.

지난 7일 동안 집행된 캠페인을 비용 순으로 정리하고, 캠페인별 노출, 클릭, CTR, 평균 CPC, 전환, 전환당 비용을 표로 보여 줘.
비용은 마이크로 단위를 변환한 뒤 계정 통화를 표시해 줘.

기간, 지표, 정렬 기준, 출력 형태에 단위 변환까지 질문에 넣었습니다. 변환을 처음부터 적어 두면 비용이 100만 배로 부풀어 나오는 실수를 막습니다.

2단계: 예산에 걸린 캠페인 찾기

검색 캠페인이 예산 때문에 노출 기회를 놓치고 있는지 보는 질문입니다.

검색 캠페인의 검색 노출 점유율과 예산 부족으로 잃은 노출 점유율을 뽑아 줘.
예산 부족으로 잃은 노출 점유율이 10%를 넘는 캠페인을 검토 후보로 표시해 줘.
값이 없는 항목은 0으로 채우지 마.

10%는 검토 후보를 고르는 기준입니다. 손실 비율이 높은 캠페인이라도 예산을 늘릴지는 전환가치와 수익, 실제로 감당할 수 있는 예산 범위를 함께 보고 정합니다.

3단계: 검색어 검토 후보 찾기

앞에서 본 두 번째 리포트를 만드는 질문입니다.

지난 30일 검색어 중에서 클릭이 50회 이상인데 전환이 0건인 항목을 비용 순으로 20개 뽑아 줘.
각 검색어를 불러온 키워드도 같이 보여 줘.

클릭 50회는 검토 후보를 고르는 조건입니다. 실제로 제외할지는 전환 지연과 측정 누락, 검색 의도를 본 뒤 정하고, 제외어 등록은 광고 화면에서 직접 합니다.

4단계: 질문 묶음 저장하기

질문과 지표 정의, 리포트 양식을 한 문서에 함께 저장해 두면 다음 주에 같은 조건으로 다시 요청할 수 있습니다. 저장한 질문이 매주 저절로 실행되지는 않습니다. 정기 실행에는 예약 기능과 실행 환경, 인증 유지, 실패 알림이 따로 필요합니다.

숫자가 나와도 끝이 아닌 경우

계정 목록이 나오고 캠페인 표도 나왔는데 단위가 틀린 경우가 있습니다. 아래는 계정 통화가 USD인데 비용을 원으로 표시한 예입니다.

Claude, Google Ads MCP 연결

지난 7일 캠페인별 비용을 비용 순 표로 보여 줘.

지난 7일 캠페인 3개를 비용 순으로 정리했습니다.
전체 비용 합계는 1,240원입니다.

계정 통화는 USD인데 원으로 표시했습니다

조회 결과의 계정 통화 코드는 USD

설명을 위해 만든 화면입니다. 숫자는 예시 값입니다.

이 경우 단위 표시를 계정 통화로 고쳐 달라고 한 뒤, 같은 조건의 광고 화면 합계와 맞춰 봅니다. 전환 0건 검색어 목록도 받는 즉시 제외하지 않고 전환 지연과 검색 의도를 본 뒤 판단합니다. 조회가 성공한 것과 그 숫자로 업무 판단을 해도 되는 것은 다른 단계입니다.

3줄 요약

Google Ads MCP는 구글이 공식 배포하는 읽기 전용 오픈소스 서버로, 클로드나 제미나이 같은 AI가 광고 계정의 성과를 조회하게 합니다.
2026년 9월 9일 개발자 토큰이 종료돼 새 연결에는 Cloud 프로젝트의 API 접근 수준과 ADC 인증, 대상 계정의 조회 권한이 필요합니다.
비용은 cost_micros를 100만으로 나눈 계정 통화 값이며, 서버는 입찰 변경이나 제외어 등록을 하지 않으므로 바꿀 내용은 광고 화면에서 직접 바꿉니다.

제대로 이해했는지 한 문제로 확인해 볼까요?

답을 고르면 바로 풀이가 나와요.

구글이 공식 배포하는 Google Ads MCP 서버로 할 수 없는 일은 무엇일까요?

이 글이 도움이 되었나요?

이 글 다음 배우기AI 업무 자동화 입문입문 코스 · 3편

메일, 회의록, 리포트처럼 반복되는 일을 AI로 자동화하는 순서와 안전장치를 다룹니다

코스 전체 보기 →

이어서 읽기 좋은 글AI 광고 표시 의무 총정리: 대상, 사례, 처벌 범위 →

AI 광고를 게시하기 전에 인물, 상품, 사업자 역할, 매체를 나눠 적용 규정을 고르는 방법과 가상인물 표시와 광고 표시의 차이, 시행 중인 규정과 시행 예정 조항을 질문 16개로 정리했습니다.

세 줄로 먼저 읽기

구글 애즈 MCP로 어떤 리포트를 만들 수 있을까요?

읽기 전용이라는 뜻과 조회의 범위

준비물은 Cloud 프로젝트와 계정 접근 권한입니다

로컬 연결은 네 단계로 확인합니다

1. 공식 서버와 실행 방식을 확인합니다

2. 광고 계정에 접근할 인증을 준비합니다

3. 사용하는 앱의 MCP 설정에 등록합니다

4. 계정 목록 다음에 작은 조회를 합니다

리포트는 어떻게 물어봐야 할까요?

1단계: 계정 상태 확인

2단계: 예산에 걸린 캠페인 찾기

3단계: 검색어 검토 후보 찾기

4단계: 질문 묶음 저장하기

숫자가 나와도 끝이 아닌 경우

3줄 요약

제대로 이해했는지 한 문제로 확인해 볼까요?

새 글과 AI 소식을 메일로 받아 보세요

함께 읽으면 좋은 글

관련 개념