Google Antigravity 2.0, IDE, और/या सीएलआई में Google Workspace एमसीपी सर्वर

1. परिचय

इस कोडलैब में, आपको मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) का इस्तेमाल करके, अपने Google Workspace डेटा को Antigravity 2.0, IDE, और/या सीएलआई से कनेक्ट करने का तरीका बताया जाएगा. एमसीपी एक ओपन स्टैंडर्ड है. इसकी मदद से, एआई मॉडल रिमोट सर्वर से मिले टूल का सुरक्षित तरीके से इस्तेमाल कर सकते हैं. आपको Gmail, Google Drive, Google Docs, Google Sheets, Google Slides, Google Calendar, Google Chat, और People API के साथ इंटरैक्ट करने के लिए, Antigravity को सेट अप करना होगा. इसके लिए, आपको कोई कोड लिखने की ज़रूरत नहीं होगी!

google_workspace_mcp_antigravity_arch_2.png

आपको क्या करना होगा

  • अपने Google Cloud प्रोजेक्ट में Google Workspace की एमसीपी सेवाएं चालू करें.
  • एमसीपी की इन सेवाओं को ऐक्सेस करने के लिए, Antigravity को कॉन्फ़िगर करें.
  • मज़ेदार और काम के प्रॉम्प्ट देकर, Google Workspace के डेटा के साथ इंटिग्रेशन को टेस्ट करें.

आपको किन चीज़ों की ज़रूरत होगी

  • Chrome जैसा कोई वेब ब्राउज़र
  • Google Workspace डेवलपर के लिए झलक Program में रजिस्टर किया गया Google क्लाउड प्रोजेक्ट
  • Google Workspace खाता
  • आपके कंप्यूटर पर Antigravity 2.0, IDE, और/या CLI इंस्टॉल होना चाहिए. आधिकारिक वेबसाइट पर जाकर, ज़्यादा जानकारी और इंस्टॉल करने के बारे में निर्देश पाएं.

इस कोडलैब को आसानी से ऐक्सेस किया जा सकता है

qr_code.png

2. शुरू करने से पहले

कोई Google Cloud प्रोजेक्ट बनाना या चुनना

Google Cloud Console में, कोई Google Cloud प्रोजेक्ट चुनें या बनाएं.

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

Google Workspace के एमसीपी सर्वर इस्तेमाल करने के लिए, आपको Google Workspace के स्टैंडर्ड एपीआई चालू करने होंगे.

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

इसके बाद, Google Workspace की एमसीपी सेवाएं चालू करें.

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

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

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

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

chat_app.png

3. OAuth सहमति और क्लाइंट को कॉन्फ़िगर करना

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

आपको पहले, ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है, को कॉन्फ़िगर करना होगा.

  1. Google Cloud Console में, Google Auth Platform > ब्रैंडिंग पर जाएं. अगर कॉन्फ़िगर नहीं किया गया है, तो शुरू करें पर क्लिक करें.
  2. ऐप्लिकेशन की जानकारी कॉन्फ़िगर करें:
    • ऐप्लिकेशन का नाम: Google Workspace MCP Servers
    • उपयोगकर्ता सहायता ईमेल: अपना ईमेल चुनें.
  3. ऑडियंस को कॉन्फ़िगर करें: इंटरनल चुनें. अगर इंटरनल उपलब्ध नहीं है, तो एक्सटर्नल चुनें.
  4. संपर्क जानकारी कॉन्फ़िगर करें: अपना ईमेल पता डालें.
  5. उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें और उससे सहमत हों. इसके बाद, बनाएं पर क्लिक करें.
  6. अगर आपने External चुना है, तो Audience पर जाएं और Test users में जाकर अपना ईमेल पता जोड़ें.
  7. डेटा ऐक्सेस > दायरे जोड़ें या हटाएं पर जाएं. मैन्युअल तरीके से स्कोप जोड़ें में जाकर, उन सर्वर के लिए ये स्कोप जोड़ें जिनका आपको इस्तेमाल करना है:
    • यूनिवर्सल: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
    • 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 Docs: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
    • Google Sheets: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
    • Google Slides: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
    • 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
  8. टेबल में जोड़ें पर क्लिक करें. इसके बाद, अपडेट करें और फिर सेव करें पर क्लिक करें.

oauth_consent_screen_1.pngoauth_consent_screen_2.pngoauth_consent_screen_3.png

OAuth क्लाइंट आईडी बनाना

  1. Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं.
  2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.
  3. इसे Antigravity नाम दें.
  4. अनुमति वाले रीडायरेक्ट यूआरआई में जाकर, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, https://antigravity.google/oauth-callback डालें.
  5. एआई की मदद से काम करने वाले एजेंट के लिए, इस क्लाइंट का इस्तेमाल करें को चुनें.
  6. बनाएं पर क्लिक करें. इसके बाद, क्लाइंट आईडी और क्लाइंट सीक्रेट को कॉपी करें. आपको अगले चरण में इनकी ज़रूरत पड़ेगी.

oauth_client.png

4. Antigravity को कॉन्फ़िगर करना

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

कस्टम एमसीपी सर्वर जोड़ना

Antigravity 2.0, IDE, और CLI, ~/.gemini/config/mcp_config.json फ़ाइल में एक ही MCP कॉन्फ़िगरेशन शेयर करते हैं.

  1. इसे अपने पसंदीदा टेक्स्ट एडिटर में खोलें.
  2. कस्टम एमसीपी सर्वर के इस कॉन्फ़िगरेशन में बदलाव करें. ऐसा करने से पहले, <YOUR_CLIENT_ID> और <YOUR_CLIENT_SECRET> प्लेसहोल्डर को OAuth क्लाइंट आईडी और सीक्रेट से बदलें. इन्हें आपने पिछले चरणों में बनाया था.
  3. इसे सेव करें.
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

कस्टम एमसीपी सर्वर की पुष्टि करना

आपको वे सभी एमसीपी सर्वर दिखेंगे जिन्हें आपने Antigravity में इंस्टॉल किए गए सर्वर के तौर पर कॉन्फ़िगर किया है: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat, और gws-people. आपको हर Antigravity प्लैटफ़ॉर्म के लिए, हर खाते की पुष्टि करनी होगी. ऐसा इसलिए, क्योंकि OAuth टोकन को एक ही जगह से मैनेज नहीं किया जाता.

Antigravity 2.0

  1. सबसे नीचे बाईं ओर, सेटिंग पर क्लिक करें.
  2. कस्टमाइज़ेशन पर जाएं.
  3. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.

unauthed_mcp_servers_20.png

  1. इंस्टॉल किए गए हर एमसीपी सर्वर के लिए:
    1. प्रमाणित करें पर क्लिक करें.
    gui_auth.png
    1. नई ब्राउज़र विंडो में, पुष्टि करने की प्रोसेस पूरी करें.
    2. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
    copy_auth_code.png
    1. कॉपी किए गए ऑथराइज़ेशन कोड को Antigravity 2.0 की सेटिंग में मौजूद टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, सबमिट करें पर क्लिक करें.
    gui_paste_auth_code.png
    1. अब पुष्टि करें बटन की जगह साइन आउट करें बटन दिखेगा.
    gui_sign_out.png

Antigravity IDE

  1. विंडो में सबसे ऊपर मौजूद, Editor-Specific settings मेन्यू ड्रॉपडाउन से Antigravity User Settings खोलें.

open_user_settings_ide.png

  1. कस्टमाइज़ेशन पर जाएं.
  2. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.

unauthed_mcp_servers_ide.png

  1. इंस्टॉल किए गए हर एमसीपी सर्वर के लिए:
    1. प्रमाणित करें पर क्लिक करें.
    gui_auth.png
    1. नई ब्राउज़र विंडो में, पुष्टि करने की प्रोसेस पूरी करें.
    2. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
    copy_auth_code.png
    1. कॉपी किए गए ऑथराइज़ेशन कोड को Antigravity IDE की सेटिंग में दिख रहे टेक्स्ट फ़ील्ड में चिपकाएँ. इसके बाद, सबमिट करें पर क्लिक करें.
    gui_paste_auth_code.png
    1. अब पुष्टि करें बटन की जगह साइन आउट करें बटन दिखेगा.
    gui_sign_out.png

Antigravity CLI

  1. /mcp टाइप करें और enter दबाएं.

unauthed_mcp_servers_cli.png

  1. सूची में शामिल हर एमसीपी सर्वर के लिए:
    1. अप और डाउन ऐरो बटन का इस्तेमाल करके इसे चुनें. इसके बाद, enter दबाएं.
    2. लेफ़्ट और राइट ऐरो बटन का इस्तेमाल करके, Authenticate को चुनें. इसके बाद, enter दबाएं.
    cli_auth.png
    1. दिखाए गए यूआरएल को नई ब्राउज़र विंडो में खोलें और पुष्टि करने की प्रोसेस पूरी करें.
    cli_auth_url.png
    1. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
    copy_auth_code.png
    1. कॉपी किए गए ऑथराइज़ेशन कोड को, Antigravity CLI वाले टर्मिनल में दिख रहे टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, enter दबाएं.
    cli_paste_auth_code.png
    1. अब पुष्टि ज़रूरी है की जगह, पुष्टि हो गई स्टेटस दिखेगा.
    cli_sign_out.png

5. टेस्ट टूल

अब नैचुरल लैंग्वेज का इस्तेमाल करके, Google Workspace में मौजूद अपने डेटा से इंटरैक्ट किया जा सकता है. यहाँ हर सेवा के लिए कुछ प्रॉम्प्ट दिए गए हैं.

यूनिवर्सल

अलग-अलग प्रॉडक्ट में खोजें:

  • "मेरे Google Workspace खाते में हाल ही में हुई गतिविधियों के बारे में कुछ वाक्यों में बताओ."
  • "मेरे ईमेल, दस्तावेज़ों, और चैट मैसेज में [PROJECT_NAME] से जुड़ा कुछ भी ढूँढो."
  • "मार्केटिंग प्लान के बारे में मेरी अगली मीटिंग कब है? साथ ही, इस बारे में सबसे नए नोट और चैट मैसेज क्या हैं?"

ide_uni_test.png

Gmail

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

  • "मुझे मिले पिछले पांच ईमेल की खास जानकारी दो."
  • "‘[EMAIL_ADDRESS]' को भेजने के लिए एक ईमेल का ड्राफ़्ट बनाओ. इसमें ‘[PROJECT_NAME]' प्रोजेक्ट के बारे में अपडेट देने का अनुरोध करो."

Google Drive

फ़ाइलें खोजने या पढ़ने के लिए, ये काम करें:

  • "मेरी Google Drive पर ऐसी फ़ाइलें खोजो जिनमें ‘[KEYWORD]' शामिल हो."
  • "उन दस्तावेज़ों की सूची दिखाओ जिनमें मैंने हाल ही में बदलाव किए हैं."
  • "मेरे ‘[FILE_NAME]' दस्तावेज़ का कॉन्टेंट पढ़ो और मुख्य लक्ष्यों की खास जानकारी दो."

Google Docs, Sheets, Slides

Drive में मौजूद अपने संसाधनों को खोजें:

  • "मुझे Google दस्तावेज़ [DOCS_TITLE] में मौजूद स्ट्रक्चरल कॉन्टेंट दिखाओ."
  • "Google शीट [SHEETS_TITLE] से शीट Sheet1 पढ़ो"
  • "मुझे Google Slides [SLIDES_TITLE] का लेआउट बोलकर बताओ."

Google Calendar

अपने शेड्यूल में खोजने के लिए, ये तरीके आज़माएं:

  • "इस हफ़्ते मेरी कौनसी मीटिंग होने वाली हैं?"
  • "क्या कल दोपहर को मेरे पास कुछ खाली समय है?"

Google Chat

मैसेज खोजने के लिए, ये तरीके आज़माएं:

  • "'[SPACE_NAME]' में ‘[KEYWORD]' वाले मैसेज खोजो"

People API

अपनी प्रोफ़ाइल या संपर्कों को खोजने की कोशिश करें:

  • "मेरी Google प्रोफ़ाइल के मुताबिक, मेरा नाम क्या है?"
  • "‘[NAME]' की संपर्क जानकारी ढूँढो."

एक से ज़्यादा सेवाओं को जोड़ना

एमसीपी की असली ताकत तब पता चलती है, जब कई सेवाओं के टास्क को एक साथ मैनेज किया जाता है. अलग-अलग सेवाओं के साथ काम करने की क्षमता दिखाने वाले ये प्रॉम्प्ट आज़माएँ:

  • "Drive में ‘[PROJECT_NAME] milestone updates' से जुड़ी फ़ाइलें खोजो और उनके कॉन्टेंट की खास जानकारी जनरेट करो. इसके बाद, ‘[NAME]' का ईमेल पता ढूंढो और खास जानकारी के साथ Gmail पर एक ड्राफ़्ट ईमेल तैयार करो."

ज़्यादा टूल एक्सप्लोर करें

ये कुछ उदाहरण हैं, जिनसे पता चलता है कि Gemini का इस्तेमाल करके क्या-क्या किया जा सकता है. हर सेवा के लिए उपलब्ध टूल की पूरी सूची देखने और उन्हें आज़माने के लिए, आधिकारिक दस्तावेज़ के इस्तेमाल किए जा सकने वाले प्रॉडक्ट सेक्शन पर जाएं.

6. व्यवस्थित करें

प्रोजेक्ट को मिटाए बिना उसे खाली करने के लिए, चालू किए गए एपीआई और एमसीपी की सेवाएं बंद की जा सकती हैं:

  1. Google Cloud Console में, एपीआई और सेवाओं के डैशबोर्ड पर जाएं.
  2. आपने Google Workspace और एमसीपी के जिन एपीआई को चालू किया है उन पर क्लिक करें.जैसे, Calendar MCP, Chat MCP. इसके बाद, एपीआई बंद करें पर क्लिक करें.

अगर आपको OAuth क्लाइंट क्रेडेंशियल का इस्तेमाल नहीं करना है, तो उन्हें Google Auth Platform कंसोल से मिटा दें.

7. बधाई हो

बधाई हो! आपने Antigravity का इस्तेमाल करके, Google Workspace के आधिकारिक एमसीपी सर्वर को कॉन्फ़िगर और टेस्ट कर लिया है.

रेफ़रंस के लिए दस्तावेज़