เซิร์ฟเวอร์ MCP ของ Google Ads: คู่มือการผสานรวมสำหรับนักพัฒนาซอฟต์แวร์

Model Context Protocol (MCP) เป็นมาตรฐานแบบเปิดที่ช่วยให้โมเดลภาษาขนาดใหญ่ (LLM) โต้ตอบกับข้อมูลและแอปพลิเคชันภายนอกได้อย่างปลอดภัย เซิร์ฟเวอร์ MCP ของ Google Ads เป็นสะพานเชื่อมมาตรฐานไปยัง Google Ads API ซึ่ง ช่วยให้เอเจนต์ AI วิเคราะห์และดึงข้อมูลแคมเปญโดยใช้ภาษาธรรมชาติได้

แหล่งข้อมูลและการสนับสนุนจากชุมชน

• ที่เก็บ GitHub: ค้นหาการสาธิต ตัวอย่าง และรายงานข้อบกพร่องหรือแนะนำฟีเจอร์ในที่เก็บ google-ads-mcp

  ใช้แท็บปัญหาสำหรับรายงานข้อบกพร่อง และคำขอฟีเจอร์

• ชุมชน: เข้าร่วมแชแนล #ads-api-ai-tools ใน Discord ของชุมชนการโฆษณาของ Google

ภาพรวมทางเทคนิค

การติดตั้งใช้งานเซิร์ฟเวอร์ MCP นี้จะช่วยให้คุณไม่ต้องเขียน "โค้ดเชื่อม" ที่กำหนดเองสำหรับการตรวจสอบสิทธิ์ Google Ads API, การดึงข้อมูลทรัพยากร และการแยกวิเคราะห์ข้อมูล เซิร์ฟเวอร์จะแสดงเครื่องมือที่เฉพาะเจาะจงซึ่ง LLM สามารถค้นหาและเรียกใช้ได้โดยอัตโนมัติ

ข้อกำหนดที่สำคัญ

• โปรโตคอล: MCP (Model Context Protocol)
• โหมด: อ่านอย่างเดียว (รุ่นปัจจุบัน)
• ภาษา: Python
• การรับส่ง: อินพุต/เอาต์พุตมาตรฐาน (stdio)
• การตรวจสอบสิทธิ์: OAuth 2.0 หรือบัญชีบริการ

วงจรการโต้ตอบทำงานอย่างไร

1. คำขอ: ผู้ใช้ส่งคำค้นหา เช่น "ประสิทธิภาพของแคมเปญในสัปดาห์นี้เป็นอย่างไร
2. การค้นหา: LLM จะตรวจสอบเครื่องมือที่พร้อมใช้งานและระบุ google-ads-mcpความสามารถในการค้นหา
3. การดำเนินการ: เซิร์ฟเวอร์ MCP จะเรียกใช้ตรรกะ Python พื้นฐานเพื่อค้นหา Google Ads API
4. การแทรกบริบท: ระบบจะแสดงผลลัพธ์ที่มีโครงสร้างไปยังหน้าต่างบริบทของ LLM
5. คำตอบ: LLM จะสังเคราะห์ข้อมูลเป็นคำตอบที่มนุษย์อ่านได้

เริ่มต้นใช้งาน

ทำตามขั้นตอนต่อไปนี้เพื่อกำหนดค่าและใช้เซิร์ฟเวอร์ MCP ของ Google Ads

ข้อกำหนดเบื้องต้น

ก่อนการกำหนดค่า โปรดตรวจสอบว่าคุณมีข้อมูลเข้าสู่ระบบต่อไปนี้จากคอนโซล Google Cloud

• รหัสโปรเจ็กต์: หมายเลขโปรเจ็กต์ Google Cloud ดูหน้าภาพรวมของ Google Ads API เพื่อให้แน่ใจว่าโปรเจ็กต์ของคุณมีสิทธิ์เข้าถึงระดับ Explorer, สิทธิ์เข้าถึงระดับพื้นฐาน หรือสิทธิ์เข้าถึงระดับมาตรฐาน หากยังไม่ได้สมัคร ให้สมัครระดับการเข้าถึงเหล่านี้
• ข้อมูลเข้าสู่ระบบ OAuth: คู่รหัสไคลเอ็นต์/รหัสลับไคลเอ็นต์ OAuth 2.0 หรือ ชุดข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชัน

การกำหนดค่า

หากต้องการผสานรวมเซิร์ฟเวอร์เข้ากับโฮสต์ที่เข้ากันได้กับ MCP ให้เพิ่มรายการต่อไปนี้ลงใน ไฟล์การกำหนดค่า MCP ของโฮสต์ เช่น settings.json โปรดดูเอกสารประกอบของโฮสต์เพื่อดูตำแหน่งและชื่อไฟล์ที่แน่นอนของการกำหนดค่านี้

JSON

{
  "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 Cloud

คุณสามารถโฮสต์เซิร์ฟเวอร์ MCP นี้ใน Google Cloud Run หรือในโครงสร้างพื้นฐานอื่นๆ บนระบบคลาวด์แทนการโฮสต์ในเครื่อง ซึ่งจะเป็นประโยชน์หากคุณต้องการแชร์เซิร์ฟเวอร์กับเอเจนต์ต่างๆ หรือเรียกใช้เป็นบริการบนเว็บ

ข้อกำหนดเบื้องต้น

1. โปรเจ็กต์ Google Cloud

2. gcloud เครื่องมือบรรทัดคำสั่งที่ติดตั้ง ได้รับการตรวจสอบสิทธิ์ และกำหนดค่าโปรเจ็กต์ที่ใช้งานอยู่

   gcloud config set project YOUR_PROJECT_ID
   

สร้างและพุชอิมเมจ Docker

คุณใช้ Cloud Build เพื่อสร้างและพุชอิมเมจไปยัง Artifact Registry ได้โดยไม่ต้องติดตั้ง Docker ในเครื่อง

1. สร้างที่เก็บใน Artifact Registry โดยทำดังนี้

   gcloud artifacts repositories create mcp-servers --repository-format=docker --location=us-central1
   

2. ไปที่ไดเรกทอรีโปรเจ็กต์:

   cd <full path>/google-ads-mcp
   

3. สร้างและส่งรูปภาพโดยใช้คำสั่งต่อไปนี้

   gcloud builds submit --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest .
   

   โปรดทราบว่าคุณต้องทำขั้นตอนนี้ทุกครั้งที่ต้องการอัปเดตเซิร์ฟเวอร์ที่ ใช้งานเป็นเวอร์ชันล่าสุด

ติดตั้งใช้งานลงใน Google Cloud Run

อย่าลืมตั้งค่าตัวแปรสภาพแวดล้อมที่จำเป็น

• GOOGLE_PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud ที่มีระดับการเข้าถึง API ที่เหมาะสม
• GOOGLE_ADS_MCP_OAUTH_CLIENT_ID: รหัสไคลเอ็นต์ OAuth ที่คุณต้องการให้เซิร์ฟเวอร์ MCP ใช้
• GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET: รหัสลับไคลเอ็นต์ OAuth ที่คุณต้องการให้เซิร์ฟเวอร์ MCP ใช้
• GOOGLE_ADS_MCP_BASE_URL: URL ฐานที่เข้าถึงเซิร์ฟเวอร์ MCP ได้ Google Cloud Run จะกำหนด URL นี้โดยอัตโนมัติหลังจากการ ติดตั้งใช้งานครั้งแรก คุณอัปเดตตัวแปรสภาพแวดล้อมได้หลังจากการติดตั้งใช้งาน
• FASTMCP_HOST: ตั้งค่านี้เป็น 0.0.0.0 เพื่ออนุญาตให้ FastMCP ยอมรับการเชื่อมต่อ จากที่อยู่ IP ทั้งหมด

gcloud run deploy google-ads-mcp \
  --image us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars="GOOGLE_PROJECT_ID=YOUR_PROJECT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=YOUR_CLIENT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=YOUR_CLIENT_SECRET,GOOGLE_ADS_MCP_BASE_URL=YOUR_BASE_URL,FASTMCP_HOST=0.0.0.0"

กำหนดค่าไคลเอ็นต์ MCP

หลังจากการติดตั้งใช้งาน ให้อัปเดตการกำหนดค่าไคลเอ็นต์ MCP (เช่น ~/.gemini/settings.json) เพื่อใช้ URL ของ Cloud Run

{
  "mcpServers": {
    "google-ads-mcp": {
      "httpUrl": "https://your-cloud-run-url.a.run.app/mcp"
    }
  }
}

ความสามารถหลัก (เครื่องมือ)

เซิร์ฟเวอร์จะแสดงเครื่องมือที่ออกแบบมาเพื่อการค้นพบบัญชีและการรายงานประสิทธิภาพ

• list_accessible_customers: แสดงรายการรหัสลูกค้า Google Ads และชื่อบัญชีที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์เข้าถึงได้
• search: ดำเนินการคำขอ Google Ads Query Language (GAQL) เพื่อดึงข้อมูลเมตริก งบประมาณ และสถานะของทรัพยากร

• get_resource_metadata: เรียกข้อมูลเมตาเกี่ยวกับประเภททรัพยากร Google Ads API เช่น "แคมเปญ"

  ซึ่งจะเป็นประโยชน์ในการทำความเข้าใจโครงสร้างของข้อมูลและฟิลด์ที่พร้อมใช้งานสำหรับการค้นหา

หมายเหตุ: การติดตั้งใช้งานนี้เป็นแบบอ่านอย่างเดียว โดยไม่สามารถแก้ไขราคาเสนอ หยุดแคมเปญชั่วคราว หรือสร้างชิ้นงานใหม่ได้

ตัวอย่างพรอมต์เพื่อเริ่มต้นใช้งาน

ถามว่าเซิร์ฟเวอร์ทำอะไรได้บ้าง

What can the google-ads-mcp server do?

ถามเกี่ยวกับลูกค้า:

What customers do I have access to?

ถามเกี่ยวกับแคมเปญ

How many active campaigns do I have?
How is my campaign performance this week?
Give me a report of the top spending campaigns split by device category over the
last 7 days for account 1234567890