Antigravity में Google Workspace MCP सर्वर

1. परिचय

ध्यान दें: क्या Gemini CLI का इस्तेमाल किया जा रहा है? इसके बजाय, इस कोडलैब पर जाएं. यह गाइड खास तौर पर Antigravity के लिए है.

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

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

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

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

• कोई वेब ब्राउज़र, जैसे कि Chrome
• Google Cloud प्रोजेक्ट
• Google Workspace खाता
• आपके कंप्यूटर पर Antigravity इंस्टॉल किया गया हो

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

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

Google Workspace Developer Preview Program: Google Workspace MCP सर्वर का ऐक्सेस, Public Developer Preview Program का हिस्सा है. अगर आपने पहले से साइन अप नहीं किया है, तो कृपया साइन अप करें. साथ ही, यह पक्का करें कि https://developers.google.com/workspace/preview पर आपका खाता इस प्रोग्राम में स्वीकार कर लिया गया हो.

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

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

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

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

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

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

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

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

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

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

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

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

Google Chat API पर जाएं

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

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

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

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 क्लाइंट आईडी बनाना

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

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

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

अपनी पसंद के एमसीपी सर्वर जोड़ना

1. एडिटर के एजेंट पैनल में सबसे ऊपर मौजूद ... ड्रॉपडाउन से, MCP सर्वर खोलें.

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

4. नई खुली फ़ाइल mcp_config.json में, एमसीपी सर्वर के लिए ज़रूरत के मुताबिक कॉन्फ़िगरेशन में बदलाव करें. ऐसा करने से पहले, <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>"
      }
    }
  }
}

5. एमसीपी सर्वर मैनेज करें पर वापस जाएं. इसके बाद, रीफ़्रेश करें पर क्लिक करें.

ज़रूरत के मुताबिक बनाए गए एमसीपी सर्वर की पुष्टि करना

1. विंडो में सबसे ऊपर मौजूद, एडिटर के हिसाब से सेटिंग मेन्यू ड्रॉपडाउन के ज़रिए Antigravity की उपयोगकर्ता सेटिंग खोलें.

2. कस्टमाइज़ेशन पर जाएं.

3. इंस्टॉल किए गए एमसीपी सर्वर में शामिल हर सर्वर के लिए:
   1. प्रमाणित करें पर क्लिक करें.

2. खुली हुई नई ब्राउज़र विंडो में, पुष्टि करने की प्रोसेस पूरी करें.
3. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.

4. ब्राउज़र विंडो बंद करें.
5. अभी-अभी कॉपी किए गए पुष्टि करने के कोड को, Antigravity की सेटिंग में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं.
6. सबमिट करें पर क्लिक करें.

5. टेस्ट टूल

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

ध्यान दें: नीचे दिए गए प्रॉम्प्ट में ब्रैकेट वाले प्लेसहोल्डर (जैसे, [NAME], [FILE_NAME]) को अपने Google Workspace डेटा की असल वैल्यू से बदलें.

Google Calendar

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

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

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 और MCP के जिन एपीआई को चालू किया है (जैसे, Calendar MCP, Chat MCP), उन पर क्लिक करें. इसके बाद, एपीआई बंद करें पर क्लिक करें.

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

7. बधाई हो

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

रेफ़रंस दस्तावेज़

• मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) के बारे में जानकारी
• Google Workspace MCP सर्वर कॉन्फ़िगर करना
• OAuth की सहमति कॉन्फ़िगर करना
• Antigravity Editor: एमसीपी इंटिग्रेशन