استفاده از سرور Google Ad Manager MCP

‫Google Ad Manager سرور پروتکل بافتار مدل (MCP) از دور ارائه می‌دهد که به عامل‌های هوشواره امکان می‌دهد به‌طور ایمن با شبکه‌ها، فضای آگهی، سفارش‌ها، و داده‌های کاربر Google Ad Manager تعامل داشته باشند. با پیکربندی سرور Ad Manager MCP، به برنامه‌های هوش مصنوعی مثل Google Antigravity،‏ Claude، و ChatGPT اجازه می‌دهید کنش‌هایی را به‌عنوان کاربر Ad Manager شما انجام دهند.

سرور MCP در https://admanager.googleapis.com/mcp دردسترس است.

پیش‌نیازها

  • دسترسی به ایجاد پروژه‌های Google Cloud یا دسترسی به مشاهده پروژه Google Cloud موجود.
  • دسترسی به ویرایش اتصالات یا «برنامه‌ها» در کارخواه‌های هوش مصنوعی (برای نمونه، ChatGPT یا Claude).

پیکربندی سرور Ad Manager MCP

برای استفاده از سرور Ad Manager MCP، باید مراحل زیر را تکمیل کنید:

  • «میانای برنامه‌سازی کاربردی Ad Manager» را در پروژه Google Cloud خود فعال کنید.
  • اصالت‌سنجی کاربر نهایی OAuth 2.0 را پیکربندی کنید.
  • سرور MCP را به کارخواه هوش مصنوعی خود اضافه کنید.

فعال کردن Ad Manager API

برای استفاده از سرور Ad Manager MCP، باید Ad Manager API را در پروژه Google Cloud خود فعال کنید. اگر لازم است پروژه Google Cloud ایجاد کنید، پروژه جدید را ببینید.

فعال کردن میانای برنامه‌سازی کاربردی

سرور Ad Manager MCP از OAuth 2.0 برای اصالت‌سنجی و مجوز کاربر نهایی استفاده می‌کند. وقتی کارخواه هوش مصنوعی به سرور MCP متصل می‌شود، به‌عنوان کاربری که کارخواه هوش مصنوعی را اجرا می‌کند اصالت‌سنجی می‌شود. عامل هوش مصنوعی دقیقاً نقش‌های کاربر Google Ad Manager، عضویت‌های شبکه، و اجازه‌های کاربر را به ارث می‌برد.

  1. در کنسول Google Cloud، به پلاتفرم اصالت‌سنجی Google > نمانام‌سازی بروید.

    رفتن به نمانام‌سازی

  2. اگر قبلاً پلاتفرم Google Auth را پیکربندی کرده‌اید، می‌توانید تنظیمات «صفحه رضایت 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 موردنیاز برای سرور Ad Manager MCP را وارد کنید:
      • ‫https://www.googleapis.com/auth/admanager (دسترسی کامل برای مشاهده و مدیریت پویش‌ها)
    2. روی افزودن به جدول کلیک کنید.
    3. روی به‌روزرسانی کلیک کنید.
    4. پس‌از انتخاب کردن دامنه‌های موردنیاز برنامه‌تان، در صفحه دسترسی به داده، روی ذخیره کلیک کنید.

سرور MCP را به کارخواه هوش مصنوعی خود اضافه کنید

برای افزودن سرور Ad Manager MCP به کارخواه هوش مصنوعی خود، دستورالعمل‌های کارخواه خود را دنبال کنید:

Antigravity

برای افزودن سرور Ad Manager MCP به Antigravity، مراحل زیر را تکمیل کنید:

  1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد مشتری»

      اگر پروژه‌ای را انتخاب نکرده باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://antigravity.google/oauth-callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

  2. برای افزودن سرور Ad Manager MCP به 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: Authenticate with OAuth مراجعه کنید.

Claude.ai

برای افزودن سرور Ad Manager MCP به Claude.ai، اتصال‌دهنده سفارشی را با شناسه کارخواه OAuth و رمز کارخواه OAuth پیکربندی کنید:

  1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد کارخواه»

      اگر پروژه‌ای را انتخاب نکرده باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://claude.ai/api/mcp/auth_callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

  2. برای ایجاد اتصال‌دهنده سفارشی، دستورالعمل‌ها را دنبال کنید. شناسه کارخواه و رمز کارخواه خود را در منو تنظیمات پیشرفته وارد کنید.

Claude Code

برای افزودن سرور Ad Manager MCP به Claude Code، اتصال‌دهنده سفارشی را با شناسه کارخواه OAuth و رمز کارخواه OAuth پیکربندی کنید:

  1. نصب کد Claude.

  2. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد مشتری»

      اگر پروژه انتخاب‌شده‌ای نداشته باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://claude.ai/api/mcp/auth_callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

  3. دستورالعمل‌های ایجاد اتصال‌دهنده سفارشی را دنبال کنید. شناسه کارخواه و رمز کارخواه خود را در منو تنظیمات پیشرفته وارد کنید.

Claude Desktop

برای افزودن سرور MCP «مدیر آگهی» به Claude Desktop، یک اتصال‌دهنده سفارشی با شناسه کارخواه OAuth و رمز کارخواه OAuth پیکربندی کنید:

  1. ‫Claude Desktop را نصب کنید.

  2. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد مشتری»

      اگر پروژه انتخاب‌شده‌ای نداشته باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://claude.ai/api/mcp/auth_callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

  3. برای ایجاد اتصال‌دهنده سفارشی، دستورالعمل‌ها را دنبال کنید. شناسه کارخواه و رمز کارخواه خود را در منو تنظیمات پیشرفته وارد کنید.

ChatGPT

برای استفاده از سرور Ad Manager MCP با ChatGPT، باید اشتراک ChatGPT Business داشته باشید.

برای افزودن سرور MCP به ChatGPT، شناسه و رمز مشتری Google OAuth 2.0 ایجاد کنید، و سپس سرور MCP را به‌عنوان «برنامه» در ChatGPT اضافه کنید.

ایجاد رمز و شناسه کارخواه OAuth 2.0

  1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

    رفتن به «ایجاد مشتری»

    اگر پروژه انتخاب‌شده‌ای نداشته باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

  2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

  3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

  4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://chatgpt.com/connector_platform_oauth_redirect را در فیلد نشانی‌های وب وارد کنید.

  5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

    کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

  6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

افزودن سرور MCP به‌عنوان برنامه در ChatGPT

  1. به سیستم ChatGPT وارد شوید.
  2. حالت توسعه‌دهنده را روشن کنید.
  3. تنظیمات برنامه‌های ChatGPT را باز کنید.
  4. روی ایجاد برنامه کلیک کنید و برنامه‌ای برای سرور MCP از دور ایجاد کنید.
  5. در بخش OAuth، شناسه و رمز کارخواه خود را ارائه دهید.
  6. تأیید کنید که خطر مرتبط با استفاده از سرور MCP را درک می‌کنید، و سپس روی ایجاد کلیک کنید.

سرور MCP در منو برنامه‌ها نمایش داده می‌شود و برای استفاده ازطریق پیام‌واره‌های گپ آماده است.

مکان‌نما

برای افزودن سرور MCP مربوط به Ad Manager به Cursor، شناسه کارخواه و رمز ایجاد کنید. سرور MCP را با OAuth ایستا پیکربندی کنید. ‫Cursor بسته به اینکه از چه چیزی برای دسترسی به Cursor استفاده می‌کنید— مثلاً ازطریق وب یا برنامه رایانه— از نشانی‌های وب هدایت استفاده می‌کند.

  1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    عامل‌های وب یا مکان‌نما

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد مشتری»

      اگر پروژه انتخاب‌شده‌ای نداشته باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://www.cursor.com/agents/mcp/oauth/callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

    رایانه

    1. در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

      رفتن به «ایجاد مشتری»

      اگر پروژه انتخاب‌شده‌ای نداشته باشید، از شما خواسته می‌شود پروژه‌ای ایجاد کنید.

    2. در فهرست نوع برنامه، برنامه وب را انتخاب کنید.

    3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

    4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس http://localhost:8787/callback را در فیلد نشانی‌های وب وارد کنید.

    5. روی ایجاد کردن کلیک کنید. کارخواه ایجاد می‌شود.

      کادر گفتگوی کارخواه OAuth 2.0 ایجاد شد باز می‌شود.

    6. در بخش رمزهای کارخواه، رمز کارخواه را کپی کنید و آن را در مکانی امن ذخیره کنید. فقط یک‌بار می‌توانید آن را کپی کنید. اگر آن را گم کردید، رمز را حذف کنید و رمز جدیدی ایجاد کنید.

  2. دستورالعمل‌های پیکربندی سرور MCP با OAuth ایستا را دنبال کنید.
  3. از سرور MCP در Chat استفاده کنید.

سرور MCP مربوط به Ad Manager را آزمایش کنید

پس‌از پیکربندی و اصالت‌سنجی کردن کارخواه MCP، می‌توانید با اجرای پیام‌واره‌های آزمایشی در میانای گپ هوش مصنوعی، اتصال را درستی‌سنجی کنید.

پرسش‌های زیر را از مشتری هوش مصنوعی خود بپرسید:

  • «شبکه‌های Google Ad Manager را که به آن‌ها دسترسی دارم فهرست کن.»

    کارخواه list_networks را فرا می‌خواند تا کدهای شبکه و نام‌های نمایشی مرتبط با حساب کاربری شما را بازیابی و نمایش دهد.

  • «جزئیات کد شبکه NETWORK_CODE را پیدا کن.»

    کارخواه از get_network برای واکشی فراداده‌های شبکه مشخص‌شده استفاده می‌کند.

  • «۵ سفارش اول را در شبکه NETWORK_CODE نشان بده.»

    مشتری list_orders را برای پرسمان سفارش‌ها در شبکه شما و خلاصه کردن آن‌ها فراخوانی می‌کند.

اگر ابزارها با موفقیت اجرا شوند و داده‌های Google Ad Manager را برگردانند، اتصال سرور MCP شما به‌درستی پیکربندی شده است.