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

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

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

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

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

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

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

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

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

  • Google Chat API

CLI

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

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

कंसोल

Google Cloud कंसोल में एपीआई चालू करें:

एपीआई चालू करें

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

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

  • Google Chat MCP API

CLI

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

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

कंसोल

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

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

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

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

  1. Google Cloud कंसोल में, Google Chat API खोजें. इसके बाद, Google Chat API > Manage > Configuration पर क्लिक करें.

    Google Chat API पर जाएं

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

    1. App name फ़ील्ड में, Chat MCP डालें.
    2. Avatar URL फ़ील्ड में, https://developers.google.com/chat/images/quickstart-app-avatar.png डालें.
    3. Description में, Chat MCP server डालें.
    4. Functionality में जाकर, Enable interactive features को टॉगल करके, इंटरैक्टिव सुविधाएं बंद करें.
    5. Logs में जाकर, Log errors to Logging को चुनें.

  3. Save पर क्लिक करें.

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

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

  1. Google Cloud कंसोल में, Google Auth Platform > Branding पर जाएं.

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

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

    1. App Information में जाकर, App name में Chat MCP Server टाइप करें.
    2. User support email में जाकर, अपना ईमेल पता या कोई सही Google group चुनें.
    3. Next पर क्लिक करें.
    4. Audience में जाकर, Internal को चुनें. अगर Internal को नहीं चुना जा सकता, तो External को चुनें.
    5. Next पर क्लिक करें.
    6. Contact Information में जाकर, Email address में वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में होने वाले बदलावों के बारे में सूचनाएं मिल सकती हैं.
    7. Next पर क्लिक करें.
    8. Finish में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो I agree to the Google API Services: User Data Policy को चुनें.
    9. Continue पर क्लिक करें.
    10. Create पर क्लिक करें.
    11. अगर आपने उपयोगकर्ता के टाइप के लिए External को चुना है, तो टेस्ट के लिए उपयोगकर्ता जोड़ें:
      1. Audience पर क्लिक करें.
      2. Test users में जाकर, Add users पर क्लिक करें.
      3. अपना ईमेल पता और टेस्ट के लिए अनुमति पाए अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, Save पर क्लिक करें.

  3. Data Access > Add or Remove Scopes पर क्लिक करें. आपको एक पैनल दिखेगा. इसमें, आपके Google Cloud प्रोजेक्ट में चालू किए गए हर एपीआई के लिए स्कोप की सूची दिखेगी.

    1. Manually add scopes में जाकर, 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.readonly

    2. Add to Table पर क्लिक करें.

    3. Update पर क्लिक करें.

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

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

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

Gemini CLI

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

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

    1. Google Cloud कंसोल में, Google Auth Platform > Clients > Create Client पर जाएं

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

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

    3. कोई Name डालें.

    4. Create पर क्लिक करें. इसके बाद, अपना Client ID और Client Secret कॉपी करें.

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

  3. 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.messages.create",
          "https://www.googleapis.com/auth/chat.users.readstate.readonly"
        ]
      }
    }
  }
}

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

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

  4. settings.json सेव करें.

  5. Gemini CLI शुरू करें:

    gemini

  6. Gemini CLI में, एमसीपी सर्वर से पुष्टि करने के लिए, यह कमांड चलाएं:

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

  7. Gemini CLI में, कॉन्फ़िगर किए गए एमसीपी सर्वर और उनके टूल देखने के लिए, /mcp list चलाएं.

    आपको इस तरह का जवाब मिलेगा:

    🟢 chat - Ready (4 tools)
  Tools:
  - search_conversations
  - list_messages
  - search_messages
  - send_message

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

Claude

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

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

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

    1. Google Cloud कंसोल में, Google Auth Platform > Clients > Create Client पर जाएं

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

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

    3. कोई Name डालें.

    4. Authorized redirect URIs सेक्शन में, + Add URI पर क्लिक करें. इसके बाद, https://claude.ai/api/mcp/auth_callback को URIs फ़ील्ड में जोड़ें.

    5. Create पर क्लिक करें. इसके बाद, अपना Client ID और Client Secret कॉपी करें.

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

    1. Claude.ai या Claude Desktop में, Settings (या Admin settings) > Connectors पर जाएं.
    2. Add custom connector पर क्लिक करें.
    3. Google Chat प्रॉडक्ट के लिए कनेक्शन की जानकारी डालें:
      • Server name: Google Chat.
      • Remote MCP server URL: https://chatmcp.googleapis.com/mcp/v1
    4. Advanced settings में जाकर, अपना OAuth client ID और OAuth client secret डालें.
    5. Add पर क्लिक करें.

अन्य

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

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

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

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

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

  • "'Project X' स्पेस में आखिरी मैसेज कौन सा था?"

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

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

समस्या का हल

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

टूल के बारे में जानकारी

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message

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

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

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

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