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

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) एक ओपन स्टैंडर्ड है. इससे बड़े लैंग्वेज मॉडल (एलएलएम), बाहरी डेटा और ऐप्लिकेशन के साथ सुरक्षित तरीके से इंटरैक्ट कर पाते हैं. Google Ads MCP सर्वर, 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 MCP सर्वर को कॉन्फ़िगर करने और उसका इस्तेमाल करने के लिए, यह तरीका अपनाएं.

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

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

• डेवलपर टोकन: यह 22 वर्णों वाली आपकी यूनीक ऐक्सेस स्ट्रिंग होती है.
• प्रोजेक्ट आईडी: यह आपके Google Cloud प्रोजेक्ट का आइडेंटिफ़ायर होता है.
• OAuth क्रेडेंशियल: OAuth2 क्लाइंट आईडी/क्लाइंट सीक्रेट का जोड़ा या ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का सेट.

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

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

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. इमेज बनाना और सबमिट करना:

   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_DEVELOPER_TOKEN: वह डेवलपर टोकन जिसका इस्तेमाल एमसीपी सर्वर को करना है.
• GOOGLE_ADS_MCP_OAUTH_CLIENT_ID: वह OAuth क्लाइंट आईडी जिसका इस्तेमाल MCP सर्वर को करना है.
• GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET: वह OAuth क्लाइंट सीक्रेट जिसे आपको MCP सर्वर के लिए इस्तेमाल करना है.
• 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_DEVELOPER_TOKEN=YOUR_DEVELOPER_TOKEN,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 क्वेरी लैंग्वेज (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