गूगल बिज़नेस प्रोफ़ाइल एमसीपी सर्वर कैसे बनाया गया

सर्वर क्या उपलब्ध कराता है

सर्वर एमसीपी स्पेसिफ़िकेशन का streamable HTTP ट्रांसपोर्ट इस्तेमाल करता है (ट्रांसपोर्ट), इसलिए अपने कंप्यूटर पर कुछ इंस्टॉल करने या चलाने की ज़रूरत नहीं है। इसके टूल तीन श्रेणियों में आते हैं, और हर टूल पर स्पेसिफ़िकेशन के एनोटेशन लगे हैं, ताकि क्लाइंट को कॉल करने से पहले पता हो कि टूल सिर्फ़ पढ़ता है, रीच का अपना डेटा बदलता है या गूगल की सार्वजनिक लिस्टिंग बदलता है (टूल एनोटेशन)।

सर्वर एमसीपी प्रॉम्प्ट भी देता है, जो स्पेसिफ़िकेशन के दोबारा इस्तेमाल होने वाले शुरुआती निर्देश हैं (प्रॉम्प्ट): एक प्रोफ़ाइल को एक-एक पुष्टि किए गए बदलाव से बेहतर बनाता है, एक सर्च विज़िबिलिटी की समीक्षा करता है, और एक बिना जवाब के रिव्यू पर काम करता है। क्लाइंट इन्हें तैयार अनुरोधों के रूप में दिखाता है।

हर टूल उन्हीं सर्वर प्रक्रियाओं को कॉल करता है जिन्हें रीच डैशबोर्ड कॉल करता है, एक इन-प्रोसेस कॉलर के ज़रिए। इसलिए लोकेशन एक्सेस की जाँच, प्लान की सीमाएँ और गूगल कनेक्शन की जाँच ठीक वैसे ही चलती हैं जैसे साइन-इन किए मालिक के लिए; एमसीपी परत के पास इन्हें बायपास करने का कोई रास्ता नहीं है।

एक उदाहरण सेशन, हर कॉल के साथ

कोई बदलाव गूगल तक कैसे पहुँचता है

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

प्रोफ़ाइल बदलने में दो कॉल लगती हैं। पहली, preview: true के साथ (डिफ़ॉल्ट), हर बदले फ़ील्ड का पहले और बाद का मान लौटाती है, कोई फ़ील्ड जो अस्वीकार होगा उसके साथ ज़रूरी सुधार, और पढ़ी गई प्रोफ़ाइल का basedOn फ़िंगरप्रिंट। दूसरी कॉल तभी लिखती है जब उसमें वही फ़िंगरप्रिंट हो और तब से प्रोफ़ाइल न बदली हो। अगर इस बीच किसी ने लिस्टिंग बदली, डैशबोर्ड में या गूगल सिंक के ज़रिए, तो बदलाव अस्वीकार हो जाता है और असिस्टेंट को फिर से प्रीव्यू लेना पड़ता है।

गूगल का अपना API अपडेट मास्क के तहत भेजे गए फ़ील्ड लागू कर देता है (locations.patch)। उसे पता नहीं हो सकता कि किसी इंसान ने बदलाव देखा या नहीं। प्रीव्यू और फ़िंगरप्रिंट यह जाँच उससे पहले रखते हैं, इसलिए मॉडल कोई पुराना या बिना देखा बदलाव लागू नहीं कर सकता, दोबारा कोशिश करने पर भी नहीं।

पोस्ट और रिव्यू के जवाब में प्रीव्यू का चरण नहीं है, क्योंकि मालिक जो टेक्स्ट मंज़ूर करता है वही बदलाव है। उनके विवरण असिस्टेंट से कहते हैं कि पहले सटीक पोस्ट या जवाब दिखाए। पोस्ट किया गया जवाब पिछले जवाब की जगह ले लेता है और कोई टूल उसे हटा नहीं सकता (reviews.updateReply), और विवरण यह साफ़ बताता है, ताकि मॉडल मालिक की सहमति से पहले उसे बता सके।

रीच ने रीच के अंदर प्रस्ताव-और-मंज़ूरी वाली कतार की जगह बातचीत में पुष्टि को चुना। मालिक पहले से चैट में है, दूसरा इनबॉक्स एक ऐसा कदम जोड़ता है जिसे नज़रअंदाज़ करना आसान है, और एमसीपी स्पेसिफ़िकेशन पहले से ही एक ऐसे इंसान की अपेक्षा करता है जो टूल कॉल को मना कर सके (सुरक्षा संबंधी बातें)।

सुरक्षा उपाय जो मॉडल पर निर्भर नहीं हैं

स्पेसिफ़िकेशन कहता है कि क्लाइंट टूल एनोटेशन को तब तक अविश्वसनीय मानें जब तक वे किसी भरोसेमंद सर्वर से न आएँ (टूल एनोटेशन), और मॉडल किसी विवरण को अनदेखा कर सकता है। इसलिए सर्वर अपने नियम ख़ुद लागू करता है:

• गूगल पर बदलावों का बजट। हर बिज़नेस असिस्टेंट के ज़रिए एक घंटे में ज़्यादा से ज़्यादा 20 गूगल बदलाव कर सकता है। लूप में फँसा मॉडल इस सीमा तक पहुँचता है और उसे बताया जाता है कि कितना इंतज़ार करना है, बजाय इसके कि वह प्रोफ़ाइल को बार-बार बदलता रहे।
• दोबारा कोशिश की सुरक्षा। हर बदलाव एक idempotency key लेता है। उसी key के साथ दोहराई गई कॉल दोबारा लिखने की जगह पहला नतीजा लौटाती है; key के बिना, थोड़े समय के भीतर वही कॉल उसी बदलाव के रूप में गिनी जाती है।
• हर कॉल पर लोकेशन की जाँच। मॉडल जो लोकेशन आईडी भेजता है, उसे हर बार मालिक के मौजूदा गूगल एक्सेस से जाँचा जाता है, उसी जाँच से जो डैशबोर्ड इस्तेमाल करता है। सर्वर कोई सेशन नहीं रखता जिसे मॉडल दोबारा इस्तेमाल कर सके।
• छिपे हुए फ़ोन नंबर। लीड और बुकिंग अनुरोधों में फ़ोन नंबर आख़िरी चार अंकों को छोड़कर छिपे होते हैं, नोट्स के अंदर भी। ईमेल वैसे ही आते हैं, क्योंकि मालिक को लीड का जवाब देने के लिए उनकी ज़रूरत होती है।
• सर्वर द्वारा लागू किया गया एक्सेस रद्द करना। मालिक रीच की एआई कनेक्टर स्क्रीन से किसी असिस्टेंट को डिस्कनेक्ट कर सकता है, और उसके बाद सर्वर उस क्लाइंट का टोकन अस्वीकार करता है।

मॉडल को बताना कि वह क्या नहीं देख सकता

जिस असिस्टेंट को ख़ाली सूची मिलती है, वह मालिक से कहता है “आपके कोई रिव्यू नहीं हैं”। अक्सर सच यह होता है कि डेटा है पर छिपा है: लोकेशन उसकी सार्वजनिक लिस्टिंग से जोड़ी गई और उसका गूगल कनेक्शन नहीं है, प्लान में वह फ़ीचर नहीं है, या गूगल ने पहला सिंक पूरा नहीं किया। इसलिए पढ़ने वाले नतीजों में limitations सूची होती है जो कारण और उसे ठीक करने वाला लिंक बताती है। ख़ाली सूची का मतलब है कि कुछ नहीं छिपाया गया।

खाते का नतीजा फ़ीचर के लिए भी यही करता है। हर फ़ीचर उपलब्ध या अभी नहीं बना के रूप में चिह्नित होता है, ताकि मॉडल कॉल या विज्ञापन को ऐसी चीज़ न बताए जो रीच आज कर सकता है। जब मालिक कुछ ऐसा चाहता है जो रीच में नहीं है, तो असिस्टेंट मालिक के शब्दों में अनुरोध रीच टीम को भेज सकता है, पहले उन्हें शब्द दिखाकर।

हर जवाब टूल का स्कीमा वर्शन भी लौटाता है। क्लाइंट टूल स्कीमा कैश करते हैं और स्कीमा बदलने पर चुपचाप विफल हो सकते हैं, इसलिए कोई बड़ा बदलाव सिर्फ़ क्लाइंट की त्रुटि दर में नहीं, बल्कि जवाब में और रीच के लॉग में दिखता है।

साइन-इन: OAuth 2.1, कोई API key नहीं

सर्वर एक OAuth 2.1 संरक्षित संसाधन है, जैसा एमसीपी ऑथराइज़ेशन स्पेसिफ़िकेशन बताता है (ऑथराइज़ेशन)। यह संरक्षित संसाधन का मेटाडेटा प्रकाशित करता है (RFC 9728), ताकि क्लाइंट ख़ुद ऑथराइज़ेशन सर्वर ढूँढे, ख़ुद को रजिस्टर करे और ब्राउज़र में साइन-इन खोले। मालिक अपने रीच खाते से साइन इन करता है; कोई key पेस्ट नहीं करनी होती।

सर्वर जाँचता है कि हर टोकन इसी संसाधन के लिए जारी हुआ है, उसी ऑथराइज़ेशन सर्वर की किसी दूसरी सेवा के लिए नहीं; यही confused-deputy से बचाव है जिसके लिए resource indicators बने हैं (RFC 8707)। गूगल कनेक्शन कभी असिस्टेंट तक नहीं पहुँचता: उसे रीच रखता है, और असिस्टेंट के पास सिर्फ़ रीच का टोकन होता है।

इसीलिए मालिक को गूगल API एक्सेस की ज़रूरत नहीं होती। गूगल बिज़नेस प्रोफ़ाइल API हर प्रोजेक्ट को एक्सेस अनुरोध के बाद देता है (पूर्व-आवश्यकताएँ), जो ज़्यादातर छोटे बिज़नेस कभी नहीं भरते।

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

• यह प्राइमरी कैटेगरी या पता नहीं बदल सकता। ये मालिक के पास गूगल के अपने टूल में रहते हैं।
• यह कोई पोस्ट डिलीट नहीं कर सकता और रिव्यू का जवाब हटा नहीं सकता। पोस्ट किया गया जवाब बदला जा सकता है, हटाया नहीं जा सकता।
• जुड़ी हुई गूगल बिज़नेस प्रोफ़ाइल के बिना यह सिर्फ़ सार्वजनिक लिस्टिंग पढ़ सकता है। सार्वजनिक लिस्टिंग से जोड़ी गई लोकेशन को वही स्नैपशॉट और जोड़ने का लिंक मिलता है।
• यह असिस्टेंट के ज़रिए हर बिज़नेस के लिए एक घंटे में 20 से ज़्यादा गूगल बदलाव नहीं कर सकता।
• सर्च रैंक सिर्फ़ ट्रैक किए गए कीवर्ड के लिए है। नए कीवर्ड की रैंक तब तक नहीं होती जब तक उसकी पहली जाँच न चल जाए।

इसे क्लॉड, चैटजीपीटी या Cursor में जोड़ें

सर्वर URL

रीच गूगल बिज़नेस प्रोफ़ाइल एमसीपी सर्वर के बारे में

हर क्लाइंट रिमोट सर्वर अलग तरह से जोड़ता है, इसलिए कदम हर क्लाइंट के अपने पेज पर हैं: क्लॉड, चैटजीपीटी, क्लॉड Code, Cursor और VS Code। कंपनियाँ भी यही बातें लिखती हैं: Anthropic कस्टम कनेक्टर पर, OpenAI चैटजीपीटी से जोड़ने पर और Cursor एमसीपी सर्वर पर।

अक्सर पूछे जाने वाले सवाल

क्या इस एमसीपी सर्वर के लिए मुझे गूगल बिज़नेस प्रोफ़ाइल API एक्सेस चाहिए?

नहीं। गूगल कनेक्शन रीच रखता है, और असिस्टेंट OAuth से रीच में साइन इन करता है। गूगल के API के लिए मंज़ूर किया गया गूगल क्लाउड प्रोजेक्ट चाहिए (पूर्व-आवश्यकताएँ), जिससे यह तरीका बचाता है।

कौन-से एआई असिस्टेंट इसके साथ काम करते हैं?

कोई भी क्लाइंट जो OAuth साइन-इन वाले रिमोट एमसीपी सर्वर सपोर्ट करता है, जिनमें क्लॉड, चैटजीपीटी, क्लॉड Code, Cursor, VS Code, Codex, Windsurf और Cline शामिल हैं।

क्या असिस्टेंट बिना पूछे मेरी लिस्टिंग बदल सकता है?

गूगल पर बदलाव क्लाइंट के मंज़ूरी प्रॉम्प्ट और बातचीत में स्पष्ट हाँ से होकर जाते हैं, और प्रोफ़ाइल बदलने के लिए ताज़ा प्रीव्यू चाहिए। सर्वर बातचीत नहीं देख सकता, इसलिए जो उपाय वह ख़ुद लागू करता है वे हैं पुराने प्रीव्यू का इनकार, गूगल बदलावों की घंटे की सीमा और दोबारा कोशिश की सुरक्षा।

क्या इसका कोई ख़र्च है?

पढ़ना मुफ़्त है। रिव्यू का जवाब ड्राफ़्ट करने में रीच क्रेडिट लगते हैं, और कुछ फ़ीचर प्लान पर निर्भर हैं। फ़्री प्लान एक लोकेशन के लिए है।

अगर गूगल कनेक्शन टूट जाए तो क्या होता है?

खाते का नतीजा हर लोकेशन के कनेक्शन की स्थिति दिखाता है। अगर वह सक्रिय नहीं है, तो असिस्टेंट मालिक से रीच में गूगल दोबारा जोड़ने को कहता है और उस लोकेशन पर काम रोक देता है।

अपनी प्रोफ़ाइल से एक असिस्टेंट जोड़ें

सिर्फ़ पढ़ने वाले सवाल से शुरू करें, जैसे किन रिव्यू का जवाब नहीं गया, फिर एक छोटा बदलाव मंज़ूर करें और उसे दोबारा पढ़कर देखें। सेटअप पेज हर क्लाइंट के कदम बताता है।

गूगल बिज़नेस प्रोफ़ाइल एमसीपी सर्वर सेट अप करें

रीच में एआई कनेक्टर खोलें