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

1. परिचय

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

google_workspace_mcp_antigravity_arch.png

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

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

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

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

इस कोडलैब को आसानी से ऐक्सेस करना

qr_code.png

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

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

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

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

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

  • Gmail और Chat के लिए, अब भी उनके स्टैंडर्ड एपीआई की ज़रूरत होती है.
  • Drive के कुछ टूल के लिए, स्टैंडर्ड एपीआई की ज़रूरत होती है.
  • Calendar के लिए, स्टैंडर्ड एपीआई चालू करने की ज़रूरत नहीं होती.
  • People API , स्टैंडर्ड ऐक्सेस और एमसीपी की सुविधा, दोनों को मैनेज करता है. इसलिए, इसके लिए अलग से एमसीपी सेवा चालू करने की ज़रूरत नहीं होती.

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

इसके बाद, प्रॉडक्ट के लिए, एमसीपी की खास सेवाएं चालू करें.

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

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 डालें.
    • **जानकारी** में, Chat MCP server डालें.
    • सुविधा में जाकर, इंटरैक्टिव सुविधाएं चालू करें को बंद करें.
    • लॉग में जाकर, लॉगिंग में गड़बड़ियां लॉग करें को चुनें.
  2. सेव करें पर क्लिक करें.

chat_app.png

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

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

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

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

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

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

oauth_client.png

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

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

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

Antigravity 2.0, आईडीई, और सीएलआई, ~/.gemini/config/mcp_config.json फ़ाइल में, एमसीपी के एक ही कॉन्फ़िगरेशन का इस्तेमाल करते हैं.

  1. इसे अपने पसंदीदा टेक्स्ट एडिटर में खोलें.
  2. इसमें, एमसीपी सर्वर के इस कस्टम कॉन्फ़िगरेशन में बदलाव करें. बदलाव करने से पहले, <YOUR_CLIENT_ID> और <YOUR_CLIENT_SECRET> प्लेसहोल्डर को, OAuth क्लाइंट आईडी और सीक्रेट से बदलें. ये क्रेडेंशियल आपने पिछले चरणों में बनाए थे:
{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}
  1. इसे सेव करें.

mcp_config_file.png

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

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

Antigravity 2.0

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

configured_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. विंडो में सबसे ऊपर मौजूद एडिटर के हिसाब से सेटिंग मेन्यू के ड्रॉपडाउन में जाकर, Antigravity की उपयोगकर्ता सेटिंग खोलें.

open_user_settings_ide.png

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

configured_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 दबाएं.

configured_mcp_servers_cli.png

  1. सूची में शामिल हर एमसीपी सर्वर के लिए:
    1. अप और डाउन ऐरो बटन का इस्तेमाल करके, इसे चुनें. इसके बाद, Enter दबाएं.
    2. लेफ़्ट और राइट ऐरो बटन का इस्तेमाल करके, पुष्टि करें को चुनें. इसके बाद, 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 Calendar

अपना शेड्यूल खोजने की कोशिश करें:

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

Antigravity 2.0

20_test.png

Antigravity IDE

ide_test.png

Antigravity CLI

cli_test.png

Google Chat

मैसेज खोजने की कोशिश करें:

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

Google Drive

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

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

Gmail

अपने ईमेल खोजने या मैनेज करने की कोशिश करें:

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

People API

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

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

कई सेवाओं को एक साथ इस्तेमाल करना

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

  • "Drive में, ‘[PROJECT_NAME] माइलस्टोन अपडेट’ से जुड़ी फ़ाइलें खोजो. उनके कॉन्टेंट का सारांश बताओ. ‘[NAME]' के लिए ईमेल पता खोजो. इसके बाद, सारांश के साथ उन्हें Gmail का ड्राफ़्ट बनाओ."

अन्य टूल के बारे में जानें

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

6. स्टोरेज में जगह बनाएं

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

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

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

7. बधाई हो

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

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