gomarble-ai/google-ads-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

147 stars 47 forks 품질 78 트렌드 20MIT

Repository Install

gomarble-ai/google-ads-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

gomarble-ai/google-ads-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

Google Ads API 통합과 자동 OAuth 2.0 인증을 위한 FastMCP 기반 모델 컨텍스트 프로토콜 서버

Google Ads API를 Claude Desktop 및 기타 MCP 클라이언트에 직접 연결하여 원활한 OAuth 2.0 인증, 자동 토큰 갱신, GAQL 쿼리, 키워드 조사 기능을 지원합니다.

브라우저가 비디오 태그를 지원하지 않습니다.

간단한 원클릭 설정

더 간단한 설치 경험을 위해 즉시 사용할 수 있는 설치 프로그램도 제공합니다:

👉 설치 프로그램 다운로드 - https://gomarble.ai/mcp

도움과 업데이트를 위해 커뮤니티에 참여하세요

👉 슬랙 커뮤니티 - 광고 내 AI

페이스북 광고 MCP 서버도 시도해 보세요

👉 페이스북 광고 MCP - 페이스북 광고 MCP

✨ 특징

🔐 자동 OAuth 2.0 - 자동 새로고침이 포함된 일회성 브라우저 인증
🔄 스마트 토큰 관리 - 만료된 토큰을 자동으로 처리함
📊 GAQL 쿼리 실행 - Google Ads 쿼리 언어 쿼리를 실행하기
🏢 계정 관리 - 구글 광고 계정 목록 및 관리
🔍 키워드 리서치 - 검색량 데이터를 활용한 키워드 아이디어 생성
🚀 FastMCP 프레임워크 - 최신 MCP 표준을 기반으로 구축됨
🖥️ Claude Desktop Ready - Claude Desktop과의 직접 통합

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Google Ads MCP Server 🚀

A FastMCP-powered Model Context Protocol server for Google Ads API integration with automatic OAuth 2.0 authentication

Connect Google Ads API directly to Claude Desktop and other MCP clients with seamless OAuth 2.0 authentication, automatic token refresh, GAQL querying, and keyword research capabilities.

Your browser does not support the video tag.

Easy One-Click Setup

For a simpler setup experience, we offer ready-to-use installers:

👉 Download installer - https://gomarble.ai/mcp

Join our community for help and updates

👉 Slack Community - AI in Ads

Try Facebook ads mcp server also

👉 Facebook Ads MCP - Facebook Ads MCP

✨ Features

🔐 Automatic OAuth 2.0 - One-time browser authentication with auto-refresh
🔄 Smart Token Management - Handles expired tokens automatically
📊 GAQL Query Execution - Run any Google Ads Query Language queries
🏢 Account Management - List and manage Google Ads accounts
🔍 Keyword Research - Generate keyword ideas with search volume data
🚀 FastMCP Framework - Built on the modern MCP standard
🖥️ Claude Desktop Ready - Direct integration with Claude Desktop
🛡️ Secure Local Storage - Tokens stored locally, never exposed

📋 Available Tools

Tool	Description	Parameters	Example Usage
`list_accounts`	List all accessible Google Ads accounts	None	“List all my Google Ads accounts”
`run_gaql`	Execute GAQL queries with custom formatting	`customer_id`, `query`, `manager_id` (optional)	“Show me campaign performance for account 1234567890”
`run_keyword_planner`	Generate keyword ideas with metrics	`customer_id`, `keywords`, `manager_id`, `page_url`, date range options	“Generate keyword ideas for ‘digital marketing’”

Note: All tools automatically handle authentication - no token parameters required!

🚀 Quick Start

Prerequisites

Before setting up the MCP server, you’ll need:

Python 3.10+ installed
A Google Cloud Platform account
A Google Ads account with API access

🔧 Step 1: Google Cloud Platform Setup

1.1 Create Google Cloud Project

Go to Google Cloud Console
Create a new project:
- Click “Select a project” → “New Project”

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "google-ads": {
      "command": "/full/path/to/your/project/.venv/bin/python",
      "args": [
        "/full/path/to/your/project/server.py"
      ]
    }
  }
}