Máy chủ MCP của Google Ads: Hướng dẫn tích hợp cho nhà phát triển

Giao thức ngữ cảnh mô hình (MCP) là một tiêu chuẩn mở cho phép các Mô hình ngôn ngữ lớn (LLM) tương tác an toàn với dữ liệu và ứng dụng bên ngoài. Máy chủ MCP của Google Ads cung cấp một cầu nối tiêu chuẩn cho Google Ads API, cho phép các tác nhân AI phân tích và truy xuất dữ liệu chiến dịch bằng ngôn ngữ tự nhiên.

Tổng quan về kỹ thuật

Bằng cách triển khai máy chủ MCP này, bạn không cần phải viết "mã kết dính" tuỳ chỉnh để xác thực API Google Ads, tìm nạp tài nguyên và phân tích cú pháp dữ liệu. Máy chủ cung cấp các công cụ cụ thể mà một LLM có thể tự động khám phá và gọi.

Thông số kỹ thuật chính

  • Giao thức: MCP (Giao thức ngữ cảnh mô hình)
  • Chế độ: Chỉ đọc (bản phát hành hiện tại)
  • Ngôn ngữ: Python
  • Vận chuyển: Đầu vào/đầu ra tiêu chuẩn (stdio)
  • Xác thực: OAuth 2.0 hoặc tài khoản dịch vụ

Cách hoạt động của vòng lặp tương tác

  1. Yêu cầu: Người dùng gửi một cụm từ tìm kiếm, chẳng hạn như "Hiệu suất chiến dịch của tôi trong tuần này như thế nào?".
  2. Khám phá: LLM kiểm tra các công cụ hiện có và xác định khả năng tìm kiếm google-ads-mcp.
  3. Thực thi: Máy chủ MCP thực thi logic Python cơ bản để truy vấn API Google Ads.
  4. Chèn ngữ cảnh: Kết quả có cấu trúc được trả về cửa sổ ngữ cảnh của LLM.
  5. Câu trả lời: LLM tổng hợp dữ liệu thành một câu trả lời mà con người có thể đọc được.

Bắt đầu

Hãy làm theo các bước sau để định cấu hình và sử dụng máy chủ MCP của Google Ads.

Điều kiện tiên quyết

Trước khi định cấu hình, hãy đảm bảo bạn có các thông tin đăng nhập sau đây từ Bảng điều khiển dành cho nhà phát triển Google Ads:

  • Mã của nhà phát triển: Chuỗi truy cập duy nhất gồm 22 ký tự.
  • Mã dự án: Giá trị nhận dạng dự án trên đám mây của bạn trên Google Cloud.
  • Tệp thông tin đăng nhập: Một credentials.json được uỷ quyền (OAuth 2.0 hoặc tài khoản dịch vụ).

Cấu hình

Để tích hợp máy chủ vào một máy chủ lưu trữ tương thích với MCP, hãy thêm mục sau vào tệp cấu hình MCP của máy chủ lưu trữ (ví dụ: settings.json). Tham khảo tài liệu của máy chủ lưu trữ để biết vị trí và tên tệp chính xác của cấu hình này.

JSON

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Các chức năng cốt lõi (công cụ)

Máy chủ này cung cấp các công cụ được thiết kế để báo cáo hiệu suất và khám phá tài khoản:

  • list_accessible_customers: Trả về danh sách mã khách hàng Google Ads và tên tài khoản mà người dùng đã xác thực có thể truy cập.
  • search: Thực thi các yêu cầu Ngôn ngữ truy vấn của Google Ads (GAQL) để tìm nạp các chỉ số, ngân sách và trạng thái của chiến dịch.

Câu lệnh mẫu để bắt đầu

Hỏi xem máy chủ có thể làm gì:

What can the google-ads-mcp server do?

Hỏi về khách hàng:

What customers do I have access to?

Hỏi về chiến dịch:

How many active campaigns do I have?
How is my campaign performance this week?

Tài nguyên và dịch vụ hỗ trợ của cộng đồng