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

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

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

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

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

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

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

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

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

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

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

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

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

การกำหนดค่า

หากต้องการผสานรวมเซิร์ฟเวอร์เข้ากับโฮสต์ที่เข้ากันได้กับ MCP ให้เพิ่มรายการต่อไปนี้ลงใน ไฟล์การกำหนดค่า MCP ของโฮสต์ เช่น settings.json และชี้ GOOGLE_APPLICATION_CREDENTIALS ไปยังไฟล์ JSON ของ ADC (หรือกำหนดค่า ADC เริ่มต้นด้วย gcloud auth application-default login) หากเข้าถึงบัญชีผ่านบัญชีดูแลจัดการ คุณยังตั้งค่า GOOGLE_ADS_LOGIN_CUSTOMER_ID ได้ด้วย โปรดดูเอกสารประกอบของโฮสต์เพื่อดูตำแหน่งและชื่อไฟล์ที่แน่นอนของ การกำหนดค่านี้

{
  "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_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

การติดตั้งใช้งานใน 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 เช่น "campaign"

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

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

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

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