Google Ads MCP सर्वर: Google Ads को Claude से कैसे जोड़ें (आधिकारिक)

अपने विज्ञापन अकाउंट से सादी अंग्रेज़ी में सवाल पूछें और कुछ सेकंड में जवाब पाएँ। Google Ads MCP सर्वर यही वादा करता है, यह Google की ओर से आने वाला एक ओपन-सोर्स ब्रिज है, जो Claude जैसे AI असिस्टेंट को आपका लाइव कैंपेन डेटा पढ़ने देता है, ताकि आपको हर बार एक और CSV एक्सपोर्ट न करना पड़े। यह आधिकारिक रास्ता है: Google इसे अपने ही GitHub organization googleads में Apache 2.0 लाइसेंस के तहत प्रकाशित करता है, और आज यह सख़्ती से केवल-पढ़ने वाला (read-only) है। यह सब कुछ देख सकता है और कुछ भी नहीं बदल सकता।

यह लेख बताता है कि Google Ads को Claude से कैसे जोड़ें, पहले कौन से सवाल पूछने लायक हैं, और कौन से जाल चुपचाप गलत आँकड़े देते हैं। एक हालिया बदलाव मायने रखता है: Google ने 9 सितंबर 2026 को developer tokens बंद कर दिए, इसलिए कई पुराने ट्यूटोरियल अब ऐसा सेटअप चरण बताते हैं जिसकी आपको ज़रूरत नहीं रही। नीचे सब कुछ Google के मौजूदा दस्तावेज़ और प्रोजेक्ट README के अनुसार है।

आधिकारिक सर्वर क्या करता है

Model Context Protocol (MCP) एक मानक है, जो AI क्लाइंट को किसी अलग प्रोग्राम द्वारा दिए गए टूल्स को कॉल करने देता है। Google का सर्वर Google Ads API को तीन ऐसे टूल्स में लपेटता है, ताकि Claude आपके अकाउंट खोज सके, क्वेरी चला सके और फ़ील्ड की परिभाषाएँ देख सके, और आपको इंटीग्रेशन कोड का एक भी लाइन नहीं लिखनी पड़ती। यह सर्वर आपकी मशीन पर stdio के ज़रिए चलता है, और Claude उससे वैसे ही बात करता है जैसे किसी और MCP सर्वर से।

उस साप्ताहिक एक्सपोर्ट रूटीन की तुलना में, जिसे ज़्यादातर विज्ञापनदाता अब भी अपनाते हैं, यहाँ यह बदलाव है:

तीन टूल्स, केवल पढ़ने के लिए

व्यवहार में आप क्वेरी खुद कभी नहीं लिखते। आप कहते हैं "पिछले हफ़्ते किन कैंपेन पर सबसे ज़्यादा खर्च हुआ," Claude जाँचता है कि कौन से फ़ील्ड मौजूद हैं, GAQL बनाता है, उसे search के ज़रिए चलाता है, और पंक्तियों का सार बताता है। जो क्वेरी उसने चलाई, वह आप अब भी पढ़ सकते हैं, और इसी से गलतियाँ पकड़ी जाती हैं।

यह क्या नहीं कर सकता

Google के दस्तावेज़ साफ़ कहते हैं कि यह इम्प्लीमेंटेशन "bids नहीं बदल सकता, campaigns को pause नहीं कर सकता, या नए assets नहीं बना सकता।" इसका मतलब है कि ये काम नहीं होते:

• बजट या bids बदलना
• कैंपेन को pause या enable करना
• विज्ञापन बनाना या संपादित करना
• नया क्रिएटिव अपलोड करना

💡 केवल-पढ़ने वाला होना एक फ़ीचर है। मॉडल का गलत जवाब आपकी एक बुरी दोपहर खराब करता है, बजट खाली नहीं करता, क्योंकि उसके पास अकाउंट में कोई बदलाव भेजने का तरीका नहीं है।

कुछ भी जोड़ने से पहले

कॉन्फ़िग फ़ाइल मायने रखने से पहले तीन चीज़ें तैयार होनी चाहिए: सही एक्सेस लेवल वाला Google Cloud प्रोजेक्ट, काम करने वाले credentials, और सर्वर चलाने के लिए लोकल टूलिंग। इनमें से कोई भी छूटने पर ऐसी गलतियाँ आती हैं जो असली कारण से असंबंधित लगती हैं।

Cloud प्रोजेक्ट और एक्सेस लेवल

आपका Google Cloud project ID कॉन्फ़िग में GOOGLE_PROJECT_ID के रूप में जाता है। Cloud console में Google Ads API overview पेज खोलें और जाँचें कि प्रोजेक्ट वहाँ बताए गए तीन एक्सेस लेवलों में से किसी एक पर है: entry लेवल, Basic, या Standard। अगर उनमें से कोई नहीं है, तो एक के लिए आवेदन करें। एक्सेस लेवल अब Cloud प्रोजेक्ट से जुड़े हैं, और यही वजह है कि developer tokens की ज़रूरत खत्म हो गई।

Developer tokens अब नहीं रहे

Google के दस्तावेज़ कहते हैं कि developer tokens (GOOGLE_ADS_DEVELOPER_TOKEN) 9 सितंबर 2026 को बंद कर दिए गए और सर्वर के नवीनतम वर्ज़न में इनकी ज़रूरत नहीं है। GitHub README अब भी इस वेरिएबल को वैकल्पिक बताता है, इसलिए अगर आप पुराना रिलीज़ पिन करते हैं, तो शायद इसे सेट करना पड़े। मौजूदा वर्ज़न पर इसे छोड़ दें।

💡 किसी भी ट्यूटोरियल की तारीख देखें। अगर वह developer token के लिए आवेदन करके मंज़ूरी का इंतज़ार करने को कहता है, तो वह पुराने फ़्लो का वर्णन कर रहा है।

OAuth credentials या ADC

आपको दो में से एक चीज़ चाहिए: उसी प्रोजेक्ट में बना OAuth 2.0 client ID और secret का जोड़ा, या Application Default Credentials (ADC) का सेट। ज़रूरी scope https://www.googleapis.com/auth/adwords है। एक ही यूज़र के लिए gcloud CLI के ज़रिए ADC सबसे छोटा रास्ता है, और नीचे के कमांड यही इस्तेमाल करते हैं।

आगे बढ़ने से पहले ये तैयार रखें:

• pipx इंस्टॉल हो, Python टूल जो सर्वर को सीधे GitHub से चलाता है
• gcloud CLI इंस्टॉल और साइन-इन हो
• एक Google यूज़र जिसे Google Ads अकाउंट तक पहुँच हो
• आपका Cloud project ID

Claude को चरण-दर-चरण जोड़ना

gcloud से साइन इन करें

लॉगिन कमांड चलाएँ, जिसमें सर्वर को चाहिए दोनों scopes हों, और उस OAuth client फ़ाइल की ओर इशारा करें जो आपने डाउनलोड की थी:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

प्रॉम्प्ट कॉपी करें

एक ब्राउज़र विंडो खुलती है, आप scopes को मंज़ूरी देते हैं, और gcloud एक credentials JSON फ़ाइल लिखता है। नोट करें कि वह फ़ाइल कहाँ जाती है, क्योंकि वही पाथ GOOGLE_APPLICATION_CREDENTIALS बनता है। जो टीमें service accounts पसंद करती हैं, वे उसी scopes के साथ --impersonate-service-account=SERVICE_ACCOUNT_EMAIL लगा सकती हैं।

Claude Desktop में जोड़ें

Claude Desktop की कॉन्फ़िग फ़ाइल खोलें: macOS पर ~/Library/Application Support/Claude/claude_desktop_config.json या Windows पर %APPDATA%\Claude\claude_desktop_config.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_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

प्रॉम्प्ट कॉपी करें

Claude Desktop को पूरी तरह बंद करें और फिर से खोलें। पहली बार लॉन्च होने पर सर्वर pipx के ज़रिए डाउनलोड होता है, इसलिए थोड़ा रुकने की उम्मीद रखें। दोहराए जा सकने वाले सेटअप के लिए README सुझाता है कि नवीनतम रिपॉज़िटरी स्थिति के बजाय pipx run --spec "google-ads-mcp==X.Y.Z" google-ads-mcp के साथ एक प्रकाशित वर्ज़न पिन करें।

Claude Code एक कमांड में

Claude Code टर्मिनल से वही सर्वर रजिस्टर कर सकता है:

claude mcp add google-ads-mcp \
  --env GOOGLE_PROJECT_ID=your-project-id \
  --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json \
  -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

प्रॉम्प्ट कॉपी करें

इसके बाद Claude Code के अंदर /mcp चलाएँ और पुष्टि करें कि google-ads-mcp connected दिखा रहा है।

एक सवाल से जाँचें

Google के दस्तावेज़ का सैंपल प्रॉम्प्ट पूछें: "What customers do I have access to?" Claude को list_accessible_customers कॉल करना चाहिए और account IDs व नाम लौटाने चाहिए। अगर कुछ टूटता है, तो यह तालिका आम कारण बताती है:

ये सबसे संभावित कारण हैं, कोई आधिकारिक error सूची नहीं, इसलिए कुछ भी बदलने से पहले Claude द्वारा दिखाया गया असली संदेश पढ़ें।

पहले कौन से सवाल पूछने लायक हैं

पहले अपने अकाउंट खोजें। "What customers do I have access to?" आपको 10 अंकों के customer IDs देता है, जो डैश के बिना लिखे जाते हैं और जिनकी हर आगे की क्वेरी को ज़रूरत होती है। एक बार Claude को बताएँ कि आप किस ID पर काम कर रहे हैं, और वह उसे चैट के बाकी हिस्से में दोबारा इस्तेमाल करेगा। फिर उन सवालों पर जाएँ जो असली समय बचाते हैं। नीचे की क्वेरी दिखाती हैं कि Claude पर्दे के पीछे अक्सर क्या बनाता है, ताकि आप उसे जाँच सकें।

साप्ताहिक परफ़ॉर्मेंस निकालना

Google का दूसरा सैंपल प्रॉम्प्ट है "इस हफ़्ते मेरे कैंपेन की परफ़ॉर्मेंस कैसी रही?" इसके पीछे की एक उचित क्वेरी कुछ इस तरह दिखती है:

SELECT
  campaign.name,
  metrics.cost_micros,
  metrics.clicks,
  metrics.conversions
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
ORDER BY metrics.cost_micros DESC
LIMIT 10

प्रॉम्प्ट कॉपी करें

cost_micros पर ध्यान दें। Google Ads पैसे को micros में रखता है, इसलिए 12,500,000 का मतलब अकाउंट की मुद्रा में 12.50 है। जो मॉडल भाग देना भूल जाता है, वह खर्च को दस लाख गुना ज़्यादा बताएगा, इसलिए उसे बदलने और मुद्रा का नाम बताने को कहें।

बेकार खर्च खोजना

सबसे उपयोगी पहला प्रोजेक्ट search terms की समीक्षा है। यह क्वेरी ऐसे terms खोजती है जिन पर 30 दिनों में 5 मुद्रा-इकाई से ज़्यादा खर्च हुआ और कभी कन्वर्ज़न नहीं हुआ:

SELECT
  search_term_view.search_term,
  campaign.name,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
  AND metrics.cost_micros > 5000000
ORDER BY metrics.cost_micros DESC
LIMIT 25

प्रॉम्प्ट कॉपी करें

पंक्तियाँ Claude को वापस दें और उन्हें विषयों में समूहित करने को कहें: नौकरी खोजने वाले, मुफ़्त चाहने वाले, गलत प्रोडक्ट, गलत लोकेशन। ये विषय आपकी negative term सूची बनते हैं, जिसे आप Google Ads इंटरफ़ेस में खुद जोड़ते हैं, क्योंकि सर्वर लिख नहीं सकता।

कुछ और प्रॉम्प्ट जिन्हें नोट में रखना उपयोगी है:

💡 हर बार तारीख की रेंज और मुद्रा बताएँ। अस्पष्ट प्रॉम्प्ट से ही चुपचाप गलतियाँ शुरू होती हैं। "पिछले 30 दिन, यूरो में" बनाम "हाल में", पहला कहीं बेहतर है। फिर बाकी पर भरोसा करने से पहले Google Ads इंटरफ़ेस में एक आँकड़ा मिलाकर देखें।

सुरक्षा, डेटा और सीमाएँ

आपका डेटा मॉडल तक पहुँचता है

README चेतावनी देता है कि सर्वर "आपका डेटा उस Agent या LLM को दिखाएगा जिससे आप इसे जोड़ते हैं।" यह भी बताता है कि आपकी API कॉल्स में एक अतिरिक्त header जुड़ता है, जिसका इस्तेमाल Google उत्पाद सुधारने के लिए करता है। ऐसा एजेंसी अकाउंट जोड़ने से पहले, जिसमें क्लाइंट डेटा है, अपना कॉन्ट्रैक्ट और अपने क्लाइंट की नीति जाँचें। इस कनेक्शन को रिपोर्ट ईमेल करने जैसा मानें: क्वेरी जो भी लौटाती है, वह मॉडल तक जाता है।

एक सस्ता बचाव: ऐसे Google यूज़र से साइन इन करें जिसकी अकाउंट पर पहुँच केवल काम की ज़रूरत तक सीमित हो। सर्वर उसी यूज़र के credentials से काम करता है जिसने authenticate किया, इसलिए उस यूज़र की अनुमतियाँ सर्वर के अपने केवल-पढ़ने वाले डिज़ाइन के ऊपर लागू होती हैं।

Manager अकाउंट और होस्टिंग

अगर आप किसी customer अकाउंट तक manager (MCC) अकाउंट के ज़रिए पहुँचते हैं, तो env ब्लॉक में GOOGLE_ADS_LOGIN_CUSTOMER_ID को manager के customer ID पर सेट करें। Google इसे उस स्थिति के लिए आवश्यक बताता है।

ऊपर का लोकल सेटअप stdio इस्तेमाल करता है और एक व्यक्ति के लिए ठीक है। Google टीमों के लिए Cloud Run डिप्लॉयमेंट भी दस्तावेज़ित करता है। वहाँ सर्वर को GOOGLE_ADS_MCP_OAUTH_CLIENT_ID, GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET और FASTMCP_HOST=0.0.0.0 चाहिए, और क्लाइंट कॉन्फ़िग एक httpUrl को आपकी service के /mcp पाथ की ओर इशारा करती है।

आधिकारिक बनाम कम्युनिटी सर्वर

कम्युनिटी द्वारा बनाए गए कई Google Ads MCP सर्वर मौजूद हैं, और उनमें से कुछ लिखने की पहुँच दे सकते हैं। किसी भी सर्वर को लाइव अकाउंट से जोड़ने से पहले scopes और क्षमताएँ जाँचें।

नतीजों को विज्ञापन क्रिएटिव में बदलें

MCP सर्वर बताता है कि क्या ठीक करना है। वह तस्वीरें नहीं बनाता। जब Claude दिखा दे कि कौन से search themes कन्वर्ट होते हैं, तो उनके लिए आपको ताज़ा visuals और copy चाहिए, और यहीं PicassoIA काम आता है। यहाँ कुछ भी PicassoIA को आपके विज्ञापन अकाउंट से नहीं जोड़ता, इसलिए नतीजे आपको खुद आगे ले जाने होंगे।

मान लीजिए डेटा दिखाता है कि "waterproof hiking boots" "cheap boots" की लागत के एक अंश पर कन्वर्ट हो रहा है। जीतने वाले theme के लिए Claude से तीन विज़ुअल एंगल माँगें: कीचड़ भरे रास्ते का क्लोज़-अप, बारिश वाले दिन की लाइफ़स्टाइल शॉट, और दरवाज़े की सीढ़ी पर रखा बूट। फिर हर एक जनरेट करें। aspect ratio प्लेसमेंट से मिलाएँ: फ़ीड्स के लिए 1:1, वाइड बैनर के लिए 16:9, वर्टिकल वीडियो के लिए 9:16।

इस तरह के विज्ञापन कॉन्सेप्ट के लिए जो प्रॉम्प्ट अच्छा काम करता है, वह सब्जेक्ट, सेटिंग, रोशनी और लेंस बताता है, और साफ़ कहता है कि क्या टालना है:

सुबह के समय जंगल के गीले रास्ते पर कीचड़ से सने वॉटरप्रूफ हाइकिंग बूट का क्लोज़-अप, नरम साइड लाइट, उथली डेप्थ ऑफ़ फ़ील्ड, 50mm लेंस, फोटोरियलिस्टिक, कोई टेक्स्ट नहीं, कोई लोगो नहीं।

दो या तीन वर्ज़न जनरेट करें, वह रखें जो आपके डेटा के पसंदीदा एंगल से मेल खाए, और बाकी हटा दें। स्टाइल सहज रखें: हाइकिंग बूट के विज्ञापन के लिए किसी असली पल की विश्वसनीय फ़ोटो, चमकदार रेंडर से बेहतर बैठती है।

Claude Sonnet 5 कैसे इस्तेमाल करें

PicassoIA पर Claude Sonnet 5 इस वर्कफ़्लो में लिखने की मेज़ है। यह Google Ads MCP सर्वर नहीं चलाता। आप अपना MCP सेशन जो लौटाता है वह चिपकाते हैं, और यह विज्ञापन कॉपी का ड्राफ़्ट बनाता है। चरण:

1. PicassoIA पर Claude Sonnet 5 पेज खोलें।
2. System Prompt एक बार भरें: "आप Google responsive search ads लिखते हैं। हेडलाइन 30 अक्षरों से कम, विवरण 90 से कम। सादी भाषा, कोई हाइप नहीं, ऐसे दावे नहीं जो हम साबित न कर सकें।"
3. अपना डेटा Prompt में चिपकाएँ: सबसे अच्छे कन्वर्ट होने वाले search terms, आपकी मौजूदा हेडलाइन और ऑफ़र।
4. Effort लेवल चुनें। डिफ़ॉल्ट, low, थिंकिंग बंद रखता है और सबसे तेज़ जवाब देता है, जो कॉपी वेरिएंट के लिए ठीक है। किसी उलझे अकाउंट की रीस्ट्रक्चरिंग योजना चाहिए तो high या max इस्तेमाल करें।
5. छोटा आउटपुट न चाहें तो Max Tokens 8,192 पर रखें।
6. वैकल्पिक रूप से Image जोड़ें, जैसे परफ़ॉर्मेंस चार्ट का स्क्रीनशॉट। मॉडल इसे संदर्भ के रूप में पढ़ता है।
7. ड्राफ़्ट की समीक्षा करें, उसे संपादित करें, और कॉपी खुद Google Ads में चिपकाएँ।

Responsive search ads में अधिकतम 15 हेडलाइन और 4 विवरण स्वीकार होते हैं, इसलिए एक रन में पूरा विज्ञापन भर जाता है। दूसरी राय चाहिए? वही प्रॉम्प्ट Gemini 3.5 Flash या Claude Opus 4.7 पर चलाएँ और ड्राफ़्ट साथ-साथ तुलना करें।

आज ही अपने विज्ञापन विज़ुअल बनाएँ

डेटा बताता है कि क्या टेस्ट करना है। विज़ुअल तय करते हैं कि कोई स्क्रॉल करते हुए रुकता है या नहीं। PicassoIA Image खोलें, अपने सबसे अच्छे कन्वर्ट होने वाले theme का प्रॉम्प्ट चिपकाएँ, 1:1 या 16:9 चुनें, और जितनी चाहें उतनी विविधताएँ जनरेट करें, क्योंकि मॉडल की प्रति-इमेज कोई सीमा नहीं है। जब एक कंपोज़िशन काम कर जाए तो seed लॉक करें, और छोटे अंतर टेस्ट करने के लिए केवल शब्द बदलें।

PicassoIA का अपना MCP कनेक्शन भी है, इसलिए वही Claude जो आपका Google Ads डेटा पढ़ता है, एक ही बातचीत में इमेज और वीडियो भी माँग सकता है। विवरण के लिए PicassoIA API पेज देखें और जाँचें कि कौन सा प्लान पहुँच देता है।

आज रात यह आज़माएँ: Google Ads MCP सर्वर जोड़ें, बेकार खर्च वाली क्वेरी चलाएँ, सबसे अच्छा कन्वर्ट होने वाला एक theme चुनें, और कुछ और लिखने से पहले Picasso IA पर पाँच विज़ुअल विविधताएँ जनरेट करें। अगले हफ़्ते साप्ताहिक परफ़ॉर्मेंस क्वेरी फिर चलाएँ और देखें कि किस वर्ज़न ने क्लिक कमाए।