एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं देने वाली किसी बाहरी सेवा और एलएलएम या एआई ऐप्लिकेशन के बीच प्रॉक्सी के तौर पर काम करता है. एमसीपी सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में ट्रांसलेट करते हैं जिसे एआई ऐप्लिकेशन समझ सके.
सर्वर का सेटअप
एमसीपी सर्वर का इस्तेमाल करने से पहले, आपको उन्हें चालू करना होगा और पुष्टि की सुविधा सेट अप करनी होगी. Google और Google Cloud के रिमोट एमसीपी सर्वर का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.
सर्वर के एंडपॉइंट
एमसीपी सेवा का एंडपॉइंट, एमसीपी सर्वर का नेटवर्क पता और कम्यूनिकेशन इंटरफ़ेस (आम तौर पर, एक यूआरएल) होता है. इसका इस्तेमाल, एआई ऐप्लिकेशन (एमसीपी क्लाइंट के लिए होस्ट) सुरक्षित और स्टैंडर्ड कनेक्शन बनाने के लिए करता है. एलएलएम के लिए, यह संपर्क करने का पॉइंट होता है. इसकी मदद से, एलएलएम कॉन्टेक्स्ट का अनुरोध कर सकता है, किसी टूल को कॉल कर सकता है या किसी संसाधन को ऐक्सेस कर सकता है. Google के एमसीपी एंडपॉइंट, ग्लोबल या रीजनल हो सकते हैं.
Google Pay और Wallet के डेवलपर एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:
- https://paydeveloper.googleapis.com/mcp
एमसीपी टूल
एक एमसीपी टूल, एक फ़ंक्शन या एक्ज़ीक्यूटेबल सुविधा होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन को उपलब्ध कराता है, ताकि वे असल दुनिया में कोई कार्रवाई कर सकें.
टूल
paydeveloper.googleapis.com एमसीपी सर्वर में ये टूल शामिल हैं:
| एमसीपी टूल | |
|---|---|
search_documentation |
Google Pay और Google Wallet के डेवलपर के लिए बने आधिकारिक दस्तावेज़ और कोड के सैंपल में से, सबसे काम के और अप-टू-डेट सेक्शन खोजता है और उन्हें वापस लाता है. |
list_merchants |
पुष्टि किए गए खाते से जुड़ी, Google Pay के सभी व्यापारियों या कंपनियों की Business Profile की सूची वापस लाता है. |
list_google_pay_integrations |
किसी खास Merchant ID से जुड़े, Google Pay के सभी इंटिग्रेशन की मौजूदा स्थिति और कॉन्फ़िगरेशन की जानकारी देता है. यह इंटिग्रेशन की स्थिति और दस्तावेज़ों की समीक्षा के बारे में तुरंत सुझाव या राय देता है. |
create_merchant |
पुष्टि किए गए खाते से, नया व्यापारी या कंपनी बनाता है. आपको उपयोगकर्ता से, व्यापारी या कंपनी बनाने के लिए ज़रूरी जानकारी मांगनी होगी. जब तक आपने व्यापारी या कंपनी बनाने के लिए ज़रूरी जानकारी इकट्ठा करने की कोशिश न की हो, तब तक इस टूल को कॉल न करें. व्यापारी या कंपनी बन जाने के बाद, आपको उपयोगकर्ता को Business Console की सेवा की शर्तों का यूआरएल दिखाना होगा. साथ ही, उसे निर्देश देना होगा कि वह इस व्यापारी या कंपनी पर कोई भी कार्रवाई करने से पहले, इन शर्तों को स्वीकार करे. |
create_google_pay_integration |
किसी खास व्यापारी या कंपनी के लिए, Google Pay का इंटिग्रेशन बनाता है. इस कार्रवाई के लिए, उपयोगकर्ता को Business Console की सेवा की शर्तें और Google Pay API की सेवा की शर्तें स्वीकार करनी होंगी. आपको पहले से इनकी जांच करने की ज़रूरत नहीं है. अगर इन्हें स्वीकार नहीं किया गया है, तो टूल कॉल नहीं हो पाएगा. साथ ही, गड़बड़ी के मैसेज में, सेवा की उन शर्तों के यूआरएल शामिल होंगे जिन्हें स्वीकार करना ज़रूरी है. ऐसा होने पर, उपयोगकर्ता को स्वीकार करने के लिए यूआरएल दिखाएं. साथ ही, उसे निर्देश दें कि शर्तों को स्वीकार करने के बाद, वह फिर से कोशिश करे. टूल को कॉल करने से पहले, उपयोगकर्ता के साथ इंटरैक्ट करने के लिए इस क्रम का पालन करें: 1. सबसे पहले, उपयोगकर्ता से इंटिग्रेशन आइटम के बारे में पूछें. फ़िलहाल, सिर्फ़ वेब इंटिग्रेशन की सुविधा उपलब्ध है. - वेबसाइट का यूआरएल मांगें. # - अगर इंटिग्रेशन आइटम, ऐप्लिकेशन इंटिग्रेशन है, तो Android ऐप्लिकेशन के पैकेज का नाम मांगें. 2. इसके बाद, उपयोगकर्ता से इंटिग्रेशन के टाइप के बारे में पूछें: - उपयोगकर्ता को बताएं कि अगर वह हमारी भुगतान सेवा देने वाली कंपनियों (PSPs: https://developers.google.com/pay/api#participating-processors) में से किसी एक का इस्तेमाल करता है, तो वह 'गेटवे' चुने. इसके अलावा, 'डायरेक्ट' चुने. 3. इंटिग्रेशन के सभी टाइप (डायरेक्ट या गेटवे) के लिए: - उपयोगकर्ता को बताएं कि वह Google Pay API के साथ इंटिग्रेट किए गए बायफ़्लो के स्क्रीनशॉट (ज़्यादा से ज़्यादा 1 एमबी) अपलोड करे. प्रोडक्शन टेस्टिंग ट्रैक का ऐक्सेस देने से पहले, उनके बायफ़्लो की समीक्षा करके मंज़ूरी दी जानी चाहिए. उदाहरण: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - आपको उपयोगकर्ता से, पुष्टि करने वाले पांच स्क्रीनशॉट मांगने होंगे. सही मैपिंग पक्का करने के लिए, एक-एक करके स्क्रीनशॉट मांगें. स्क्रीनशॉट मांगते समय, सिर्फ़ उपयोगकर्ता के लिए आसान enum के ब्यौरे का इस्तेमाल करें. 4. अगर इंटिग्रेशन का टाइप 'डायरेक्ट' है, तो: - आपको उपयोगकर्ता से, पीसीआई एटेस्टेशन का दस्तावेज़ भी पीडीएफ़ फ़ॉर्मैट में मांगना होगा. स्क्रीनशॉट मांगते समय, सिर्फ़ उपयोगकर्ता के लिए आसान enum के ब्यौरे का इस्तेमाल करें. 5. उपयोगकर्ता से, हर फ़ाइल के लिए दस्तावेज़ का पाथ या नाम बताने के लिए कहें. हालांकि, ऐसा तब ही करें, जब फ़ाइल मौजूदा डायरेक्ट्री में हो. इसे सही DocumentType पर मैप करें और अनुरोध में, नाम वाले फ़ील्ड को जानकारी देने वाले नाम पर सेट करें. जैसे, item_selection.png या pci_attestation.pdf. जब तक आपने चुने गए इंटिग्रेशन टाइप के लिए ज़रूरी दस्तावेज़ इकट्ठा करने की कोशिश न की हो, तब तक इस टूल को कॉल न करें. |
list_pass_issuers |
पुष्टि किए गए उपयोगकर्ता से जुड़े, Google Wallet के Business Console में रजिस्टर किए गए सभी पास जारी करने वालों की पूरी सूची वापस लाता है. यह टूल, Wallet के पास मैनेज करने वाले डेवलपर के लिए ज़रूरी जानकारी देता है. जैसे, लॉयल्टी कार्ड, गिफ्ट कार्ड या फ़्लाइट. |
list_pass_classes |
पुष्टि किए गए उपयोगकर्ता से जुड़े, Google Wallet के Business Console में रजिस्टर किए गए सभी पास क्लास की पूरी सूची वापस लाता है. यह टूल, Wallet के पास मैनेज करने वाले डेवलपर के लिए ज़रूरी जानकारी देता है. जैसे, लॉयल्टी कार्ड, गिफ्ट कार्ड या फ़्लाइट. |
validate_pass_jwt |
किसी पास के JWT के फ़ॉर्मैट या पास के लिए, JSON स्ट्रिंग के तौर पर अनकोड किए गए JWT पेलोड की पुष्टि करता है. |
query_merchant_performance |
किसी खास व्यापारी या कंपनी की Business Profile के लिए, एग्रीगेट किया गया हाई-लेवल परफ़ॉर्मेंस डेटा और इंटिग्रेशन के बाद के मेट्रिक वापस लाता है. |
query_merchant_error_metrics |
किसी खास व्यापारी या कंपनी की Business Profile के लिए, गड़बड़ी के बारे में पूरी जानकारी देने वाले मेट्रिक वापस लाता है. यह टूल, गड़बड़ियों को अलग-अलग हिस्सों में बांटकर दिखाता है. इससे डेवलपर, समस्याओं की सटीक जानकारी पा सकते हैं और उन्हें हल कर सकते हैं. |
एमसीपी टूल की खास जानकारी पाना
किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, tools/list तरीके का इस्तेमाल करें. यहां दिए गए उदाहरण में, curl का इस्तेमाल करके, एमसीपी सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास जानकारी की सूची बनाने का तरीका बताया गया है.
| Curl का अनुरोध |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |