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

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

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

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

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

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

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

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

Google Chat के एमसीपी सर्वर का इस्तेमाल करने के लिए, आपको अपने 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 में एमसीपी सेवाएं चालू करें:

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

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

Google Chat के एमसीपी सर्वर का इस्तेमाल करके, सिर्फ़ पढ़ने के लिए उपलब्ध कार्रवाइयां करने के लिए, आपको एपीआई चालू करना होगा और OAuth क्लाइंट बनाना होगा. जैसे, बातचीत खोजना. कॉन्फ़िगर किए गए Chat ऐप्लिकेशन की ज़रूरत नहीं है.

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

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

    Google Chat API पर जाएं

  2. Chat ऐप्लिकेशन सेट अप करें:

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

  3. सेव करें पर क्लिक करें.

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

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

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

    ब्रैंडिंग पर जाएं

  2. अगर आपने Google Auth Platform को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth के लिए सहमति देने की स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको Google Auth Platform को अब तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:

    1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में Chat MCP Server टाइप करें.
    2. उपयोगकर्ता सहायता ईमेल में, अपना ईमेल पता या कोई सही Google ग्रुप चुनें.
    3. आगे बढ़ें पर क्लिक करें.
    4. ऑडियंस में जाकर, इंटरनल को चुनें. अगर इंटरनल को नहीं चुना जा सकता, तो एक्सटर्नल को चुनें.
    5. आगे बढ़ें पर क्लिक करें.
    6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में होने वाले किसी भी बदलाव की सूचना मिल सके.
    7. आगे बढ़ें पर क्लिक करें.
    8. पूरा करें में जाकर, Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें. अगर आप सहमत हैं, तो मैं Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
    9. जारी रखें पर क्लिक करें.
    10. बनाएं पर क्लिक करें.
    11. अगर आपने उपयोगकर्ता टाइप के लिए बाहरी चुना है, तो टेस्ट उपयोगकर्ताओं को जोड़ें:
      1. ऑडियंस पर क्लिक करें.
      2. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
      3. अपना ईमेल पता और अनुमति वाले अन्य टेस्ट उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, सेव करें पर क्लिक करें.

  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.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. टेबल में जोड़ें पर क्लिक करें.

    3. अपडेट करें पर क्लिक करें.

    4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर, सेव करें पर क्लिक करें.

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

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

Antigravity

Antigravity में Google Chat का रिमोट एमसीपी सर्वर जोड़ने के लिए, सर्वर कॉन्फ़िगरेशन को अपनी mcp_config.json फ़ाइल में जोड़ें. ये निर्देश Antigravity 2.0, Antigravity IDE, और Antigravity CLI पर लागू होते हैं.

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं

      'क्लाइंट बनाएं' पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. अनुमति वाले रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://antigravity.google/oauth-callback जोड़ें.

    5. एआई की मदद से काम करने वाले एजेंट के लिए, इस क्लाइंट का इस्तेमाल करें को चुनें.

    6. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  2. कॉन्फ़िगरेशन फ़ाइल ~/.gemini/config/mcp_config.json खोलें या बनाएं.

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

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

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

    • OAUTH_CLIENT_ID: आपका बनाया गया क्लाइंट आईडी.
    • OAUTH_CLIENT_SECRET: आपका बनाया गया क्लाइंट सीक्रेट.

  4. mcp_config.json की बचत करें.

  5. एमसीपी सर्वर की पुष्टि करें. जीयूआई सेटिंग या सीएलआई का इस्तेमाल करके, पुष्टि की जा सकती है:

    • Antigravity IDE या GUI (Antigravity 2.0) के लिए:

      1. सेटिंग स्क्रीन खोलें. उदाहरण के लिए, सबसे नीचे बाईं ओर मौजूद सेटिंग पर क्लिक करें या Antigravity User Settings खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में chat ढूंढें और पुष्टि करें पर क्लिक करें. इसके बाद, अपने Google खाते में साइन इन करें और अनुमति देने वाला कोड कॉपी करें. फिर, उसे इनपुट डायलॉग में चिपकाएं और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

      1. Antigravity CLI को शुरू करें:

        agy

      2. इंटरैक्टिव एमसीपी मैनेजमेंट पैनल खोलने के लिए, यह कमांड चलाएं:

        /mcp

      3. ऐरो बटन का इस्तेमाल करके, chat को चुनें. इसके बाद, पुष्टि करें कार्रवाई पर जाएं और Enter दबाएं. अपने ब्राउज़र में साइन-इन की प्रोसेस पूरी करें. इसके बाद, ऑथराइज़ेशन कोड को कॉपी करके टर्मिनल प्रॉम्प्ट में चिपकाएं और Enter दबाएं.

  6. पुष्टि करें कि सर्वर सही तरीके से कॉन्फ़िगर किया गया है और चल रहा है:

    • Antigravity IDE या जीयूआई के लिए: पसंद के मुताबिक़ बनाएँ > इंस्टॉल किए गए एमसीपी सर्वर में जाकर, सर्वर के बगल में मौजूद साइन आउट करें बटन पर क्लिक करें.
    • Antigravity CLI के लिए: कॉन्फ़िगर किए गए एमसीपी सर्वर देखने के लिए, /mcp पैनल खोलें. जिन सर्वर की पुष्टि हो चुकी है उनके नाम के बगल में, इंटरैक्टिव टीयूआई पैनल में Authed दिखता है. डैशबोर्ड व्यू में जाकर, किसी भी सर्वर को चुना जा सकता है. इससे उसकी स्थिति देखी जा सकती है और उसमें उपलब्ध सभी टूल की सूची देखी जा सकती है.

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

Claude

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

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

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं

      'क्लाइंट बनाएं' पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. अनुमति वाले रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://claude.ai/api/mcp/auth_callback जोड़ें.

    5. एआई की मदद से काम करने वाले एजेंट के लिए, इस क्लाइंट का इस्तेमाल करें को चुनें.

    6. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  2. Claude में एमसीपी सर्वर को कॉन्फ़िगर करें:

    1. Claude.ai या Claude Desktop में, Settings (या Admin settings) > Connectors पर जाएं.
    2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
    3. Google Chat प्रॉडक्ट के लिए कनेक्शन की जानकारी डालें:
      • सर्वर का नाम: Google Chat.
      • रिमोट एमसीपी सर्वर का यूआरएल: https://chatmcp.googleapis.com/mcp/v1
    4. ऐडवांस सेटिंग में जाकर, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
    5. जोड़ें पर क्लिक करें.

अन्य

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

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

Google Chat के एमसीपी सर्वर को टेस्ट करना

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

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

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

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

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

समस्या का हल

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

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

अगर आपको हर घंटे फिर से साइन इन करने के लिए कहा जाता है, तो इसका मतलब है कि आपके एमसीपी क्लाइंट को रीफ़्रेश टोकन नहीं मिल रहा है. Google का ऑथराइज़ेशन सर्वर, रीफ़्रेश टोकन सिर्फ़ तब जारी करता है, जब अनुमति के अनुरोध में access_type=offline शामिल हो. सिर्फ़ ओआईडीसी offline_access स्कोप का अनुरोध करना काफ़ी नहीं है. अगर आपका एमसीपी क्लाइंट, अनुमति देने के लिए कस्टम पैरामीटर इस्तेमाल करने की सुविधा देता है, तो अनुमति देने के अनुरोध में access_type=offline जोड़ें. जिस उपयोगकर्ता ने पहले ही ऐक्सेस दे दिया है उसके लिए नया रीफ़्रेश टोकन पाने के लिए, prompt=consent भी जोड़ें.

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

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

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

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

इन जोखिमों को कम करने के लिए, आपको नुकसान पहुंचाने वाले कॉन्टेंट या प्रॉम्प्ट इंजेक्शन अटैक के लिए, प्रॉम्प्ट और जवाबों की जांच करनी चाहिए. Google के Model Armor का इस्तेमाल किया जा सकता है. इसके अलावा, आपके पास अपना समाधान इस्तेमाल करने का विकल्प भी है. हालांकि, इसके लिए आपको उसे दस्तावेज़ में शामिल करना होगा, ताकि उपयोगकर्ता उस जोखिम को स्वीकार कर सकें. ज़्यादा जानकारी के लिए, Google Workspace के एमसीपी सर्वर के लिए सुरक्षा कॉन्फ़िगर करना लेख पढ़ें.

ये सबसे सही तरीके अपनाएं:

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