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

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

तकनीकी जानकारी

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

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

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

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

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

अपनी प्रोफ़ाइल बनाना शुरू करें

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

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

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

डेवलपर टोकन: यह 22 वर्णों वाली आपकी यूनीक ऐक्सेस स्ट्रिंग होती है.
प्रोजेक्ट आईडी: यह आपके Google Cloud प्रोजेक्ट का आइडेंटिफ़ायर होता है.
क्रेडेंशियल फ़ाइल: अनुमति दिया गया credentials.json (OAuth 2.0 या सेवा खाता).

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

सर्वर को एमसीपी के साथ काम करने वाले होस्ट में इंटिग्रेट करने के लिए, अपने होस्ट की एमसीपी कॉन्फ़िगरेशन फ़ाइल में यह एंट्री जोड़ें. उदाहरण के लिए, 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_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

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

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

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

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

सर्वर से पूछें कि वह क्या-क्या कर सकता है:

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?

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

GitHub रिपॉज़िटरी: google-ads-mcp रिपॉज़िटरी में डेमो और उदाहरण देखें. साथ ही, गड़बड़ियों की शिकायत करें या सुविधाओं के बारे में सुझाव दें. गड़बड़ी की रिपोर्ट और सुविधा के अनुरोधों के लिए, समस्याएं टैब का इस्तेमाल करें.
कम्यूनिटी: Google Advertising Community Discord पर #ads-api-ai-tools चैनल में शामिल हों.