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

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

Google Workspace के एमसीपी सर्वर, एआई एजेंट को इन कामों को स्टैंडर्ड तरीके से करने की सुविधा देते हैं:

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

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

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

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

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

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

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • People API

सीएलआई

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com --project=PROJECT_ID

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

कंसोल

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

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

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

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

  • Gmail MCP API
  • Google Drive MCP API
  • Google Calendar MCP API
  • Google Chat MCP API

  • People MCP API

सीएलआई

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

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

कंसोल

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

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

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

Google Chat MCP सर्वर का इस्तेमाल करने के लिए, आपको अपने 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. ब्यौरा में, Chat MCP server डालें.
    4. फ़ंक्शन में जाकर, इंटरैक्टिव सुविधाओं को बंद करें. इसके लिए, इंटरैक्टिव सुविधाएं चालू करें को टॉगल करके बंद करें.
    5. लॉग में जाकर, लॉगिंग में लॉग की गई गड़बड़ियां चुनें.

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

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

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

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

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

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

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

  3. डेटा ऐक्सेस > स्कोप जोड़ें या हटाएं पर क्लिक करें. एक पैनल दिखता है. इसमें हर उस एपीआई के लिए स्कोप की सूची होती है जिसे आपने अपने Google Cloud प्रोजेक्ट में चालू किया है.

    1. स्कोप मैन्युअल तरीके से जोड़ें में जाकर, उन एमसीपी सर्वर के स्कोप चिपकाएं जिनका इस्तेमाल करना है:

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google Drive:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • Google Calendar:
        • https://www.googleapis.com/auth/calendar.calendarlist.readonly
        • https://www.googleapis.com/auth/calendar.events.freebusy
        • https://www.googleapis.com/auth/calendar.events.readonly
      • 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
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly

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

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

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

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

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

Antigravity

Google Workspace के रिमोट एमसीपी सर्वर को Antigravity में जोड़ने के लिए, सर्वर कॉन्फ़िगरेशन को अपनी 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. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

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

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

    {
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "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 की उपयोगकर्ता सेटिंग खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में दिए गए हर सर्वर (gmail, drive, calendar, people, chat) के लिए, Authenticate पर क्लिक करें. इसके बाद, अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, उसे इनपुट डायलॉग में चिपकाएं, और Submit पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

      3. हर एमसीपी सर्वर की पुष्टि करें:

        1. ऐरो बटन का इस्तेमाल करके सर्वर चुनें. इसके बाद, Authenticate कार्रवाई पर जाएं और Enter दबाएं. अपने ब्राउज़र में साइन-इन करने की प्रोसेस पूरी करें. इसके बाद, ऑथराइज़ेशन कोड को कॉपी करें. इसे टर्मिनल प्रॉम्प्ट में चिपकाएं और Enter दबाएं.
        2. आपने जिन सर्वर को कॉन्फ़िगर किया है (gmail, drive, calendar, people, chat), उनके लिए इन चरणों को दोहराएं.

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

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

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

Claude

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

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

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

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

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

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

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

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

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

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

    1. Claude.ai या Claude Desktop में, सेटिंग (या एडमिन सेटिंग) > कनेक्टर पर जाएं.
    2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
    3. आपको जिस Google Workspace प्रॉडक्ट को जोड़ना है उसके कनेक्शन की जानकारी डालें:
      • सर्वर का नाम: सर्वर का नाम, जैसे कि Gmail.
      • रिमोट एमसीपी सर्वर का यूआरएल: Google Workspace प्रॉडक्ट का यूआरएल, जैसे कि इनमें से कोई एक:
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google Drive: https://drivemcp.googleapis.com/mcp/v1
        • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
    4. ऐडवांस सेटिंग में जाकर, OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
    5. जोड़ें पर क्लिक करें.
    6. Google Workspace के हर उस प्रॉडक्ट के लिए यह तरीका दोहराएं जिसे आपको जोड़ना है.

अन्य

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

  • सर्वर का नाम: googleworkspace

  • सर्वर: Google Workspace के हर प्रॉडक्ट का अपना सर्वर यूआरएल होता है:

    • Gmail: https://gmailmcp.googleapis.com/mcp/v1
    • Google Drive: https://drivemcp.googleapis.com/mcp/v1
    • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
    • Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • People API: https://people.googleapis.com/mcp/v1

  • ट्रांसपोर्ट: एचटीटीपी

  • पुष्टि करना: Google Workspace का रिमोट MCP सर्वर, OAuth 2.0 का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

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

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

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

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

  • "मेरी Google प्रोफ़ाइल के हिसाब से, मेरा नाम क्या है?"

    क्लाइंट, people.get_user_profile का इस्तेमाल करके Google Workspace पर आपकी प्रोफ़ाइल की जानकारी वापस पाने के लिए करता है.

  • "मार्केटिंग प्लान फ़ाइल की खास जानकारी दो."

    क्लाइंट, "मार्केटिंग प्लान" का पता लगाने के लिए drive.search_files को कॉल करता है. इसके बाद, drive.read_file_content का इस्तेमाल करके, इसके कॉन्टेंट को वापस पाता है और उसकी खास जानकारी देता है.

  • "एरियल ने अपने पिछले ईमेल में, मार्केटिंग प्लान के बारे में क्या कहा था?"

    क्लाइंट, gmail.search_threads का इस्तेमाल करके, Ariel से मिले ईमेल को फ़िल्टर करता है. इसके बाद, gmail.get_thread का इस्तेमाल करके, थ्रेड के सबसे नए कॉन्टेंट को वापस लाता है. इसके बाद, वह आपके लिए इसकी खास जानकारी तैयार करता है.

  • "ariel@example.com को एक ईमेल लिखो. इसमें लिखो कि मैंने मार्केटिंग प्लान को मंज़ूरी दे दी है."

    क्लाइंट, gmail.create_draft का इस्तेमाल करके आपके ड्राफ़्ट फ़ोल्डर में एक ईमेल बनाता है. इससे आपको Gmail में जाकर, ईमेल की समीक्षा करने और उसे भेजने की सुविधा मिलती है.

  • "मेरी अगली मीटिंग एरियल के साथ कब है?"

    क्लाइंट, calendar.list_events का इस्तेमाल करके आपका शेड्यूल देखता है. साथ ही, वह आपको एरियल के साथ होने वाली अगली मीटिंग के बारे में बताता है.

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

समस्या का हल

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

इस्तेमाल किए जा सकने वाले प्रॉडक्ट

Google Workspace के ये प्रॉडक्ट, Google Workspace MCP सर्वर के साथ काम करते हैं. साथ ही, इनमें ये टूल उपलब्ध हैं:

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

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

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

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