Google Ads एमसीपी सर्वर: डेवलपर इंटिग्रेशन गाइड

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) एक ओपन स्टैंडर्ड है. इसकी मदद से, बड़े लैंग्वेज मॉडल (एलएलएम), बाहरी डेटा और ऐप्लिकेशन के साथ सुरक्षित तरीके से इंटरैक्ट कर सकते हैं. Google Ads का एमसीपी सर्वर, Google Ads API के लिए एक स्टैंडर्ड ब्रिज उपलब्ध कराता है. इसकी मदद से, एआई एजेंट, नैचुरल लैंग्वेज का इस्तेमाल करके कैंपेन के डेटा का विश्लेषण और उसे वापस पा सकते हैं.

कम्यूनिटी के संसाधन और सहायता

  • GitHub रिपॉज़िटरी: google-ads-mcp रिपॉज़िटरी में डेमो और उदाहरण देखें. साथ ही, बग की शिकायत करें या सुविधाओं के बारे में सुझाव दें.

    बग की शिकायतें और सुविधाओं के अनुरोध करने के लिए, 'समस्याएं' टैब का इस्तेमाल करें.

  • कम्यूनिटी: Google Advertising Community Discord पर, #ads-api-ai-tools चैनल में शामिल हों.

टेक्नोलॉजी की खास जानकारी

इस एमसीपी सर्वर को लागू करने पर, आपको Google Ads API की पुष्टि करने, संसाधन फ़ेच करने, और डेटा पार्स करने के लिए, "ग्लू कोड" लिखने की ज़रूरत नहीं होती. यह सर्वर, खास टूल उपलब्ध कराता है. एलएलएम इन टूल को अपने-आप खोज सकता है और उन्हें चालू कर सकता है.

मुख्य स्पेसिफ़िकेशन

  • प्रोटोकॉल: एमसीपी (मॉडल कॉन्टेक्स्ट प्रोटोकॉल)
  • मोड: रीड-ओनली (मौजूदा रिलीज़)
  • भाषा: Python
  • ट्रांसपोर्ट: स्टैंडर्ड इनपुट/आउटपुट (stdio)
  • पुष्टि करना: OAuth 2.0 या सेवा खाता

इंटरैक्शन लूप कैसे काम करता है

  1. अनुरोध: कोई उपयोगकर्ता, "इस हफ़्ते मेरे कैंपेन की परफ़ॉर्मेंस कैसी है?" जैसी क्वेरी सबमिट करता है.
  2. खोज: एलएलएम, अपने उपलब्ध टूल की जांच करता है और google-ads-mcp की खोज की क्षमताओं की पहचान करता है.
  3. एक्ज़ीक्यूशन: एमसीपी सर्वर, Google Ads API से क्वेरी करने के लिए, Python के लॉजिक को एक्ज़ीक्यूट करता है.
  4. कॉन्टेक्स्ट इंजेक्शन: स्ट्रक्चर्ड नतीजे, एलएलएम की कॉन्टेक्स्ट विंडो में दिखते हैं.
  5. जवाब: एलएलएम, डेटा को ऐसे जवाब में बदलता है जिसे आसानी से पढ़ा जा सके.

शुरू करें

Google Ads के एमसीपी सर्वर को कॉन्फ़िगर करने और उसका इस्तेमाल करने के लिए, यह तरीका अपनाएं.

ज़रूरी शर्तें

कॉन्फ़िगरेशन से पहले, पक्का करें कि आपके पास Google Cloud कंसोल से ये क्रेडेंशियल हों:

कॉन्फ़िगरेशन

सर्वर को एमसीपी के साथ काम करने वाले होस्ट में इंटिग्रेट करने के लिए, अपने होस्ट की एमसीपी कॉन्फ़िगरेशन फ़ाइल में यह एंट्री जोड़ें. जैसे, 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_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Google Cloud पर डिप्लॉय करना

इस एमसीपी सर्वर को स्थानीय तौर पर होस्ट करने के बजाय, इसे Google Cloud Run या क्लाउड-आधारित किसी अन्य इन्फ़्रास्ट्रक्चर पर होस्ट किया जा सकता है. अगर आपको सर्वर को अलग-अलग एजेंट के साथ शेयर करना है या इसे वेब सेवा के तौर पर रन करना है, तो यह तरीका काम का है.

ज़रूरी शर्तें

  1. Google Cloud प्रोजेक्ट.

  2. gcloud कमांड-लाइन टूल इंस्टॉल किया गया हो, पुष्टि की गई हो, और कोई एक्टिव प्रोजेक्ट कॉन्फ़िगर किया गया हो:

    gcloud config set project YOUR_PROJECT_ID

डॉकर इमेज बनाना और उसे पुश करना

Cloud Build का इस्तेमाल करके, इमेज को बनाया और Artifact Registry में पुश किया जा सकता है. इसके लिए, स्थानीय तौर पर Docker इंस्टॉल करने की ज़रूरत नहीं होती.

  1. Artifact Registry में कोई रिपॉज़िटरी बनाएं:

    gcloud artifacts repositories create mcp-servers --repository-format=docker --location=us-central1

  2. प्रोजेक्ट डायरेक्ट्री पर जाएं:

    cd <full path>/google-ads-mcp

  3. इमेज बनाएं और उसे सबमिट करें:

    gcloud builds submit --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest .

    ध्यान दें कि डिप्लॉय किए गए सर्वर को नए वर्शन में अपडेट करने के लिए, आपको यह चरण हर बार पूरा करना होगा.

Google Cloud Run पर डिप्लॉय करें

पक्का करें कि ज़रूरी एनवायरमेंट वैरिएबल सेट किए गए हों:

  • GOOGLE_PROJECT_ID: आपके Google Cloud प्रोजेक्ट का आईडी, जिसके पास एपीआई ऐक्सेस के सही लेवल हों.
  • GOOGLE_ADS_MCP_OAUTH_CLIENT_ID: वह OAuth क्लाइंट आईडी जिसका इस्तेमाल एमसीपी सर्वर को करना है.
  • GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET: वह OAuth क्लाइंट सीक्रेट जिसका इस्तेमाल एमसीपी सर्वर को करना है.
  • GOOGLE_ADS_MCP_BASE_URL: वह बेस यूआरएल जहां आपका एमसीपी सर्वर ऐक्सेस किया जा सकता है. पहले डिप्लॉयमेंट के बाद, इसे Google Cloud Run अपने-आप असाइन करेगा. डिप्लॉयमेंट के बाद, एनवायरमेंट वैरिएबल अपडेट किए जा सकते हैं.
  • FASTMCP_HOST: इसे 0.0.0.0 पर सेट करें, ताकि FastMCP सभी आईपी पतों से कनेक्शन स्वीकार कर सके.
gcloud run deploy google-ads-mcp \
  --image us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars="GOOGLE_PROJECT_ID=YOUR_PROJECT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=YOUR_CLIENT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=YOUR_CLIENT_SECRET,GOOGLE_ADS_MCP_BASE_URL=YOUR_BASE_URL,FASTMCP_HOST=0.0.0.0"

एमसीपी क्लाइंट को कॉन्फ़िगर करना

डिप्लॉयमेंट के बाद, Cloud Run यूआरएल का इस्तेमाल करने के लिए, अपने एमसीपी क्लाइंट के कॉन्फ़िगरेशन (उदाहरण के लिए, ~/.gemini/settings.json) को अपडेट करें.

{
  "mcpServers": {
    "google-ads-mcp": {
      "httpUrl": "https://your-cloud-run-url.a.run.app/mcp"
    }
  }
}

मुख्य सुविधाएं (टूल)

यह सर्वर, खाते की खोज और परफ़ॉर्मेंस की रिपोर्टिंग के लिए डिज़ाइन किए गए टूल उपलब्ध कराता है:

  • list_accessible_customers: पुष्टि किए गए उपयोगकर्ता के लिए, Google Ads के ग्राहक आईडी और खाते के नामों की सूची दिखाता है.
  • search: संसाधन के मेट्रिक, बजट, और स्टेटस को फ़ेच करने के लिए, Google Ads Query Language (GAQL) के अनुरोधों को एक्ज़ीक्यूट करता है.

  • get_resource_metadata: Google Ads API के संसाधन टाइप के बारे में मेटाडेटा वापस लाता है. जैसे, "कैंपेन".

    यह डेटा के स्ट्रक्चर और क्वेरी करने के लिए उपलब्ध फ़ील्ड को समझने में मददगार है.

शुरू करने के लिए प्रॉम्प्ट के सैंपल

सर्वर क्या-क्या कर सकता है, यह पूछने के लिए प्रॉम्प्ट:

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?
Give me a report of the top spending campaigns split by device category over the
last 7 days for account 1234567890