سرور MCP گوگل ادز: راهنمای ادغام توسعه‌دهندگان

پروتکل زمینه مدل (MCP) یک استاندارد باز است که مدل‌های زبان بزرگ (LLM) را قادر می‌سازد تا به طور ایمن با داده‌ها و برنامه‌های خارجی تعامل داشته باشند. سرور MCP گوگل ادز یک پل استاندارد به API گوگل ادز ارائه می‌دهد و به عوامل هوش مصنوعی اجازه می‌دهد تا داده‌های کمپین را با استفاده از زبان طبیعی تجزیه و تحلیل و بازیابی کنند.

نمای کلی فنی

با پیاده‌سازی این سرور MCP، نیاز به نوشتن «کد چسب» سفارشی برای احراز هویت API گوگل ادز، واکشی منابع و تجزیه داده‌ها را از بین می‌برید. این سرور ابزارهای خاصی را در اختیار قرار می‌دهد که یک LLM می‌تواند به صورت خودکار آنها را کشف و فراخوانی کند.

مشخصات کلیدی

  • پروتکل: MCP (پروتکل زمینه مدل)
  • حالت: فقط خواندنی (نسخه فعلی)
  • زبان: پایتون
  • انتقال: ورودی/خروجی استاندارد ( stdio )
  • احراز هویت: OAuth 2.0 یا حساب سرویس

نحوه عملکرد حلقه تعامل

  1. درخواست: کاربر سوالی مانند «عملکرد کمپین من این هفته چگونه است؟» ارسال می‌کند.
  2. کشف: LLM ابزارهای موجود خود را بررسی کرده و قابلیت‌های جستجوی google-ads-mcp را شناسایی می‌کند.
  3. اجرا: سرور MCP منطق پایتون زیربنایی را برای پرس‌وجو از API تبلیغات گوگل اجرا می‌کند.
  4. تزریق متن: نتایج ساختاریافته به پنجره متن LLM بازگردانده می‌شوند.
  5. پاسخ: LLM داده‌ها را به یک پاسخ قابل خواندن توسط انسان تبدیل می‌کند.

شروع کنید

برای پیکربندی و استفاده از سرور MCP گوگل ادز، این مراحل را دنبال کنید.

پیش‌نیازها

قبل از پیکربندی، مطمئن شوید که اطلاعات احراز هویت زیر را از کنسول توسعه‌دهندگان گوگل ادز دارید:

  • توکن توسعه‌دهنده: رشته دسترسی ۲۲ کاراکتری منحصر به فرد شما.
  • شناسه پروژه: شناسه پروژه Google Cloud شما.
  • فایل اعتبارنامه‌ها: یک credentials.json مجاز (OAuth 2.0 یا حساب کاربری سرویس).

پیکربندی

برای ادغام سرور در یک میزبان سازگار با MCP، ورودی زیر را به فایل پیکربندی MCP میزبان خود اضافه کنید (مثلاً settings.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"
      }
    }
  }
}

قابلیت‌های اصلی (ابزارها)

این سرور ابزارهایی را که برای کشف حساب کاربری و گزارش عملکرد طراحی شده‌اند، در معرض نمایش قرار می‌دهد:

  • list_accessible_customers : فهرست شناسه‌های مشتری و نام‌های حساب کاربری گوگل ادز که برای کاربر احراز هویت‌شده قابل دسترسی هستند را برمی‌گرداند.
  • search : درخواست‌های زبان جستجوی گوگل ادز (GAQL) را برای دریافت معیارها، بودجه‌ها و وضعیت کمپین اجرا می‌کند.

نمونه سوالات برای شروع

بپرسید که پیشخدمت چه کاری می‌تواند انجام دهد :

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?

منابع و پشتیبانی جامعه