चैट एमसीपी सर्वर को कॉन्फ़िगर करना

इस प्रोग्राम के तहत, कुछ सुविधाओं को सार्वजनिक तौर पर उपलब्ध होने से पहले इस्तेमाल करने का ऐक्सेस मिलता है.

Google Chat, रिमोट मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर उपलब्ध कराता है. इसकी मदद से, एआई एजेंट Google Chat के डेटा के साथ सुरक्षित तरीके से इंटरैक्ट कर सकते हैं. Google Chat के एमसीपी सर्वर को कॉन्फ़िगर करके, एआई ऐप्लिकेशन जैसे कि Gemini CLI, Claude या IDE को Google Chat में कार्रवाइयां करने की अनुमति दी जा सकती है.

Google Chat का एमसीपी सर्वर, एआई एजेंट को ये काम करने का स्टैंडर्ड तरीका उपलब्ध कराता है:

डेटा ऐक्सेस करना: बातचीत की सूची देखना, बातचीत खोजना, और मैसेज पढ़ना.
सुरक्षा का ध्यान रखना: उपयोगकर्ता के पास मौजूद अनुमतियां और डेटा गवर्नेंस कंट्रोल को इनहेरिट करना.

ज़रूरी शर्तें

Google Cloud प्रोजेक्ट. प्रोजेक्ट बनाने के लिए, प्रोजेक्ट बनाना लेख पढ़ें.
Gemini CLI जैसा कोई एमसीपी क्लाइंट.
इस पेज पर दिए गए निर्देशों को चलाने के लिए, लोकल डेवलपमेंट एनवायरमेंट में gcloud CLI सेट अप करें. इसके लिए, यह तरीका अपनाएं:
1. Google Cloud सीएलआई इंस्टॉल करें. अगर आपने gcloud सीएलआई को पहले इंस्टॉल किया था, तो पक्का करें कि आपके पास gcloud components update चलाकर, सबसे नया वर्शन हो.
2. अगर किसी बाहरी आइडेंटिटी प्रोवाइडर (आईडीपी) का इस्तेमाल किया जा रहा है, तो फ़ेडरेट की गई अपनी पहचान का इस्तेमाल करके gcloud CLI में साइन इन करें. ज़्यादा जानकारी के लिए, फ़ेडरेट की गई अपनी पहचान का इस्तेमाल करके gcloud CLI में साइन इन करना लेख पढ़ें.
3. gcloud सीएलआई का इस्तेमाल शुरू करें.

Google Chat के एमसीपी सर्वर को कॉन्फ़िगर करना

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

एपीआई चालू करना

Google Chat MCP सर्वर का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में ये एपीआई चालू करने होंगे:

Google Chat API

सीएलआई

gcloud services enable chat.googleapis.com --project=PROJECT_ID

PROJECT_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.

कंसोल

Google Cloud Console में जाकर, इन एपीआई को चालू करें:

एपीआई चालू करना

एमसीपी सेवाएं चालू करें

Google Chat के लिए एमसीपी कॉम्पोनेंट चालू करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में यह सेवा चालू करनी होगी:

Google Chat MCP API

सीएलआई

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.

कंसोल

Google Cloud Console में एमसीपी सेवाएं चालू करें:

एमसीपी सेवाएं चालू करें

Chat ऐप्लिकेशन को कॉन्फ़िगर करना

Google Chat MCP सर्वर का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में Chat ऐप्लिकेशन को कॉन्फ़िगर करना होगा.

Google Cloud Console में, Google Chat API खोजें. इसके बाद, Google Chat API > मैनेज करें > कॉन्फ़िगरेशन पर क्लिक करें.

Google Chat API पर जाएं
Chat ऐप्लिकेशन सेट अप करने के लिए:
1. इस Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर बनाएं को अनचेक करें. पुष्टि करने के लिए एक डायलॉग बॉक्स खुलेगा. डायलॉग बॉक्स में, बंद करें पर क्लिक करें.
2. ऐप्लिकेशन का नाम फ़ील्ड में, Chat MCP डालें.
3. अवतार का यूआरएल फ़ील्ड में, https://developers.google.com/chat/images/quickstart-app-avatar.png डालें.
4. ब्यौरा में, Chat MCP server डालें.
5. फ़ंक्शन में जाकर, इंटरैक्टिव सुविधाओं को बंद करें. इसके लिए, इंटरैक्टिव सुविधाएं चालू करें को टॉगल करके बंद करें.
6. दिखने की सेटिंग में जाकर, अपने डोमेन में इस Chat ऐप्लिकेशन को चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें. इसके बाद, अपना ईमेल पता डालें.
7. लॉग में जाकर, लॉगिंग में गड़बड़ियों को लॉग करें चुनें.
सेव करें पर क्लिक करें.

Chat ऐप्लिकेशन बनाने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन का आर्किटेक्चर चुनें लेख पढ़ें.

Google Chat का एमसीपी सर्वर, पुष्टि करने और अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करता है. OAuth क्लाइंट आईडी बनाने से पहले, आपको OAuth की सहमति स्क्रीन को कॉन्फ़िगर करना होगा.

Google Cloud Console में, Google Auth Platform > ब्रैंडिंग पर जाएं.

ब्रैंडिंग पर जाएं
अगर आपने पहले ही Google Auth Platform को कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको यह मैसेज दिखता है कि Google Auth Platform को अभी तक कॉन्फ़िगर नहीं किया गया है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में Chat MCP Server टाइप करें.
2. उपयोगकर्ता सहायता के लिए ईमेल पता में, अपना ईमेल पता या कोई सही Google ग्रुप चुनें.
3. आगे बढ़ें पर क्लिक करें.
4. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें. अगर Internal को नहीं चुना जा सकता, तो External को चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव की सूचना मिल सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
11. अगर आपने उपयोगकर्ता के टाइप के लिए बाहरी चुना है, तो टेस्ट उपयोगकर्ता जोड़ें:
  1. ऑडियंस पर क्लिक करें.
  2. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
  3. अपना ईमेल पता और टेस्ट करने वाले अन्य ज़्यादाृत उपयोगकर्ताओं का ईमेल पता डालें. इसके बाद, सेव करें पर क्लिक करें.
डेटा ऐक्सेस > स्कोप जोड़ें या हटाएं पर क्लिक करें. एक पैनल दिखता है. इसमें हर उस एपीआई के लिए स्कोप की सूची होती है जिसे आपने अपने Google Cloud प्रोजेक्ट में चालू किया है.
1. स्कोप मैन्युअल तरीके से जोड़ें में जाकर, Google Chat के एमसीपी सर्वर के लिए स्कोप चिपकाएं:
  - https://www.googleapis.com/auth/chat.spaces.readonly
  - https://www.googleapis.com/auth/chat.memberships.readonly
  - https://www.googleapis.com/auth/chat.messages.readonly
  - https://www.googleapis.com/auth/chat.users.readstate.readonly
2. टेबल में जोड़ें पर क्लिक करें.
3. अपडेट करें पर क्लिक करें.
4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर जाकर, सेव करें पर क्लिक करें.

एमसीपी क्लाइंट को कॉन्फ़िगर करना

Google Chat के रिमोट एमसीपी सर्वर को अपने एमसीपी क्लाइंट में जोड़ने के लिए, अपने क्लाइंट के लिए दिए गए निर्देशों का पालन करें.

Gemini CLI

Google Chat के रिमोट एमसीपी सर्वर को Gemini CLI में जोड़ने के लिए, सर्वर कॉन्फ़िगरेशन को अपनी settings.json फ़ाइल में जोड़ें.

OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:
1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं
  
  क्लाइंट बनाएं पर जाएं
2. ऐप्लिकेशन के टाइप के तौर पर, डेस्कटॉप ऐप्लिकेशन चुनें.
3. कोई नाम डालें.
4. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.
कॉन्फ़िगरेशन फ़ाइल ~/.gemini/settings.json खोलें या बनाएं.

settings.json में mcpServers कॉन्फ़िगरेशन जोड़ें:

{
  "mcpServers": {
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/chat.spaces.readonly",
          "https://www.googleapis.com/auth/chat.memberships.readonly",
          "https://www.googleapis.com/auth/chat.messages.readonly",
          "https://www.googleapis.com/auth/chat.users.readstate.readonly"
        ]
      }
    }
  }
}

इनकी जगह ये डालें:

OAUTH_CLIENT_ID: यह आपके बनाए गए क्लाइंट आईडी की वैल्यू है.
OAUTH_CLIENT_SECRET: आपके बनाए गए क्लाइंट सीक्रेट.

settings.json की बचत करें.
Gemini CLI शुरू करें:
```
gemini
```
Gemini CLI में, एमसीपी सर्वर से पुष्टि करने के लिए, यह कमांड चलाएं:
```
/mcp auth chat
```
1. जब कहा जाए, तब अपने ब्राउज़र में पुष्टि करने वाला पेज खोलने के लिए, 1 दबाएं. अगर SSH पर काम किया जा रहा है, तो सीएलआई में दिए गए निर्देशों का पालन करें.
2. अपने Google खाते में साइन इन करें.
3. OAuth के लिए अनुरोध किए गए स्कोप की समीक्षा करें और अनुमति दें पर क्लिक करें.
4. आपको एक मैसेज दिखेगा, जिसमें पुष्टि की जाएगी कि पुष्टि करने की प्रोसेस पूरी हो गई है.
कॉन्फ़िगर किए गए एमसीपी सर्वर और उनके टूल देखने के लिए, Gemini CLI में /mcp list चलाएं.

जवाब कुछ इस तरह का होगा:
```
🟢 chat - Ready (2 tools)
  Tools:
  - search_conversations
  - list_messages
```

रिमोट एमसीपी सर्वर का इस्तेमाल, Gemini CLI में किया जा सकता है.

Claude

Claude.ai या Claude Desktop के साथ Google Chat के रिमोट MCP सर्वर का इस्तेमाल करने के लिए, आपके पास Claude Enterprise, Pro, Max या Team प्लान होना चाहिए.

Claude में Google Chat रिमोट एमसीपी सर्वर जोड़ने के लिए, OAuth क्लाइंट आईडी और सीक्रेट के साथ कस्टम कनेक्टर कॉन्फ़िगर करें.

OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:
1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं
  
  क्लाइंट बनाएं पर जाएं
2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.
3. कोई नाम डालें.
4. रीडाइरेक्ट करने के लिए अनुमति वाले यूआरआई सेक्शन में जाकर, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://claude.ai/api/mcp/auth_callback जोड़ें.
5. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.
Claude में एमसीपी सर्वर को कॉन्फ़िगर करें:
1. Claude.ai या Claude Desktop में, सेटिंग (या एडमिन सेटिंग) > कनेक्टर पर जाएं.
2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
3. Google Chat प्रॉडक्ट के लिए कनेक्शन की जानकारी डालें:
  - सर्वर का नाम: Google Chat.
  - रिमोट एमसीपी सर्वर का यूआरएल: https://chatmcp.googleapis.com/mcp/v1
4. ऐडवांस सेटिंग में जाकर, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
5. जोड़ें पर क्लिक करें.

अन्य

कई एआई ऐप्लिकेशन में, रिमोट एमसीपी सर्वर से कनेक्ट करने के तरीके होते हैं. आम तौर पर, आपको सर्वर के बारे में जानकारी डालनी होती है. जैसे, उसका नाम, एंडपॉइंट, ट्रांसपोर्ट प्रोटोकॉल, और पुष्टि करने का तरीका. Google Chat के रिमोट एमसीपी सर्वर के लिए, यह डालें:

सर्वर का नाम: chat
सर्वर यूआरएल: https://chatmcp.googleapis.com/mcp/v1
ट्रांसपोर्ट: एचटीटीपी
पुष्टि करना: Google Chat का रिमोट MCP सर्वर, OAuth 2.0 का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

अलग-अलग तरह के क्लाइंट कनेक्ट करने के बारे में ज़्यादा जानने के लिए, एआई ऐप्लिकेशन में एमसीपी कॉन्फ़िगर करना लेख पढ़ें.

Google Chat के एमसीपी सर्वर की जांच करना

एमसीपी क्लाइंट को कॉन्फ़िगर करने के बाद, कनेक्शन की पुष्टि करने के लिए, कुछ टेस्ट प्रॉम्प्ट चलाए जा सकते हैं.

अपने एमसीपी क्लाइंट से ये सवाल पूछें:

"'प्रोजेक्ट X' स्पेस में भेजा गया आखिरी मैसेज क्या था?"

क्लाइंट, search_conversations का इस्तेमाल करके स्पेस ढूंढता है. इसके बाद, list_messages का इस्तेमाल करके मैसेज वापस पाता है.

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

समस्या का हल

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

टूल का रेफ़रंस

Google Chat के एमसीपी सर्वर के लिए, ये टूल उपलब्ध हैं:

search_conversations
list_messages

सुरक्षा से जुड़ी अहम जानकारी: प्रॉम्प्ट इंजेक्शन का अप्रत्यक्ष तरीका

किसी भाषा मॉडल को ऐसे डेटा के संपर्क में लाने पर जिस पर भरोसा नहीं किया जा सकता, अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन अटैक का खतरा होता है. Gemini CLI जैसे एमसीपी क्लाइंट के पास, Google Chat एमसीपी सर्वर के ज़रिए शक्तिशाली टूल और एपीआई का ऐक्सेस होता है. इसलिए, वे आपके Google खाते में मौजूद डेटा को पढ़ सकते हैं, उसमें बदलाव कर सकते हैं, और उसे मिटा सकते हैं.

इन जोखिमों को कम करने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं:

सिर्फ़ भरोसेमंद टूल का इस्तेमाल करें. Google Chat के एमसीपी सर्वर को कभी भी ऐसे ऐप्लिकेशन से कनेक्ट न करें जिन पर भरोसा नहीं किया जा सकता या जिनकी पुष्टि नहीं हुई है.
गैर-भरोसेमंद इनपुट से सावधान रहें. अपने एमसीपी क्लाइंट से, बिना पुष्टि किए गए सोर्स से मिले मैसेज या अन्य संसाधनों को प्रोसेस करने के लिए न कहें. इन इनपुट में छिपे हुए निर्देश हो सकते हैं. इनकी वजह से, आपका सेशन हाइजैक हो सकता है. इससे हमलावर को आपके डेटा में बदलाव करने, उसे चुराने या मिटाने की अनुमति मिल जाती है.
सभी कार्रवाइयों की समीक्षा करें. हमेशा इस बात की सावधानी से समीक्षा करें कि आपके एआई क्लाइंट ने आपकी ओर से कौनसी कार्रवाइयां की हैं. इससे यह पक्का किया जा सकेगा कि वे सही हैं और आपके इरादों के मुताबिक हैं.

ज़रूरी शर्तें

Google Chat के एमसीपी सर्वर को कॉन्फ़िगर करना

एपीआई चालू करना

सीएलआई

कंसोल

एमसीपी सेवाएं चालू करें

सीएलआई

कंसोल

Chat ऐप्लिकेशन को कॉन्फ़िगर करना

ऐसी स्क्रीन सेट अप करना जहां OAuth के लिए सहमति दी जाती है

एमसीपी क्लाइंट को कॉन्फ़िगर करना

Gemini CLI

Claude

अन्य

Google Chat के एमसीपी सर्वर की जांच करना

समस्या का हल

टूल का रेफ़रंस

सुरक्षा से जुड़ी अहम जानकारी: प्रॉम्प्ट इंजेक्शन का अप्रत्यक्ष तरीका

मिलता-जुलता सेक्शन