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 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 का इस्तेमाल करते हैं. आपको सबसे पहले, सहमति वाली स्क्रीन को कॉन्फ़िगर करना होगा.

  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 आईडीई

  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 आईडीई की सेटिंग में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, सबमिट करें पर क्लिक करें.
    gui_paste_auth_code.png
    1. अब प्रमाणिता की पुष्टि करें की जगह, साइन आउट करें बटन दिखेगा.
    gui_sign_out.png

Antigravity सीएलआई

  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 सीएलआई के साथ आपके टर्मिनल में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, enter दबाएं.
    cli_paste_auth_code.png
    1. अब पुष्टि की ज़रूरत है की जगह, पुष्टि हो गई स्थिति दिखेगी.
    cli_sign_out.png

5. टूल की जांच करना

अब सामान्य भाषा का इस्तेमाल करके, Google Workspace के अपने डेटा के साथ इंटरैक्ट किया जा सकता है. यहां हर सेवा के लिए, प्रॉम्प्ट के कुछ उदाहरण दिए गए हैं.

Google Calendar

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

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

Antigravity 2.0

20_test.png

Antigravity आईडीई

ide_test.png

Antigravity सीएलआई

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. इसके बाद, एपीआई बंद करें पर क्लिक करें.

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

7. बधाई हो

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

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