Claude/Cursor를 사용하여 MCP(Google Ads MCP 서버 설정)를 통해 Google Ads를 조회하는 방법

이 가이드 외에도 쿼리 스트림의 모든 기능 보기 무료로 시작하기

지원

+더 보기

라이브 데이터

내보내기를 온디맨드 SQL로 바꾸기

Excel 시트

BI 및 AI 분석

Nova에 문의하여 SQL + 차트 가져오기

노바 만나기

데이터베이스 REST API

파트너당 키 1개. 자격 증명은 공유되지 않습니다.

API를 구축하세요

+더 보기

자동화

6개 이상의 플랫폼에 예약 동기화

탐색

+더 보기

API에서 SQL로

코드 없이 SQL로 API 쿼리

탐색

+더 보기

AI 데이터베이스 MCP

Claude, Cursor, ChatGPT 및 Grok은 여러분의 데이터와 소통합니다.

Connect AI

Query Streams는 안전한 실시간 데이터 통합 플랫폼으로, 방화벽 변경 없이 단일 MCP 키를 통해 계정에 있는 모든 데이터베이스와 SaaS API를 Claude, Cursor, ChatGPT 및 Grok에 통합합니다. 이 가이드는 다음 과정을 안내합니다. 구글 광고 MCP 특히 이 경로를 통해 AI 도구는 Google Ads UI에서 보고서를 내보내거나 광고 편집기에서 또 다른 GAQL 쿼리를 작성할 필요 없이 캠페인, 광고 그룹, 검색어 및 전환에 대한 일반적인 질문에 답변할 수 있습니다. 네트워크 에이전트는 Ads API 데이터를 로컬 DuckDB 캐시에 가져오므로 LLM은 원시 REST 및 GAQL 대신 깔끔한 SQL 표면(캠페인, 키워드, 검색어, 전환)을 볼 수 있습니다. QueryStreams.com에서 더 자세히 알아보세요. 그리고 무료로 가입하세요 AI 도구에 실제 구글 광고 관련 질문을 해보세요.

Query Streams Google Ads MCP 서버가 제공하는 기능

오픈소스 환경에서 사용되는 다른 "Google Ads MCP" 서버들은 AI 도구를 Ads API에 직접 연결하고 원시 GAQL 쿼리를 전송합니다. 이 방식도 작동은 하지만, AI 클라이언트 설정에 Google OAuth 토큰을 추가하고, LLM(로컬 라이프사이클 관리자)은 SQL 대신 REST API 리소스와 필드 선택기만 사용하게 되며, AI 도구의 범위를 Google Ads로만 제한하고, AI가 실제로 어떤 쿼리를 수행했는지에 대한 감사 추적을 제공하지 않습니다. Query Streams의 Google Ads MCP 서버는 이러한 문제를 해결합니다. 하나의 키로 모든 커넥터를 연결하고, 완벽한 감사 추적을 제공하며, 에이전트는 Ads 데이터를 SQL 형식으로 정규화하고, AI 도구는 사용자의 Google 계정 정보를 저장하지 않습니다.

방화벽 포트를 열지 않고 작동하는 방식

쿼리 스트림 네트워크 에이전트는 인터넷에 접속할 수 있는 모든 호스트에 한 번 설치되며(광고 API는 어디에서든 접근 가능함), 클라우드로 나가는 TLS 링크 하나를 설정합니다. 에이전트는 내부적으로 GAQL을 사용하여 Google Ads API를 호출하고, 응답을 로컬 DuckDB에 캐시하여 AI가 깔끔한 SQL 표면을 볼 수 있도록 합니다.구글 광고 성과, 키워드, 검색어, 변환, 청중REST 봉투 대신 )를 사용하므로 AI 도구는 Google OAuth 토큰, 고객 ID 또는 개발자 토큰을 전혀 볼 수 없습니다. 발신 전용 연결 작동 방식 →

Cursor 또는 Claude에게 제공하는 MCP 키는 범위가 지정됩니다.읽다 / 분석하다 / 실행하다언제든지 취소 가능하며 키별로 사용 횟수가 제한됩니다. AI 도구는 이러한 MCP 도구를 호출하여 작업을 수행합니다.

스키마 인텔리전스가 Query Streams MCP를 차별화하는 이유는 무엇일까요?

오픈소스 환경에서 대부분의 "Google Ads용 MCP" 서버는 AI 도구에 Google이 개발자용으로 공개한 GAQL 필드 참조를 그대로 제공하거나, 더 나쁜 경우에는 원본 그대로 제공합니다. 정보 스키마 그들이 보관하는 캐시에 무엇이 있든 간에, 필드 이름, 데이터 유형, 어쩌면 기본 키까지 모두 추측해야 합니다. LLM은 이러한 정보를 추측할 수밖에 없습니다. 비용_마이크로 1,000,000으로 나누어야 합니다. 캠페인 상태 열거형입니다. 활성화됨 / 일시 중지됨 / 제거됨또는 세그먼트_날짜 "지난 30일"에 대한 올바른 파티션 열은 바로 이것입니다. 대부분의 LLM이 광고 스키마에 대해 처음 작성하는 SQL이 잘못된 이유는 LLM 자체에 문제가 있어서가 아니라, 필요한 데이터가 부족하기 때문입니다 (그리고 비용이 100만만큼 차이가 나는 오류는 슬랙 메시지로 이어질 수 있습니다).

Query Streams MCP는 캐시된 광고 스키마를 반환하는데, 이 스키마는 우리가 '추가 정보'라고 부르는 것으로 보강됩니다. 스키마 인텔리전스(SI) — AI가 선별한 메타데이터는 프로파일링 쿼리를 실행하여 생성됩니다. 실제 AI 클라이언트가 요청하기 전에 Google Ads 데이터가 수집됩니다. Google Ads 커넥터에서 SI가 활성화되면 AI가 호출하는 모든 스키마 도구가 수집됩니다.qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships) 캐시된 스키마와 선별된 지식 계층 6개를 반환합니다. LLM은 더 이상 추측하지 않습니다.

이를 구체적으로 설명하기 위해, AI 클라이언트가 단일 요청으로부터 받는 응답은 다음과 같습니다. qs_get_table_schema Google Ads 커넥터에 대한 이의 제기 구글 광고 성과 테이블 — 보고 질문의 90%를 차지하는 비정규화된 캠페인 + 광고 그룹 + 날짜 보기 —을 스키마 인텔리전스 없이 먼저 보여주고, 그 다음 스키마 인텔리전스를 적용하여 보여줍니다.

스키마 인텔리전스가 추가하는 6개 레이어

각 계층은 LLM이 추측해야 하는 특정 유형의 질문을 다룹니다. SI는 선택 사항입니다. (커넥터, 데이터베이스) 이 도구는 데이터에 대해 일회성 프로파일링 패스로 실행되며 스키마를 변경하거나 데이터베이스에 쓰지 않고 스키마가 변경될 때 점진적으로 새로 고쳐집니다.

프롬프트는 같지만 SQL 쿼리는 다릅니다.

증거는 AI 도구가 실제로 작성하는 SQL에 있습니다. 동일한 커서 세션, 동일한 Claude 모델, 동일한 프롬프트입니다. "지난 30일 동안 전환율 기준으로 가장 많은 비용을 지출한 캠페인은 무엇이며, 활성화된 캠페인만 고려했습니까?" 스키마 인텔리전스가 없으면 LLM은 추측해야 합니다. 하지만 스키마 인텔리전스가 있으면 LLM은 비용이 마이크로초 단위이고, 상태 열거형에 필터링이 필요하며, NULLIF 조건이 필요하다는 것을 알 수 있습니다.

MCP가 마음에 안 드시나요? 그렇다면 Nova AI를 사용해 보세요.

JSON 설정 부분을 완전히 건너뛰세요: Nova AI는 Query Streams 웹 포털에 내장되어 있습니다. 그리고 구글 광고에 대한 똑같은 쉬운 질문을 합니다.이번 달 예산을 낭비하는 키워드는 무엇인가요?추가한 모든 커넥터에서 동일한 에이전트, 동일한 읽기 전용 적용, 동일한 스키마 인텔리전스를 사용하며 MCP 연결은 필요하지 않습니다.

Nova AI를 만나보세요

전제 조건

시작하기 전에 다음 사항을 확인하세요:

1. Query Streams 무료 계정은 다음에서 이용 가능합니다. my.querystreams.com.
2. 인터넷에 접속 가능한 컴퓨터에 설치된 Query Streams 네트워크 에이전트 — 참조 쿼리 스트림 에이전트를 다운로드하세요Google Ads API는 어디에서든 접근 가능하므로 에이전트가 특정 네트워크에 있을 필요가 없습니다.
3. 에이전트에 대해 구성된 Google Ads 커넥터 — 기존 커넥터를 참조하세요. API 커넥터 설정 OAuth 페어링 가이드(단일 계정 또는 MCC 관리자). 에이전트는 Google OAuth 토큰, 고객 ID 및 개발자 토큰을 보유하며, AI 도구는 이러한 토큰에 절대 접근하지 않습니다.
4. MCP를 지원하는 모든 AI 클라이언트. 이 가이드에서는 Cursor, Claude Desktop, ChatGPT 및 Grok을 예로 들겠습니다. Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex 또는 Goose를 사용하는 경우에도 설정 블록은 기본적으로 동일합니다.
5. 5분.

1단계: 쿼리 스트림에서 MCP 키 생성

Query Streams에 로그인하고 엽니다. MCP 페이지 (또는 먼저 로그인하세요) my.querystreams.com 클릭하고 클릭하세요 MCP (왼쪽 탐색 메뉴에서) 클릭하세요. 키를 생성합니다열쇠에 알아보기 쉬운 이름을 지정하세요 (예: 커서-랩톱 또는 클로드-데스크탑그리고 이 키에 적용할 범위를 선택하세요.

• 읽다 — AI는 커넥터를 탐색하고 스키마를 읽을 수 있습니다. 이는 다른 모든 기능에 필수적입니다.
• 분석하다 — AI는 테이블 프로파일링을 통해 관계(샘플 값, 분포, 의미 유형)를 파악할 수 있습니다. 유료 검색 캠페인의 경우 캠페인 데이터 형태와 측정항목 의미(비용(마이크로 단위), 상태 열거형)를 이해하는 것이 중요하므로 이 기능은 선택 사항이지만 강력히 권장합니다.
• 실행하다 — 해당 AI는 실제로 SQL을 실행할 수 있습니다. 이것이 없으면 AI는 스키마 메타데이터에 대해서만 읽기 전용으로 작동합니다.

일반적인 "클로드에게 내 Google Ads 데이터 분석을 맡겨줘" 워크플로에서는 세 가지 범위 모두 적합합니다. 하지만 팀원이나 신뢰도가 낮은 고객에게 키를 넘겨주는 경우에는 범위를 줄이세요. 실행하다 그리고 검색만 허용하도록 설정하세요. 같은 페이지에서 언제든지 키를 취소할 수 있으며, AI 클라이언트는 이를 확인할 수 있습니다. MCP_KEY_REVOKED 다음 호출 시 즉시 작동을 멈춥니다. 전파 지연이 없습니다.

지금 키를 복사하세요. Query Streams는 키를 한 번만 표시하고 해시값만 저장합니다. 키를 분실하면 새 키를 생성해야 합니다. 키는 다음과 같습니다. qsmcp_ 그 뒤에 48개의 임의 문자가 오며, 이것이 AI 클라이언트가 보내는 내용입니다. X-MCP-키 요청 헤더.

2단계: AI 클라이언트에 Query Streams MCP를 추가합니다.

구성 방식은 MCP를 지원하는 모든 클라이언트에서 동일합니다. 즉, MCP 서버 항목이 다음을 가리킵니다. https://mcp.querystreams.com 열쇠를 꽂은 채로 X-MCP-키 헤더. 아래에서 클라이언트를 선택하세요.

커서 ~/.cursor/mcp.json

// ~/.cursor/mcp.json 파일을 수정하세요
{
  "mcpServers": {
    "쿼리스트림": {
      "url": "https://mcp.querystreams.com",
      "헤더": {
        "X-MCP-키": "qsmcp_여기에 키를 붙여넣으세요"
      }
    }
  }
}

클로드 데스크톱 클로드_데스크탑_설정.json

// 설정 → 개발자 → 구성 편집
{
  "mcpServers": {
    "쿼리스트림": {
      "url": "https://mcp.querystreams.com",
      "헤더": {
        "X-MCP-키": "qsmcp_여기에 키를 붙여넣으세요"
      }
    }
  }
}

챗GPT 앱 및 커넥터

// 설정 → 앱 및 커넥터 → MCP 추가
서버 URL  https://mcp.querystreams.com
인증 헤더 X-MCP-키
헤더 값 qsmcp_여기에 키를 붙여넣으세요

// ChatGPT 유료 플랜이 필요합니다
// (플러스/프로/팀/엔터프라이즈).

그록 원격 MCP 도구

// Grok → 설정 → 도구
{
  "mcp_servers": [{
    "이름": "쿼리스트림",
    "url": "https://mcp.querystreams.com",
    "인증 헤더": "X-MCP-키",
    "인증 값": "qsmcp_..."
  }]
}

AI 클라이언트를 다시 시작하세요. 다음 실행 시 위에 나열된 8개의 Query Streams MCP 도구를 감지하여 도구 팔레트에 표시합니다. Cursor 및 Claude Desktop에서는 다음 명령어를 입력하여 확인할 수 있습니다. "연결자 목록" — AI가 전화해야 합니다 qs_list_connectors 설정한 다른 모든 항목과 함께 Google Ads 커넥터(또는 MCC를 연결한 경우 각 하위 계정)를 반환하세요.

3단계: AI에게 구글 광고 관련 질문을 하세요

SQL 쿼리는 직접 작성할 필요가 없습니다. AI가 알아서 처리합니다. 질문을 하면 AI가 적절한 MCP 도구를 선택하고, 에이전트가 캐시된 Google Ads 데이터에 대해 쿼리를 실행하면 텍스트와 표 형식으로 답변이 반환됩니다. 먼저 다음 세 가지 예시 질문을 시도해 보세요.

AI가 처음으로 도구를 호출할 때 클라이언트 측에 도구 호출 승인을 요청하는 확인 메시지가 표시될 수 있습니다. 이는 MCP의 표준 동의 절차이며, Query Streams에서 추가하는 기능은 아닙니다. 한 번 승인하면 AI는 나머지 대화를 자유롭게 진행합니다. 클라이언트 설정에서 언제든지 동의 여부를 다시 확인할 수 있습니다.

자주 묻는 질문

시작하기

관련 가이드: 쿼리 스트림 에이전트를 다운로드하세요 | API 커넥터 설정 | 모든 MCP 서버 가이드 | Nova AI 텍스트를 SQL로 변환

분류: MCP 서버

태그: mcp, 클로드, 커서, 구글 광고, 유료 검색, PPC, 마케팅 분석, API 커넥터

메타 설명: MCP를 통해 Claude 또는 Cursor로 Google Ads를 쿼리하세요. 캐시된 SQL 표면, MCC 지원, 방화벽 취약점 없음. 무료.