خادم MCP في "إعلانات Google": دليل الدمج للمطوّرين

بروتوكول سياق النموذج (MCP) هو معيار مفتوح يتيح للنماذج اللغوية الكبيرة التفاعل بشكل آمن مع البيانات والتطبيقات الخارجية. يوفّر خادم MCP في "إعلانات Google" جسرًا موحّدًا إلى واجهة برمجة التطبيقات الخاصة بـ "إعلانات Google"، ما يتيح لوكلاء الذكاء الاصطناعي تحليل بيانات الحملات واستردادها باستخدام اللغة الطبيعية.

نظرة عامة فنية

من خلال تنفيذ خادم MCP هذا، لن تحتاج إلى كتابة "رمز ربط" مخصّص للمصادقة على Google Ads API، واسترداد الموارد، وتحليل البيانات. يعرض الخادم أدوات معيّنة يمكن أن يكتشفها نموذج لغوي كبير ويستخدمها بشكل مستقل.

المواصفات الرئيسية

  • البروتوكول: MCP (Model Context Protocol)
  • الوضع: للقراءة فقط (الإصدار الحالي)
  • اللغة: Python
  • النقل: الإدخال/الإخراج العادي (stdio)
  • المصادقة: OAuth 2.0 أو حساب الخدمة

طريقة عمل حلقة التفاعل

  1. الطلب: يرسل المستخدم طلب بحث مثل "كيف كان أداء حملتي هذا الأسبوع؟".
  2. الاستكشاف: يفحص النموذج اللغوي الكبير الأدوات المتاحة له ويحدّد google-ads-mcp إمكانات البحث.
  3. التنفيذ: ينفّذ خادم MCP منطق Python الأساسي للاستعلام عن Google Ads API.
  4. إدخال السياق: يتم عرض النتائج المنظَّمة في نافذة سياق النموذج اللغوي الكبير.
  5. الردّ: يجمع النموذج اللغوي الكبير البيانات في ردّ يمكن لشخص عادي قراءته.

البدء

اتّبِع الخطوات التالية لإعداد خادم MCP في "إعلانات Google" واستخدامه.

المتطلبات الأساسية

قبل إجراء الإعداد، تأكَّد من توفّر بيانات الاعتماد التالية من وحدة تحكّم المطوّرين في "إعلانات Google":

  • الرمز المميز للمطوِّر: هو سلسلة الدخول الفريدة المكوّنة من 22 حرفًا.
  • رقم تعريف المشروع: رقم تعريف مشروعك على Google Cloud
  • ملف بيانات الاعتماد: credentials.json معتمَد (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_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

الإمكانات الأساسية (الأدوات)

يعرض الخادم أدوات مصمّمة لاكتشاف الحسابات وإعداد تقارير الأداء:

  • ‫list_accessible_customers: تعرض هذه السمة قائمة بأرقام تعريف عملاء "إعلانات Google" وأسماء الحسابات التي يمكن للمستخدم الذي تمّت مصادقته الوصول إليها.
  • search: تنفّذ طلبات لغة طلب البحث في "إعلانات Google" (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?

المراجع والدعم من المنتدى