analytics-mcp เป็น MCP server ตัวทางการของ Google ที่ให้ AI agent อย่าง Claude Code อ่านข้อมูล GA4 ผ่าน Admin API กับ Data API ได้ เราจึงถามเป็นภาษาคน เช่น "เดือนนี้ traffic มาจากช่องทางไหน เทียบกับเดือนก่อน" แล้ว agent จะเลือก tool, ยิง report และสรุปให้ ค่าเริ่มต้นเป็นแบบอ่านอย่างเดียว ติดตั้งได้ใน 4 ขั้น: เปิด API สองตัวใน Google Cloud, login ADC ด้วย scope analytics.readonly, ติดตั้ง pipx และรัน claude mcp add ตามที่ README ให้มา ในเว็บนี้ report หนึ่งครั้งใช้ quota แค่ 1 token จากโควตา 200,000 ต่อวัน และ error ที่เราเจอจริงคือ 403 จาก service account ที่ยังไม่ได้รับสิทธิ์ใน GA4 (ข้อมูล ณ 8 พฤศจิกายน 2026, analytics-mcp เวอร์ชัน 1.1.0)
เรื่องเครดิต: เจ้าของเว็บเป็นคนตั้งค่า server และเลือกว่าจะทำอะไรกับข้อมูล ส่วน AI agent (Claude Code) เป็นคนยิง query ทั้งหมดในโพสต์นี้และอีกโพสต์ที่เป็นเคสจริง
Google Analytics MCP คืออะไร?
analytics-mcp เป็นโปรเจกต์ open source ของ Google (repo googleanalytics/google-analytics-mcp, license Apache-2.0) มันเป็น MCP server ที่หุ้ม Google Analytics Admin API กับ Data API ไว้เป็น tool ให้ AI เรียกใช้ได้ ต้องใช้ Python 3.10 ขึ้นไป และรันผ่าน pipx
จุดสำคัญที่ควรรู้:
- อ่านอย่างเดียวเป็นค่าเริ่มต้น
เวอร์ชัน 1.1.0 มี tool สำหรับเขียนอยู่ 3 ตัว (สร้าง annotation, สร้าง custom dimension, ตั้ง key event) แต่จะเปิดก็ต่อเมื่อใส่ flag --allow-write และ credential มี scope analytics.edit เท่านั้น ถ้าตั้งตามโพสต์นี้ agent จะเห็นแค่ 10 tool ที่อ่านอย่างเดียว
- ใช้สิทธิ์ของคนที่ login
server เห็นเฉพาะ account และ property ที่บัญชีนั้นมีสิทธิ์ใน GA4
- รันบนเครื่องเรา
แบบ stdio ไม่ต้องเปิดพอร์ตหรือ deploy อะไร (README มีโหมด HTTP แบบ multi-tenant ด้วย แต่โพสต์นี้ไม่ได้ใช้)
มี tool อะไรบ้าง แต่ละตัวตอบคำถามแบบไหน?
Tool | ตอบคำถามแบบไหน |
|---|---|
get_account_summaries | ฉันเข้าถึง GA account และ property ไหนได้บ้าง |
get_property_details | property นี้ตั้งค่าไว้ยังไง (time zone, สกุลเงิน, วันที่สร้าง) |
get_custom_dimensions_and_metrics | property นี้มี custom dimension และ metric อะไรบ้าง |
list_key_events | ตอนนี้นับ key event (conversion) อะไรอยู่บ้าง |
list_property_annotations | มีใครจดโน้ตไว้บนกราฟ เช่น วันที่ deploy หรือเปลี่ยนแคมเปญไหม |
list_google_ads_links | property นี้ผูกกับ Google Ads account ไหน |
run_report | คำถามรายงานทั่วไป: ช่องทาง หน้า ประเทศ อุปกรณ์ เทียบช่วงเวลา |
run_realtime_report | ตอนนี้มีคนอยู่บนเว็บกี่คน ดูหน้าไหนอยู่ |
run_conversions_report | key event มาจากช่องทางไหน ค่าโฆษณา ROAS และ attribution |
run_funnel_report | คนหลุดตรงขั้นไหนของ funnel |
ต้องเตรียมอะไรก่อนติดตั้ง?
บัญชี Google ที่มีสิทธิ์ดู GA4 property ที่ต้องการ (อย่างน้อย Viewer)
Google Cloud project หนึ่งตัว (ใช้ project ที่มีอยู่ก็ได้)
Google Cloud CLI (gcloud) สำหรับ login แบบ ADC
Python 3.10 ขึ้นไป และ pipx
Claude Code
ติดตั้งกับ Claude Code ทีละขั้นยังไง?
ทุกขั้นด้านล่างตรงกับ README ของ Google ค่าที่เป็นตัวพิมพ์ใหญ่ทั้งหมดเป็น placeholder ให้แทนด้วยค่าของตัวเอง และไม่ควร commit ค่าเหล่านี้ลง repo
ขั้น 1: ติดตั้ง pipx
README ของ analytics-mcp ลิงก์ไปหน้า Install pipx ของ pipx เอง ซึ่งให้คำสั่งของแต่ละระบบไว้ สำหรับ macOS ใช้ Homebrew:
brew install pipx
pipx ensurepathจากนั้นเปิด terminal ใหม่ให้ PATH ที่อัปเดตมีผล แล้วรัน pipx list เพื่อเช็กว่าติดตั้งแล้ว ระบบอื่นดูคำสั่งในหน้าเดียวกัน
ขั้น 2: เปิด API สองตัวใน Google Cloud project
ใน Google Cloud Console ให้เปิดใช้:
Google Analytics Admin API
Google Analytics Data API
README ลิงก์ไปหน้า API Library ของทั้งสองตัวโดยตรง (ดูในแหล่งอ้างอิง)
ขั้น 3: Login แบบ Application Default Credentials (ADC)
credential ต้องมี scope analytics.readonly README ให้ตัวอย่างไว้สองแบบ แบบแรกคือ login ด้วยบัญชีผู้ใช้ผ่าน OAuth client (desktop หรือ web) ที่เราดาวน์โหลดไฟล์ JSON มาไว้แล้ว:
gcloud auth application-default login \
--scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
--client-id-file=YOUR_CLIENT_JSON_FILEแบบที่สองคือ impersonate service account:
gcloud auth application-default login \
--impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
--scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platformREADME มีแค่สองแบบนี้ ไม่มีตัวอย่าง login ที่ไม่ใส่ --client-id-file หรือ --impersonate-service-account เลย จึงควรเตรียม OAuth client (README ลิงก์ไปหน้า Manage OAuth Clients ของ Google) หรือ service account ไว้ก่อน
พอเสร็จ gcloud จะพิมพ์บรรทัด "Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]" ให้จด path นั้นไว้ใช้ในขั้นถัดไป ไฟล์นี้คือกุญแจเข้า GA ของเรา อย่าแชร์และอย่า commit
ถ้าเลือกแบบ service account ให้อ่านหัวข้อ 403 ด้านล่างก่อน เพราะนี่คือจุดที่เราพลาดเอง
ขั้น 4: เพิ่ม server เข้า Claude Code
คำสั่งนี้มาจาก README ตรงๆ ใช้ scope user เพื่อให้ใช้ได้ทุกโปรเจกต์บนเครื่อง:
claude mcp add analytics-mcp \
--scope user \
-e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \
-e "GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID" \
-- pipx run analytics-mcpขั้น 5: เช็กว่าเชื่อมได้แล้ว
เปิด Claude Code ใหม่ แล้วพิมพ์ /mcp เพื่อดูว่า analytics-mcp ขึ้นสถานะเชื่อมต่อแล้ว หรือรันคำสั่งนี้ในเทอร์มินัล:
claude mcp listจากนั้นลองถามง่ายๆ ก่อน เช่น "ฉันเข้าถึง GA4 property ไหนได้บ้าง" ถ้า agent เรียก get_account_summaries แล้วได้รายชื่อ property กลับมา แปลว่าใช้ได้
(มักเกิดตอนใช้ VPN หรือ split DNS) TROUBLESHOOTING.md ของ repo แนะนำให้เพิ่ม env นี้ตอน claude mcp add แต่ให้ใส่เฉพาะตอนเจอปัญหานี้เท่านั้น:
-e "GRPC_DNS_RESOLVER=native"ทำไมได้ 403 ทั้งที่ login ผ่านแล้ว?
นี่คือสิ่งที่เราเจอจริงเมื่อ 7 พฤศจิกายน 2026 เว็บนี้มี service account อีกตัวที่ใช้กับ Search Console อยู่แล้ว พอลองเอาตัวเดียวกันไปเรียก GA4 Data API ก็ได้ 403 กลับมา
การยืนยันตัวตนกับ Google Cloud กับสิทธิ์ใน GA4 เป็นคนละเรื่องกัน service account ยืนยันตัวตนผ่านและเรียก API ได้ แต่ GA4 ยังไม่รู้จักมัน มันเลยไม่เห็น property ไหนเลย การเปิด API ใน Cloud project ไม่ได้ให้สิทธิ์อ่านข้อมูล GA4
เพิ่มอีเมลของ service account เป็นผู้ใช้ใน GA4 ด้วยบทบาท Viewer:
- 1.
ใน GA4 ไปที่ Admin แล้วเลือก Access management ของ property (หรือของ account ถ้าอยากให้เห็นทุก property)
- 2.
กด + แล้วเลือก Add users
- 3.
ใส่อีเมลของ service account เลือกบทบาท Viewer แล้วกด Add
คนที่เพิ่มผู้ใช้ได้ต้องมีบทบาท Administrator ในระดับนั้น
ในเว็บนี้เราเลือกอีกทาง คือให้ MCP ใช้ ADC ที่ login ด้วยบัญชีของเจ้าของเว็บเอง ซึ่งมีสิทธิ์ใน GA4 อยู่แล้ว เลยไม่ต้องเพิ่มผู้ใช้ใหม่ ถ้าทีมของคุณอยากแยกสิทธิ์ให้ชัด แบบ service account ที่เป็น Viewer ก็เป็นทางที่สะอาดกว่า
ใช้ quota เยอะไหม?
ไม่เยอะ ในการทดสอบของเรา report ช่องทางที่เทียบสองช่วงเวลาใช้ไปแค่
1 token(เราขอให้ report ส่งสถานะ quota กลับมาด้วย) เทียบกับโควตาของ property แบบ Standard:
Quota (GA4 Standard, core report) | ขีดจำกัด |
|---|---|
Token ต่อ property ต่อวัน | 200,000 |
Token ต่อ property ต่อชั่วโมง | 40,000 |
Token ต่อ project ต่อ property ต่อชั่วโมง | 14,000 |
Request พร้อมกันต่อ property | 10 |
report ที่ใหญ่ขึ้น (ช่วงเวลายาว มิติเยอะ) จะกิน token มากกว่านี้ แต่สำหรับเว็บขนาดเล็กถึงกลางที่ถามวันละหลายสิบครั้งก็ยังห่างจากเพดานมาก realtime และ funnel report มีโควตาแยกของตัวเองในขนาดเท่ากัน
ถามอะไรได้บ้าง และจะไปเรียก tool ไหน?
ถามว่า | Tool ที่ agent มักเลือก |
|---|---|
"28 วันล่าสุด traffic มาจากช่องทางไหน เทียบกับ 28 วันก่อนหน้า" | run_report (สองช่วงเวลา, มิติ channel) |
"หน้าไหนเป็นหน้าแรกที่คนจาก Google เข้ามา ใน 90 วันล่าสุด" | run_report (มิติ landing page, กรอง Organic Search) |
"ตอนนี้มีคนอยู่บนเว็บกี่คน ดูหน้าไหนอยู่" | run_realtime_report |
"property นี้นับ key event อะไรอยู่บ้าง" | list_key_events |
"คนที่เข้าหน้าบล็อกแล้วไปต่อหน้า About มีกี่เปอร์เซ็นต์" | run_funnel_report |
"มีโน้ตหรือ annotation บนกราฟช่วงที่ traffic พุ่งไหม" | list_property_annotations |
เคล็ดลับ: บอกช่วงวันที่ให้ชัดทุกครั้ง และขอให้ agent แสดงตารางตัวเลขดิบก่อนสรุป จะได้ตรวจได้ว่ามันไม่ได้ตีความเกินข้อมูล
ข้อควรระวังก่อนใช้จริง
- ข้อมูลเข้า context ของ AI:
ตัวเลขที่ report ส่งกลับมาจะถูกส่งให้โมเดลอ่าน ถ้า property มีข้อมูลที่ไม่อยากให้ออกนอกองค์กร ให้เช็กนโยบายก่อน
- ไม่ต้องเปิด --allow-write ถ้าไม่จำเป็น:
การตั้งค่าที่เปลี่ยน property ทำใน GA4 UI ก็ได้ และทำให้มีคนเห็นก่อนกดยืนยัน
- เก็บ credential ให้ดี:
path ของไฟล์ ADC และ project ID อยู่ใน config ของ Claude Code ที่ระดับ user ไม่ใช่ในโปรเจกต์ อย่าคัดลอกไปใส่ไฟล์ที่ commit
- ตัวเลขดีแค่ไหนก็เท่าที่ GA4 เก็บ:
ถ้ายังไม่ได้กรอง traffic ของตัวเองหรือ bot ออก AI ก็จะสรุปจากข้อมูลที่ปนอยู่ (ดูตัวอย่างในโพสต์เคสจริง)
อยากเห็นว่าถามจริงแล้วเจออะไร อ่าน
เคสจริง: ถาม GA4 ของเว็บนี้ผ่าน MCP แล้วเจอ 5 อย่างFAQ
Google Analytics MCP เป็นของ Google จริงไหม?
จริง repo อยู่ใต้ organization googleanalytics บน GitHub เผยแพร่บน PyPI ในชื่อ analytics-mcp และใช้ license Apache-2.0 ณ 9 พฤศจิกายน 2026 เวอร์ชันล่าสุดบน PyPI คือ 1.1.0
AI จะแก้ค่าใน GA4 ของเราได้ไหม?
ถ้าตั้งตามโพสต์นี้ ไม่ได้ ค่าเริ่มต้นเป็นแบบอ่านอย่างเดียว tool ที่เขียนได้ (สร้าง annotation, custom dimension, key event) จะเปิดก็ต่อเมื่อใส่ flag --allow-write และ credential มี scope analytics.edit
ใช้ฟรีไหม?
ตัว server เป็น open source ส่วน GA4 Data API เอกสารของ Google จำกัดการใช้งานด้วยโควตาแบบ token ซึ่ง property แบบ Standard ได้ 200,000 token ต่อวัน เราไม่เจอราคาต่อ request ในเอกสารของ Data API ในเว็บนี้ report หนึ่งครั้งใช้ราว 1 token
ใช้กับ Gemini CLI หรือ client อื่นได้ไหม?
ได้ README มีวิธีตั้งค่าสำหรับ Gemini CLI และ Gemini Code Assist ด้วย ส่วน client อื่นที่รองรับ MCP แบบ stdio ใช้คำสั่ง pipx run analytics-mcp กับ env สองตัวเดียวกันได้
ทำไมเรียกได้แต่ไม่เห็น property ไหนเลย หรือได้ 403?
บัญชีหรือ service account ที่ใช้ยังไม่มีสิทธิ์ใน GA4 ให้เพิ่มเป็น Viewer ที่ Admin > Access management ของ property หรือ account การเปิด API ใน Google Cloud อย่างเดียวไม่พอ
ต้องใช้ service account หรือบัญชีตัวเอง?
ใช้ได้ทั้งคู่ บัญชีตัวเองตั้งเร็วกว่าเพราะมีสิทธิ์ใน GA4 อยู่แล้ว ส่วน service account แยกสิทธิ์ได้ชัดกว่า แต่ต้องเพิ่มเป็น Viewer ใน GA4 ก่อน
สรุป
analytics-mcp ทำให้คำถามที่เคยต้องคลิกหลายหน้าใน GA4 กลายเป็นประโยคเดียวใน Claude Code และค่าเริ่มต้นปลอดภัยพอ เพราะอ่านได้อย่างเดียว
✅ เปิด Admin API กับ Data API แล้ว login ADC ด้วย scope analytics.readonly
✅ ใช้คำสั่ง claude mcp add จาก README แบบ scope user
⚠️ ได้ 403 = ยังไม่ได้เพิ่มบัญชีเป็น Viewer ใน GA4 ไม่ใช่ปัญหาที่ Cloud
✅ report หนึ่งครั้งใช้ราว 1 token จาก 200,000 ต่อวัน
⚠️ ให้ agent โชว์ตัวเลขดิบก่อนสรุปเสมอ และกรองข้อมูลขยะใน GA4 ก่อนเชื่อผล
👉 อ่านต่อ:
Claude Code MCP ใช้ไม่ได้? รวมวิธีแก้ error ที่เจอบ่อยและ
Google Workspace MCP ขึ้น The caller does not have permission?Last verified: 9 พฤศจิกายน 2026 จาก README และ TROUBLESHOOTING ของ google-analytics-mcp (เวอร์ชัน 1.1.0) หน้า quota ของ GA4 Data API และการใช้งานจริงบนเว็บนี้
แหล่งอ้างอิง:

