MCP Google Ads
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Multi-account Google Ads MCP: campaigns, keywords, search terms, and ad performance.
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 0 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังใหม่มาก↓ 20/สัปดาห์ · ★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: การตลาดและโซเชียล
- ต้องใส่ค่าเหล่านี้: GOOGLE_ADS_DEVELOPER_TOKEN
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 0 จาก 1 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
GOOGLE_ADS_DEVELOPER_TOKEN,GOOGLE_ADS_ACCOUNTS_CONFIG
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"google-ads": {
"command": "uvx",
"args": [
"mcp-google-ads-multi"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "ใส่ค่าของคุณ",
"GOOGLE_ADS_ACCOUNTS_CONFIG": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN='ใส่ค่าของคุณ' --env GOOGLE_ADS_ACCOUNTS_CONFIG='ใส่ค่าของคุณ' -- uvx mcp-google-ads-multiเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"google-ads": {
"command": "uvx",
"args": [
"mcp-google-ads-multi"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "ใส่ค่าของคุณ",
"GOOGLE_ADS_ACCOUNTS_CONFIG": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"google-ads": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-google-ads-multi"
],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "ใส่ค่าของคุณ",
"GOOGLE_ADS_ACCOUNTS_CONFIG": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- Google Ads API developer token from the Google Ads API Center
GOOGLE_ADS_ACCOUNTS_CONFIGenvPath to accounts.json config file with OAuth credentials per account
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 10 พ.ย. 2569
- ! ควรระวัง
ตัวตนผู้ทำตรงกับ repo
ผู้ลงทะเบียน (Ayo-Fam) ไม่ใช่เจ้าของ repo (apexradius) อาจเป็นคนอื่นที่นำมาลงต่อ
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi
- ดาวมากกว่า 0% ของอีก 3707 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 14% ของอีก 3707 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 11% ของอีก 3707 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
MCP Google Ads ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 0 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: GOOGLE_ADS_DEVELOPER_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.0) เข้า registry 4 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
mcp-google-ads
Multi-account Google Ads MCP server for operators who need one MCP surface across multiple client or in-house ad accounts without restarting the server.
Release posture: beta package, version 0.1.0 from pyproject.toml.
Choose your path
| You are... | Start here | Then |
|---|---|---|
| Connecting the server to your MCP client | docs/start-here.md | Quick start below |
| Auditing account switching and retries | docs/architecture.md | gads/server.py |
| Reviewing packaging metadata | pyproject.toml | accounts.example.json |
Architecture
flowchart TD
U[AI operator] --> C[MCP client] C --> S[FastMCP server] S --> M[Account manager] M --> F[Accounts config] S --> Q[GAQL query helpers] Q --> R[Retry wrapper] R --> A[Google Ads API] A --> R --> S
Request flow
flowchart TD
P[Operator asks for account or campaign data] --> T[Selected MCP tool] T --> A[Resolve named or default account] A --> B[Build Google Ads client] B --> C[Run GAQL query] C --> D{API call succeeds?} D -- yes --> E[Normalize rows and return] D -- retryable --> F[Backoff and retry] F --> D D -- no --> G[Return error payload]
Quick start
- Install the package.
python -m pip install mcp-google-ads-multi
- Copy the accounts config template and add your accounts.
mkdir -p ~/.config/mcp-google-ads
cp accounts.example.json ~/.config/mcp-google-ads/accounts.json
- Register it in your MCP client.
{
"mcpServers": { "google-ads": { "command": "uvx", "args": ["mcp-google-ads-multi"], "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token", "GOOGLE_ADS_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-google-ads/accounts.json" } } } }
Available tools
| Tool group | Tools | Purpose |
|---|---|---|
| Account selection | list_accounts, set_default_account, list_customers | Manage account routing and discover accessible customers |
| Spend summary | get_account_summary, compare_periods | Period-over-period account reporting |
| Campaign analysis | list_campaigns, get_campaign_performance | Campaign inventory and range-based metrics |
| Query-level detail | get_keyword_performance, search_terms_report, get_ad_performance | Keyword, search-term, and ad reporting |
Runtime proof
| Claim | Proof |
|---|---|
| Package entry point is stable | mcp-google-ads-multi = "gads.server:main" in pyproject.toml |
| Multi-account routing is first-class | AccountManager() and set_default_account() in gads/server.py |
| Queries go through reusable helpers | gads/query.py and gads/retry.py |
| Config is file-driven | accounts.example.json documents the accounts shape |
Repo map
| Path | Purpose |
|---|---|
gads/server.py | FastMCP tool surface |
gads/accounts.py | Account config, OAuth/service-account loading |
gads/query.py | GAQL execution helpers |
gads/retry.py | Retry behavior for API calls |
docs/start-here.md | Setup, validation, common failures |
docs/architecture.md | Component map and request lifecycle |
Validation
| Check | Command |
|---|---|
| Import compiles | python -m compileall gads |
| Package builds | python -m build |
| README/docs links are local | rg '\\]\\(([^)]+\\.md)\\)' README.md docs/ |
License
MIT
Project context for new tasks
Use INDEX.md to find task-specific contracts; consult prompt.md when product direction is relevant. Historical examples do not select the current task.