استخدام خادم MCP في "مدير إعلانات Google"

تقدّم "مدير إعلانات Google" خادمًا بعيدًا لبروتوكول سياق النموذج (MCP) يتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع شبكات "مدير إعلانات Google" والمستودع الإعلاني والطلبات وبيانات المستخدمين. من خلال ضبط خادم MCP في "مدير إعلانات Google"، يمكنك السماح لتطبيقات الذكاء الاصطناعي، مثل Google Antigravity وClaude وChatGPT، بتنفيذ إجراءات بصفتك مستخدمًا في "مدير إعلانات Google".

يتوفّر خادم MCP على https://admanager.googleapis.com/mcp.

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

  • يجب أن يكون لديك إذن بإنشاء مشاريع على Google Cloud أو إذن بالاطّلاع على مشروع حالي على Google Cloud.
  • إمكانية تعديل عمليات الربط أو التطبيقات في عملاء الذكاء الاصطناعي (مثل ChatGPT أو Claude)

ضبط خادم MCP في "مدير إعلانات Google"

لاستخدام خادم بروتوكول سياق النموذج (MCP) في إدارة الإعلانات، يجب إكمال الخطوات التالية:

  • فعِّل واجهة برمجة التطبيقات Ad Manager API في مشروعك على Google Cloud.
  • إعداد مصادقة المستخدم النهائي في OAuth 2.0
  • أضِف خادم MCP إلى عميل الذكاء الاصطناعي.

تفعيل Ad Manager API

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

تفعيل واجهة برمجة التطبيقات

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

  1. في Google Cloud Console، انتقِل إلى منصة Google للمصادقة > تصميم العلامة التجارية.

    الانتقال إلى "هوية العلامة التجارية"

  2. إذا سبق لك إعداد منصّة Google للمصادقة، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّه لم يتم إعداد منصة Google Auth بعد، انقر على البدء:

    1. في قسم معلومات التطبيق، أدخِل Ad Manager MCP Server أو الاسم المفضّل في حقل اسم التطبيق.
    2. في البريد الإلكتروني المخصّص لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة مناسبة.
    3. انقر على التالي.
    4. بالنسبة إلى الجمهور، اختَر داخلي.
    5. انقر على التالي.
    6. في حقل معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات عليه بشأن أي تغييرات تطرأ على مشروعك.
    7. انقر على التالي.
    8. في قسم إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API وإذا كنت توافق عليها، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
    9. انقر على متابعة.
    10. انقر على إنشاء.

  3. انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ستظهر لوحة تتضمّن قائمة بنطاقات كل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.

    1. ضمن إضافة النطاقات يدويًا، أدخِل نطاقات OAuth المطلوبة لخادم MCP في "مدير إعلانات Google":
      • https://www.googleapis.com/auth/admanager (وصول كامل للاطّلاع على الحملات وإدارتها)
    2. انقر على إضافة إلى الجدول.
    3. انقر على تعديل.
    4. بعد اختيار النطاقات التي يتطلّبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

إضافة خادم MCP إلى عميل الذكاء الاصطناعي

لإضافة خادم MCP في "مدير إعلانات Google" إلى عميل الذكاء الاصطناعي، اتّبِع التعليمات الخاصة بالعميل:

Antigravity

لإضافة خادم MCP في "مدير إعلانات Google" إلى Antigravity، أكمِل الخطوات التالية:

  1. أنشئ معرّف عميل وسر عميل OAuth 2.0:

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://antigravity.google/oauth-callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

  2. لإضافة خادم MCP في "مدير إعلانات Google" إلى Antigravity، عدِّل ملف ~/.gemini/config/mcp_config.json على النحو التالي:

    {
  "mcpServers": {
    "AdManager-MCP": {
      // Use your chosen MCP server URL.
      "serverUrl": "https://admanager.googleapis.com/mcp",
      "oauth": {
        "clientId": "CLIENT_ID",
        "clientSecret": "CLIENT_SECRET"
      }
    }
  }
}

    استبدِل CLIENT_ID وCLIENT_SECRET ببيانات اعتماد عميل OAuth 2.0.

  3. لمصادقة خادم MCP في "مدير إعلانات Google"، يُرجى الاطّلاع على Antigravity: المصادقة باستخدام OAuth.

Claude.ai

لإضافة خادم MCP في "مدير إعلانات Google" إلى Claude.ai، عليك إعداد أداة ربط مخصّصة باستخدام معرّف عميل OAuth وسر عميل OAuth:

  1. أنشئ معرّف عميل وسر عميل OAuth 2.0:

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://claude.ai/api/mcp/auth_callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

  2. اتّبِع التعليمات لإنشاء موصّل مخصّص. أدخِل معرّف العميل وسر العميل في قائمة الإعدادات المتقدّمة.

Claude Code

لإضافة خادم MCP في "مدير إعلانات Google" إلى Claude Code، اضبط موصّلاً مخصّصًا باستخدام معرّف عميل OAuth وسر عميل OAuth:

  1. تثبيت Claude Code

  2. أنشئ معرّف عميل وسر عميل OAuth 2.0:

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://claude.ai/api/mcp/auth_callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

  3. اتّبِع التعليمات لإنشاء موصّل مخصّص. أدخِل معرّف العميل وسر العميل في قائمة الإعدادات المتقدّمة.

‫Claude Desktop

لإضافة خادم MCP في "مدير إعلانات Google" إلى Claude Desktop، اضبط موصِّلاً مخصّصًا باستخدام معرّف عميل OAuth وسر عميل OAuth:

  1. تثبيت تطبيق Claude Desktop

  2. أنشئ معرّف عميل وسر عميل OAuth 2.0:

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://claude.ai/api/mcp/auth_callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

  3. اتّبِع التعليمات لإنشاء موصّل مخصّص. أدخِل معرّف العميل وسر العميل في قائمة الإعدادات المتقدّمة.

ChatGPT

يجب أن يكون لديك اشتراك في ChatGPT Business لاستخدام خادم MCP في "إدارة إعلانات Google" مع ChatGPT.

لإضافة خادم MCP إلى ChatGPT، عليك إنشاء معرّف عميل وسرّ عميل لبروتوكول Google OAuth 2.0، ثم إضافة خادم MCP كتطبيق في ChatGPT.

إنشاء معرّف وسر عميل OAuth 2.0

  1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

    الانتقال إلى "إنشاء عميل"

    سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

  2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

  3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

  4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://chatgpt.com/connector_platform_oauth_redirect في الحقل معرّفات الموارد المنتظمة (URI).

  5. انقر على إنشاء. يتم إنشاء العميل.

    يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

  6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

إضافة خادم MCP كتطبيق في ChatGPT

  1. سجِّل الدخول إلى ChatGPT.
  2. فعِّل "وضع مطوّر البرامج".
  3. افتح إعدادات تطبيقات ChatGPT.
  4. انقر على إنشاء تطبيق وأنشئ تطبيقًا لخادم MCP البعيد.
  5. في قسم OAuth، أدخِل معرّف العميل وسر العميل.
  6. أكِّد أنّك على دراية بالمخاطر المرتبطة باستخدام خادم MCP، ثم انقر على إنشاء.

يظهر خادم MCP في قائمة التطبيقات، ويكون جاهزًا للاستخدام من خلال طلبات المحادثة.

المؤشر

لإضافة خادم MCP الخاص بـ "مدير إعلانات Google" إلى Cursor، عليك إنشاء معرّف عميل وسرّ عميل. اضبط خادم MCP باستخدام OAuth الثابت. يستخدم Cursor معرّفات URI لإعادة التوجيه استنادًا إلى الطريقة التي تستخدمها للوصول إلى Cursor، مثل من خلال تطبيق ويب أو تطبيق على الكمبيوتر.

  1. أنشئ معرّف عميل وسر عميل OAuth 2.0:

    وكلاء الويب أو Cursor

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل https://www.cursor.com/agents/mcp/oauth/callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

    أجهزة الكمبيوتر

    1. في Google API Console، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

      الانتقال إلى "إنشاء عميل"

      سيُطلب منك إنشاء مشروع إذا لم يكن لديك مشروع محدّد.

    2. في قائمة نوع التطبيق، اختَر تطبيق الويب.

    3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

    4. في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أدخِل http://localhost:8787/callback في الحقل معرّفات الموارد المنتظمة (URI).

    5. انقر على إنشاء. يتم إنشاء العميل.

      يظهر مربّع الحوار تم إنشاء عميل OAuth 2.0.

    6. في قسم أسرار العميل، انسخ سر العميل واحفظه في مكان آمن. يمكنك نسخه مرة واحدة فقط. وفي حال فقدانها، عليك حذف السر وإنشاء سر جديد.

  2. اتّبِع التعليمات لضبط خادم MCP باستخدام بروتوكول OAuth الثابت.
  3. استخدام خادم MCP في Chat

اختبار خادم MCP في "مدير إعلانات Google"

بعد إعداد عميل MCP ومصادقته، يمكنك التحقّق من الاتصال من خلال تشغيل طلبات اختبارية في واجهة دردشة الذكاء الاصطناعي.

جرِّب طرح الأسئلة التالية على عميل الذكاء الاصطناعي:

  • "أدرِج شبكات "إدارة إعلانات Google" التي يمكنني الوصول إليها".

    تتصل طلبات العميل list_networks لاسترداد رموز شبكة "مدير الإعلانات" وأسماء العرض المرتبطة بحساب المستخدم وعرضها.

  • "العثور على تفاصيل معرِّف الشبكة NETWORK_CODE"

    يستخدم العميل السمة get_network لجلب البيانات الوصفية للشبكة المحدّدة.

  • "اعرض أول 5 طلبات في الشبكة NETWORK_CODE".

    يستدعي العميل list_orders للاستعلام عن الطلبات في شبكتك وتلخيصها.

إذا تم تشغيل الأدوات بنجاح وعرض بيانات "مدير إعلانات Google"، يعني ذلك أنّه تم إعداد اتصال خادم MCP بشكل صحيح.