MCP Reference: chatmcp.googleapis.com

Chat MCP API, Google Chat की सुविधाओं के लिए रिमोट MCP उपलब्ध कराता है.

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

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

Chat का इस्तेमाल करने से पहले, आपको Chat के एमसीपी सर्वर को कॉन्फ़िगर करना होगा. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.

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

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

Chat API के एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:

  • https://chatmcp.googleapis.com/mcp/v1

एमसीपी टूल

एमसीपी टूल एक फ़ंक्शन या एक्ज़ीक्यूटेबल क्षमता होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन के लिए उपलब्ध कराता है, ताकि वह असल दुनिया में कोई कार्रवाई कर सके.

टूल

chatmcp.googleapis.com एमसीपी सर्वर में ये टूल मौजूद हैं:

एमसीपी टूल
list_messages यह फ़ंक्शन, Google Chat की किसी बातचीत (स्पेस, डायरेक्ट मैसेज (डीएम) या ग्रुप डीएम) से मैसेज वापस लाता है. इसकी मदद से, थ्रेड, समयसीमा, और मैसेज की संख्या के हिसाब से फ़िल्टर किया जा सकता है. इसके अलावा, ज़्यादा जानकारी पाने के लिए मैसेज का अगला पेज भी वापस पाया जा सकता है. निजी मैसेज (ऐसे मैसेज जो सिर्फ़ एक उपयोगकर्ता को दिखते हैं) को फ़िल्टर कर दिया जाता है.
search_conversations

यह डिसप्ले नेम के हिसाब से, Google Chat पर हुई बातचीत खोजता है.

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

अगर सिर्फ़ कोई क्वेरी दी जाती है, तो यह टूल उन बातचीत को खोजता है जिनमें क्वेरी, बातचीत के डिसप्ले नेम का केस-इनसेंसिटिव सबस्ट्रिंग होती है.

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

अगर न तो हिस्सा लेने वाले लोगों की जानकारी दी जाती है और न ही क्वेरी, तो यह टूल उन सभी बातचीत की सूची दिखाता है जिनमें कॉल करने वाला व्यक्ति सदस्य है.

इस टूल में सिर्फ़ वे बातचीत दिखती हैं जिनमें कॉल करने वाला उपयोगकर्ता शामिल है.

अहम जानकारी: 'बातचीत' की खाली सूची का मतलब यह नहीं है कि अब कोई और नतीजा नहीं है. अगर 'next_page_token' मौजूद है, तो ज़्यादा पेज फ़ेच किए जा सकते हैं. अगर आपको खाली सूची मिलती है, लेकिन 'next_page_token' मिलता है, तो उपयोगकर्ता से पूछें कि क्या आपको खोज जारी रखनी चाहिए.

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

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, tools/list तरीके का इस्तेमाल करें. इस उदाहरण में, curl का इस्तेमाल करके, MCP सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास बातों की सूची बनाने का तरीका बताया गया है.

Curl अनुरोध
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'