Google Ads MCP 연결 방법: Google 서버를 Claude에 연결하기

Google Ads MCP 서버는 읽기 전용인가?

Google 페이지의 설명과 달리, 기본 설정에서는 읽기 전용이 아닙니다.

Google Ads MCP server

Read-only. This implementation is strictly read-only. It cannot modify bids, pause campaigns, or create new assets.

README에는 도구 7개가 나와 있으며, 이 중 3개는 읽기 도구입니다: search, get_resource_metadata, list_accessible_customers.

나머지 4개는 쓰기 도구입니다: create_asset, upload_video_asset, manage_labels, manage_label_associations. 모두 Google이 Propose and Confirm이라 부르는 단계를 거칩니다. 도구가 먼저 변경 내용 설명과 체크섬(해당 요청에만 연결된 코드)을 반환하고, 사용자가 승인한 뒤 그 코드가 돌아와야 실행됩니다.

7개 도구 중 입찰가 변경, 캠페인 일시중지, 예산 수정이 가능한 도구는 없습니다. 서버를 읽기 전용으로 고정하려면 tools_config.yaml에서 labels: false과 assets: false를 설정하면 됩니다.

서버에 어떤 접근 권한이 필요한가?

Google Ads API 접근 권한이 있는 Google Cloud 프로젝트, OAuth 로그인, 해당 계정을 볼 수 있는 Google 계정이 필요합니다. OAuth는 “Google로 로그인” 창을 말합니다. Google 토큰 페이지는 “2026년 9월 9일부로 개발자 토큰을 종료했다”고 밝히며, 접근 수준은 이제 “Google Cloud Console 프로젝트에 부여된다”고 설명합니다.

Explorer는 운영 계정에서 하루 2,880건의 작업을 허용하며, 계정 하나의 리포트를 읽기에는 충분합니다. Google 서버 페이지는 Explorer, Basic, Standard 중 하나를 요구하므로, Test 수준의 프로젝트로는 실제 계정을 읽을 수 없습니다.

Google이 공지한 오류에 주의해야 합니다. 9월 9일 이후 업그레이드된 일부 프로젝트에서는 운영 환경 호출 시 AUTHORIZATION_ERROR 오류가 발생합니다. Google은 수정 사항이 배포되는 동안 임시 해결책으로, 새 Cloud 프로젝트를 만들어 Explorer를 새로 신청하는 방법을 안내합니다.

Google Ads를 Claude에 연결하는 방법

아래 단계는 Claude Code 기준으로 Google README를 따른 것입니다. 서버는 사용자의 PC에서 실행됩니다.

1. 서버를 실행하는 도구인 pipx와, 로그인을 처리하는 Google gcloud 명령줄 도구를 설치합니다.
2. Google Cloud 프로젝트에서 Google Ads API를 활성화한 뒤, API Overview 페이지에서 Explorer를 신청합니다.
3. OAuth 클라이언트를 만듭니다. 동의 화면에 스코프 https://www.googleapis.com/auth/adwords를 추가하고, 상태가 Testing이면 본인을 테스트 사용자로 등록합니다. Testing 상태에서는 Google 대상 규칙에 따라 등록된 테스트 사용자만 로그인할 수 있고, 로그인은 7일 후 만료됩니다.
4. 로그인한 뒤 출력되는 인증 정보 경로를 복사합니다:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

5. ~/.claude.json의 mcpServers 아래나 프로젝트의 .mcp.json에 서버를 추가합니다. Google README에는 ~/.claude/settings.json가 안내되어 있고, Claude Code 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": "/path/to/credentials.json"
      }
    }
  }
}

6. 관리자 계정(MCC)으로 작업한다면 같은 env 블록에 GOOGLE_ADS_LOGIN_CUSTOMER_ID를 추가합니다.
7. 재시작한 뒤 Claude에게 접근 가능한 고객 목록을 보여 달라고 요청합니다.

웹 버전 Claude는 과정이 더 깁니다. 커스텀 커넥터에는 인터넷에서 접근 가능한 서버 주소가 필요하므로, OAuth 클라이언트와 함께 Cloud Run에 서버를 직접 호스팅해야 합니다. Google은 이 클라이언트 없이 --allow-unauthenticated 옵션으로 배포하지 말라고 경고합니다. 누구나 컨테이너 계정을 사용할 수 있게 되기 때문입니다.

비용 없이 할 수 있는 안전 조치가 하나 있습니다. adwords 스코프는 조회와 변경을 모두 포함하므로, 읽기 전용 제한은 도구 목록에서 걸립니다. Ads 권한이 읽기 전용인 Google 계정으로 로그인하면 Google 접근 규칙에 따라 계정 차원에서 캠페인 수정이 차단됩니다.

서버는 무엇을 읽을 수 있는가?

GAQL로 접근할 수 있는 데이터는 모두 읽을 수 있습니다. GAQL(Google Ads Query Language)은 Google의 리포트용 쿼리 언어이며, Claude가 대신 작성합니다. 캠페인, 검색어, 예산, 상태, 변경 내역 모두 search 도구로 조회할 수 있습니다.

Use the Google Ads server. For the last 30 days, list search terms with spend and no conversions.
Sort by spend, show the top 50, and give spend in my account currency. Change nothing.

답변에 나온 금액은 반드시 확인해야 합니다. API는 금액을 마이크로 단위로 반환하며, Google 레퍼런스는 100만 마이크로를 해당 통화 1단위로 정의합니다. 표를 믿기 전에 Claude에게 환산 예시를 하나 보여 달라고 요청해야 합니다.

계정 데이터는 모델에도 전달됩니다. README는 서버가 “연결된 에이전트나 LLM에 사용자의 데이터를 노출한다”고 밝히고 있으며, 고객사 계정이라면 특히 중요한 부분입니다.

맡길 작업 3가지, 직접 할 작업 3가지

이 서버의 설정 수고는 조회 작업에서 보상받습니다. 돈이 움직이는 작업은 사용자가 직접 맡아야 하며, 서버의 도구로는 어차피 할 수 없습니다.

Smart Bidding은 Google의 자동 입찰 방식입니다. 제외 키워드는 특정 검색어에 광고를 노출하지 않도록 Google에 알려 주는 키워드입니다.

Creatify Google Ads Agent가 변경안 초안을 작성

Creatify Google Ads Agent는 위 표의 뒤쪽 절반을 승인만 하면 처리되도록 하려는 사용자를 위한 방법입니다. 가격 페이지에는 Ad Agent 지원 대상이 Meta, TikTok, AppLovin으로 나와 있고 Google은 언급되지 않으므로, 결제 전에 Creatify에 플랜 적용 여부를 확인해야 합니다.

Google 계정으로 로그인하면, Creatify 워크스페이스의 소유자나 관리자가 관리자 계정을 포함해 연결할 계정을 선택합니다. 공식 Google Ads API로 작동합니다.

검색어, 노출 점유율, 품질 평가 점수, 입찰 경쟁 분석, 30일간의 변경 내역을 읽습니다. 일시중지, 예산, 키워드, 제외 키워드 변경은 변경 전후 값이 담긴 카드로 표시되고, 사용자가 승인하면 실행됩니다. 무시한 카드는 72시간 뒤 만료됩니다. 삭제는 절대 하지 않습니다.

Creatify 페이지에는 한계가 세 가지 있습니다. 검색 캠페인을 만들고 기존 광고 그룹에 새 광고를 추가할 수는 있지만, Performance Max 캠페인은 만들지 못합니다. “전환수 최대화”, 목표 CPA, 목표 ROAS에서는 키워드 입찰가 초안도 작성하지 않습니다. 또 예약 루틴은 “달리 선택하지 않는 한 실행 전에 확인을 요청”하므로, 이 설정은 그대로 두는 편이 좋습니다.

Creatify는 작업별 비용을 공개하지 않으며, 에이전트는 “크레딧으로 실행”됩니다. 사용자들은 가격 안내보다 크레딧이 빨리 소진된다고 평가하며, 원인으로 에이전트 실행을 꼽습니다(출처 61곳 중 15곳: Trustpilot, Reddit).

영상 계획이 없는 검색 광고 전용 계정에는 Creatify가 맞지 않습니다. Creatify 스스로도 Google의 추천과 Ads Advisor가 자사 에이전트와 기능이 겹치며 “Google Ads 내에서 무료”라고 밝힙니다.

Creatify의 설명에 따르면 에이전트가 더하는 기능은 세 가지입니다. 다른 광고 계정과 함께 Google 광고를 읽고, 과거 이력으로 변경 사유를 설명하며, 같은 채팅에서 새 광고를 만듭니다. 더 넓은 범위의 비교는 AI 미디어 바이어에서 확인할 수 있습니다.

영상의 자리: Performance Max, Demand Gen, YouTube

영상은 Creatify 에이전트가 Google 서버보다 앞서는 부분입니다. 영상을 만들고, 승인 후 기존 Performance Max 에셋 그룹에 추가할 수 있습니다. Performance Max는 Google의 전 채널 캠페인이고, 에셋 그룹은 광고 소재 묶음입니다.

Creatify 페이지에는 Demand Gen이나 YouTube 캠페인에 대한 언급이 없습니다. 이 경우 Creatify에서 파일을 만든 뒤 직접 옮겨야 합니다. Demand Gen은 YouTube, Discover, Gmail에 시각형 광고를 내보내는 Google 캠페인이며, 영상 규정이 엄격합니다:

• 영상은 이미 YouTube에 올라와 있어야 합니다. “오프라인 영상은 업로드할 수 없습니다”, 다만 일부 공개 영상은 사용할 수 있습니다.
• 최소 길이는 5초이며, “10초보다 짧은 영상은 YouTube 인스트림에 게재되지 않습니다.”
• 광고 하나에 영상 1~5개를 넣을 수 있으며, YouTube Shorts에는 1080×1920 비율을 권장합니다.

Google 서버는 이제 중간 단계를 도와줍니다. 로컬 모드에서 upload_video_asset는 영상 파일을 YouTube에 올리고, create_asset는 이를 에셋으로 등록하며, 둘 다 확인 단계를 거칩니다. 도구 목록에는 이 에셋을 캠페인에 연결하는 기능이 없으므로, 마무리는 Google Ads에서 해야 합니다.

Claude나 ChatGPT에서 영상 광고 만들기에서는 채팅으로 영상 파일을 만드는 방법을 알려 줍니다. YouTube Shorts 광고에서는 해당 포맷을 다룹니다.

Google Ads MCP 서버 자주 묻는 질문

Google Ads MCP에 아직도 개발자 토큰이 필요한가?

아닙니다. Google은 2026년 9월 9일 개발자 토큰을 종료했습니다. 이제 접근 권한은 OAuth 로그인에 연결된 Google Cloud 프로젝트를 따릅니다.

Google Ads MCP 서버는 무료인가?

두 Google 페이지 모두 가격을 밝히지 않습니다. 코드는 직접 실행하며, Cloud Run 호스팅 비용은 Google Cloud 계정으로 청구됩니다.

Google Ads MCP로 캠페인을 일시중지하거나 예산을 바꿀 수 있나?

아닙니다. README의 도구 7개는 쿼리 실행, 에셋·라벨 관리, 영상 업로드를 처리합니다. 입찰가, 캠페인 상태, 예산을 바꾸는 도구는 없습니다.

Claude Code뿐 아니라 Claude 앱에서도 작동하나?

네, 다만 작업이 더 필요합니다. Claude Code는 설정 파일로 로컬에서 실행합니다. Claude 웹 앱은 서버를 인터넷에 호스팅하고 OAuth 클라이언트를 갖춰야 합니다.

설정 하나로 여러 고객 계정에 접근할 수 있나?

네. GOOGLE_ADS_LOGIN_CUSTOMER_ID를 관리자 계정으로 설정하면, 서버가 그 아래에서 로그인 계정이 볼 수 있는 계정에 접근합니다.

작업별로 정리한 Creatify 사용자용 페이지는 Creatify 허브에 →