यह एक एमसीपी सर्वर है, जो Pay के डेवलपर को टूल उपलब्ध कराता है.
एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं उपलब्ध कराने वाली किसी बाहरी सेवा और एलएलएम या एआई ऐप्लिकेशन के बीच प्रॉक्सी के तौर पर काम करता है. एमसीपी सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में ट्रांसलेट करते हैं जिसे एआई ऐप्लिकेशन समझ सके.
सर्वर का सेटअप
एमसीपी सर्वर का इस्तेमाल करने से पहले, आपको उन्हें चालू करना होगा और पुष्टि करने की सुविधा सेट अप करनी होगी. Google और Google Cloud के रिमोट एमसीपी सर्वर के इस्तेमाल के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.
सर्वर के एंडपॉइंट
एमसीपी सेवा का एंडपॉइंट, एमसीपी सर्वर का नेटवर्क पता और कम्यूनिकेशन इंटरफ़ेस (आम तौर पर, एक यूआरएल) होता है. इसका इस्तेमाल, एआई ऐप्लिकेशन (एमसीपी क्लाइंट का होस्ट) सुरक्षित और स्टैंडर्ड कनेक्शन बनाने के लिए करता है. एलएलएम, कॉन्टेक्स्ट का अनुरोध करने, किसी टूल को कॉल करने या किसी संसाधन को ऐक्सेस करने के लिए, इस एंडपॉइंट का इस्तेमाल करता है. Google के एमसीपी एंडपॉइंट, ग्लोबल या स्थानीय हो सकते हैं.
Google Pay और Wallet Console के डेवलपर एमसीपी सर्वर एपीआई एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:
- https://paydeveloper.googleapis.com/mcp
एमसीपी टूल
एक एमसीपी टूल, एक फ़ंक्शन या एक्ज़ीक्यूटेबल सुविधा होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन को उपलब्ध कराता है, ताकि वे असल दुनिया में कोई कार्रवाई कर सकें.
टूल
paydeveloper.googleapis.com एमसीपी सर्वर में ये टूल शामिल हैं:
| एमसीपी टूल | |
|---|---|
search_documentation |
Google Pay और Google Wallet के डेवलपर के लिए आधिकारिक दस्तावेज़ और कोड के सैंपल में से, सबसे काम के और अप-टू-डेट सेक्शन खोजता है और उन्हें वापस लाता है. |
list_merchants |
पुष्टि किए गए खाते से जुड़े सभी Google Pay व्यापारियों की पूरी सूची वापस लाता है. किसी व्यापारी के लिए उपयोगकर्ता की भूमिका के आधार पर, एडमिन व्यापारी की पूरी जानकारी देख सकते हैं. वहीं, डेवलपर सिर्फ़ व्यापारी की बुनियादी जानकारी देख सकते हैं. |
list_google_pay_integrations |
किसी खास Merchant ID से जुड़े सभी Google Pay इंटिग्रेशन के लिए, मौजूदा स्थिति और कॉन्फ़िगरेशन की जानकारी दिखाता है. यह इंटिग्रेशन की स्थिति और दस्तावेज़ की समीक्षाओं के बारे में तुरंत सुझाव/राय देता है. इसके अलावा, आपको उपयोगकर्ता को यह बताना होगा कि Google Pay और Wallet Console (https://pay.google.com/business/console/) में इंटिग्रेशन बनाया/अपडेट किया जा सकता है. |
create_merchant |
पुष्टि किए गए खाते से एक नया व्यापारी बनाता है. आपको उपयोगकर्ता से, व्यापारी बनाने के लिए ज़रूरी जानकारी देने के लिए कहना होगा. ज़रूरी फ़ील्ड में से एक, Merchant Category Code (एमसीसी) है. एमसीसी की सूची लंबी होती है. इसलिए, हो सकता है कि आपको सामान्य विकल्पों का सबसेट दिखाना पड़े. हालांकि, आपको उपयोगकर्ता को यह बताना होगा कि ज़्यादा विकल्प उपलब्ध हैं और वे पूरी सूची के लिए अनुरोध कर सकते हैं. उदाहरण के लिए, "X और विकल्प" या इसी तरह का कोई हिंट दिखाकर. इसके अलावा, उपयोगकर्ता को बताएं कि अगर उन्हें पहले से चार अंकों वाला एमसीसी कोड (जैसे, 5499) पता है, तो वे सीधे इसे उपलब्ध करा सकते हैं. साथ ही, उन्हें इसका इस्तेमाल करने के लिए बढ़ावा दें. जब तक आपने व्यापारी बनाने के लिए ज़रूरी जानकारी इकट्ठा करने की कोशिश न की हो, तब तक इस टूल को कॉल न करें. व्यापारी बनाने के बाद, आपको उपयोगकर्ता को Business Console की सेवा की शर्तों का यूआरएल दिखाना होगा. साथ ही, उन्हें यह निर्देश देना होगा कि वे इस व्यापारी पर कोई भी कार्रवाई करने से पहले, इसे स्वीकार करें. |
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 के लिए, गड़बड़ी के बारे में पूरी जानकारी देने वाले मेट्रिक वापस लाता है. यह टूल, गड़बड़ियों की पूरी जानकारी देता है. इससे डेवलपर, समस्याओं का पता लगा सकते हैं और उन्हें ठीक कर सकते हैं. |
update_merchant |
पहले से मौजूद किसी व्यापारी के खास फ़ील्ड अपडेट करता है. display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email, और customer_support_phone जैसे फ़ील्ड अपडेट किए जा सकते हैं. |
list_principals |
उन प्रिंसिपल (उपयोगकर्ताओं) की सूची दिखाता है जिनके पास किसी खास व्यापारी का ऐक्सेस है. इस कार्रवाई के लिए, व्यापारी के लिए एडमिन का ऐक्सेस होना ज़रूरी है. |
set_principal_role |
किसी व्यापारी के लिए, प्रिंसिपल (उपयोगकर्ता) की भूमिका सेट करता है या तय की गई भूमिका के साथ नया प्रिंसिपल जोड़ता है. प्रिंसिपल को ईमेल से न्योता भेजा जाता है. ऐक्सेस चालू होने से पहले, उसे यह न्योता स्वीकार करना होगा. इस कार्रवाई के लिए, व्यापारी के लिए एडमिन का ऐक्सेस होना ज़रूरी है. |
delete_principal |
किसी खास व्यापारी के लिए, प्रिंसिपल (उपयोगकर्ता) का ऐक्सेस मिटाता है. इस कार्रवाई के लिए, व्यापारी के लिए एडमिन का ऐक्सेस होना ज़रूरी है. |
एमसीपी टूल की खास जानकारी पाना
किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, 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 }' |