MCP Reference: paydeveloper.googleapis.com

यह एक एमसीपी सर्वर है, जो डेवलपर को पेमेंट करने के लिए टूल उपलब्ध कराता है.

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

सर्वर का सेटअप

इसका इस्तेमाल करने से पहले, आपको एमसीपी सर्वर चालू करने और पुष्टि करने की सुविधा सेट अप करने की ज़रूरत होगी. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.

सर्वर एंडपॉइंट

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

Google Pay और Wallet Developer MCP server API के एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:

  • 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 इस तरीके से, पुष्टि किए गए खाते से नया कारोबारी या कंपनी खाता बनाया जाता है. आपको उपयोगकर्ता से कारोबारी या कंपनी का खाता बनाने के लिए ज़रूरी जानकारी मांगनी होगी. ज़रूरी फ़ील्ड में से एक, कारोबारी या कंपनी का कैटगरी कोड (एमसीसी) है. एमसीसी की सूची लंबी होती है. इसलिए, सामान्य विकल्पों का सबसेट दिखाया जा सकता है. हालांकि, आपको उपयोगकर्ता को यह बताना होगा कि ज़्यादा विकल्प उपलब्ध हैं और वह पूरी सूची मांग सकता है. उदाहरण के लिए, "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 इस कुकी का इस्तेमाल, किसी मुख्य व्यक्ति (उपयोगकर्ता) के पास मौजूद, किसी कारोबारी या कंपनी के ऐक्सेस को मिटाने के लिए किया जाता है. इस कार्रवाई के लिए, कारोबारी या कंपनी के पास एडमिन ऐक्सेस होना ज़रूरी है.

MCP टूल की खास जानकारी पाना

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास बातें पाने के लिए, tools/list तरीके का इस्तेमाल करें. यहां दिए गए उदाहरण में, यह दिखाया गया है कि MCP सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास बातों की सूची बनाने के लिए, 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
}'