שימוש בשרת MCP של Google Ad Manager

ב-Google Ad Manager יש שרת Model Context Protocol‏ (MCP) מרוחק שמאפשר לסוכני AI ליצור אינטראקציה מאובטחת עם רשתות, מלאי שטחי פרסום, הזמנות ונתוני משתמשים ב-Google Ad Manager. הגדרת שרת MCP של Ad Manager מאפשרת לאפליקציות AI כמו Google Antigravity,‏ Claude ו-ChatGPT לבצע פעולות בתור משתמש Ad Manager.

שרת ה-MCP זמין בכתובת https://admanager.googleapis.com/mcp.

דרישות מוקדמות

  • גישה ליצירת פרויקטים ב-Google Cloud או גישה לצפייה בפרויקט קיים ב-Google Cloud.
  • גישה לעריכת חיבורים או אפליקציות בלקוחות ה-AI (לדוגמה, ChatGPT או Claude).

הגדרת שרת ה-MCP של Ad Manager

כדי להשתמש בשרת ה-MCP של Ad Manager, צריך לבצע את השלבים הבאים:

  • מפעילים את Ad Manager API בפרויקט בענן ב-Google.
  • הגדרת אימות משתמשי קצה באמצעות OAuth 2.0.
  • מוסיפים את שרת ה-MCP ללקוח ה-AI.

הפעלת Ad Manager API

כדי להשתמש בשרת Ad Manager MCP, צריך להפעיל את Ad Manager API בפרויקט ב-Google Cloud. אם אתם צריכים ליצור פרויקט ב-Google Cloud, תוכלו לעיין במאמר בנושא פרויקט חדש.

הפעלה של ה-API

שרת ה-MCP של Ad Manager משתמש ב-OAuth 2.0 לאימות משתמשי קצה ולמתן הרשאות. כשלקוח AI מתחבר לשרת ה-MCP, הוא מאומת בתור המשתמש שמריץ את לקוח ה-AI. סוכן ה-AI יורש את תפקידי המשתמש, החברות ברשתות וההרשאות ב-Google Ad Manager בדיוק כמו המשתמש.

  1. במסוף Google Cloud, עוברים אל Google Auth Platform > Branding.

    מעבר לדף Branding

  2. אם כבר הגדרתם את פלטפורמת האימות של Google, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience וData Access. אם מופיעה ההודעה Google Auth Platform not configured yet, לוחצים על Get Started:

    1. בקטע App Information (פרטי האפליקציה), בשדה App name (שם האפליקציה), מזינים את השם Ad Manager MCP Server או שם אחר שרוצים.
    2. בקטע User support email, בוחרים את כתובת האימייל או קבוצה מתאימה.
    3. לוחצים על הבא.
    4. בקטע קהל, בוחרים באפשרות פנימי.
    5. לוחצים על הבא.
    6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
    7. לוחצים על הבא.
    8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, מסמנים את התיבה I agree to the Google API Services: User Data Policy.
    9. לוחצים על המשך.
    10. לוחצים על יצירה.

  3. לוחצים על גישה לנתונים > הוספה או הסרה של היקפי גישה. יופיע חלונית עם רשימה של היקפי הרשאות לכל API שהפעלתם בפרויקט Google Cloud.

    1. בקטע הוספה ידנית של היקפי הרשאות, מזינים את היקפי ההרשאות של OAuth שנדרשים לשרת ה-MCP של Ad Manager:
      • https://www.googleapis.com/auth/admanager (גישה מלאה לצפייה בקמפיינים ולניהול שלהם)
    2. לוחצים על הוספה לטבלה.
    3. לוחצים על עדכון.
    4. אחרי שבוחרים את היקפי ההרשאות שנדרשים לאפליקציה, לוחצים על שמירה בדף גישה לנתונים.

הוספת שרת ה-MCP ללקוח ה-AI

כדי להוסיף את שרת ה-MCP של Ad Manager ללקוח ה-AI, פועלים לפי ההוראות שמתאימות ללקוח:

Antigravity

כדי להוסיף את שרת ה-MCP של Ad Manager ל-Antigravity, צריך לבצע את השלבים הבאים:

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://antigravity.google/oauth-callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

  2. כדי להוסיף את שרת ה-MCP של Ad Manager ל-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 של Ad Manager, אפשר לעיין במאמר בנושא Antigravity: אימות באמצעות OAuth.

Claude.ai

כדי להוסיף את שרת ה-MCP של Ad Manager אל Claude.ai, צריך להגדיר מחבר מותאם אישית עם מזהה לקוח ב-OAuth וסוד לקוח ב-OAuth:

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://claude.ai/api/mcp/auth_callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

  2. פועלים לפי ההוראות ליצירת מחבר בהתאמה אישית. מזינים את מזהה הלקוח ואת הסוד בתפריט הגדרות מתקדמות.

Claude Code

כדי להוסיף את שרת ה-MCP של Ad Manager ל-Claude Code, צריך להגדיר מחבר מותאם אישית עם מזהה לקוח ב-OAuth וסוד לקוח ב-OAuth:

  1. איך מתקינים את Claude Code

  2. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://claude.ai/api/mcp/auth_callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

  3. פועלים לפי ההוראות ליצירת מחבר בהתאמה אישית. מזינים את מזהה הלקוח ואת הסוד בתפריט הגדרות מתקדמות.

Claude Desktop

כדי להוסיף את שרת ה-MCP של Ad Manager ל-Claude Desktop, צריך להגדיר מחבר בהתאמה אישית עם מזהה לקוח ב-OAuth וסוד לקוח ב-OAuth:

  1. איך מתקינים את Claude Desktop

  2. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://claude.ai/api/mcp/auth_callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

  3. פועלים לפי ההוראות ליצירת מחבר בהתאמה אישית. מזינים את מזהה הלקוח ואת הסוד בתפריט הגדרות מתקדמות.

ChatGPT

כדי להשתמש בשרת MCP של Ad Manager עם ChatGPT, צריך להיות לכם מינוי ל-ChatGPT Business.

כדי להוסיף את שרת ה-MCP ל-ChatGPT, צריך ליצור מזהה לקוח וסוד לקוח של Google OAuth 2.0, ואז להוסיף את שרת ה-MCP כאפליקציה ב-ChatGPT.

יצירת מזהה לקוח וסוד לקוח ב-OAuth 2.0

  1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

    מעבר אל Create client

    אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

  2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

  3. בשדה שם, מזינים שם לאפליקציה.

  4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://chatgpt.com/connector_platform_oauth_redirect בשדה URIs (כתובות URI).

  5. לוחצים על יצירה. הלקוח נוצר.

    תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

  6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

הוספת שרת MCP כאפליקציה ב-ChatGPT

  1. נכנסים לחשבון ב-ChatGPT.
  2. הפעלה של מצב פיתוח
  3. פותחים את ההגדרות של אפליקציות ChatGPT.
  4. לוחצים על יצירת אפליקציה ויוצרים אפליקציה לשרת MCP מרוחק.
  5. בקטע OAuth, מזינים את מזהה הלקוח ואת הסוד.
  6. מאשרים שהבנתם את הסיכון שקשור לשימוש בשרת MCP, ואז לוחצים על יצירה.

שרת ה-MCP מוצג בתפריט אפליקציות, ומוכן לשימוש באמצעות הנחיות בצ'אט.

סמן

כדי להוסיף את שרת ה-MCP של Ad Manager ל-Cursor, צריך ליצור מזהה לקוח וסוד לקוח. מגדירים את שרת ה-MCP עם OAuth סטטי. ‫Cursor משתמש בכתובות URI להפניה אוטומטית בהתאם לדרך שבה אתם ניגשים ל-Cursor – למשל דרך אפליקציית אינטרנט או אפליקציה למחשב.

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    סוכני אינטרנט או סוכני Cursor

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים https://www.cursor.com/agents/mcp/oauth/callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

    מחשב

    1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

      מעבר אל Create client

      אם לא בחרתם פרויקט, תתבקשו ליצור פרויקט.

    2. ברשימה Application type, בוחרים באפשרות אפליקציית אינטרנט.

    3. בשדה שם, מזינים שם לאפליקציה.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מזינים http://localhost:8787/callback בשדה URIs (כתובות URI).

    5. לוחצים על יצירה. הלקוח נוצר.

      תיפתח תיבת הדו-שיח OAuth 2.0 client created (נוצר לקוח OAuth 2.0).

    6. בקטע Client secrets, מעתיקים את Client secret ושומרים אותו במקום מאובטח. אפשר להעתיק אותו רק פעם אחת. אם מאבדים אותו, צריך למחוק את הסוד וליצור סוד חדש.

  2. פועלים לפי ההוראות להגדרת שרת ה-MCP עם OAuth סטטי.
  3. שימוש בשרת ה-MCP ב-Chat.

בדיקת שרת ה-MCP של Ad Manager

אחרי שמגדירים ומאמתים את לקוח ה-MCP, אפשר לאמת את החיבור על ידי הפעלת הנחיות בדיקה בממשק הצ'אט עם AI.

אפשר לשאול את לקוח ה-AI את השאלות הבאות:

  • "תציג את הרשתות ב-Google Ad Manager שיש לי גישה אליהן".

    הלקוח מתקשר אל list_networks כדי לאחזר ולהציג את קודי הרשת של Ad Manager ואת השמות לתצוגה שמשויכים לחשבון המשתמש שלכם.

  • "איתור פרטים של הקוד של הרשת NETWORK_CODE"

    הלקוח משתמש ב-get_network כדי לאחזר את המטא-נתונים של הרשת שצוינה.

  • "הצגת 5 ההזמנות הראשונות ברשת NETWORK_CODE".

    הלקוח מפעיל את list_orders כדי לשלוח שאילתות לגבי הזמנות ברשת שלכם ולסכם אותן.

אם הכלים פועלים בהצלחה ומחזירים נתונים של Google Ad Manager, סימן שהחיבור לשרת ה-MCP מוגדר בצורה נכונה.