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

1. परिचय

ध्यान दें: क्या अब भी Gemini CLI का इस्तेमाल किया जा रहा है? इस गाइड में, Antigravity CLI के बारे में बताया गया है. स्विच करने के तरीके के बारे में ज़्यादा जानकारी के लिए, यह आधिकारिक ब्लॉग पोस्ट पढ़ें.

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

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

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

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

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

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

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

Google Workspace डेवलपर के लिए झलक प्रोग्राम: 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 के स्टैंडर्ड एपीआई चालू करने होंगे.

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

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

इसके बाद, Google Workspace 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 की सहमति वाली स्क्रीन सेट अप करना

आपको पहले सहमति वाली स्क्रीन को कॉन्फ़िगर करना होगा.

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

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

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

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

पसंद के मुताबिक एमसीपी सर्वर जोड़ना

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

1. इसे अपने पसंदीदा टेक्स्ट एडिटर में खोलें.

   ध्यान दें: अगर आपने Antigravity IDE इंस्टॉल किया है, तो यहां दिया गया तरीका अपनाकर फ़ाइल को सीधे तौर पर ऐक्सेस किया जा सकता है:

   1. एडिटर के एजेंट पैनल में सबसे ऊपर मौजूद ... ड्रॉपडाउन से, एमसीपी सर्वर खोलें.
   2. एमसीपी सर्वर मैनेज करें पर क्लिक करें. इसके बाद, रॉ कॉन्फ़िगरेशन देखें पर क्लिक करें.
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. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.

4. सूची में दिए गए हर इंस्टॉल किए गए एमसीपी सर्वर के लिए:
   1. प्रमाणित करें पर क्लिक करें.
   
   2. खुली हुई नई ब्राउज़र विंडो में, पुष्टि करने की प्रोसेस पूरी करें.
   3. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
   
   4. अभी-अभी कॉपी किए गए ऑथराइज़ेशन कोड को Antigravity 2.0 की सेटिंग में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, सबमिट करें पर क्लिक करें.
   
   5. अब Authenticate की जगह Sign out बटन दिखता है.
   

Antigravity IDE

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

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

4. सूची में दिए गए हर इंस्टॉल किए गए एमसीपी सर्वर के लिए:
   1. प्रमाणित करें पर क्लिक करें.
   
   2. खुली हुई नई ब्राउज़र विंडो में, पुष्टि करने की प्रोसेस पूरी करें.
   3. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
   
   4. आपने अभी जो ऑथराइज़ेशन कोड कॉपी किया है उसे Antigravity IDE की सेटिंग में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, सबमिट करें पर क्लिक करें.
   
   5. अब Authenticate की जगह Sign out बटन दिखता है.
   

Antigravity CLI

1. /mcp लिखें और enter दबाएं.

2. सूची में दिए गए हर एमसीपी सर्वर के लिए:
   1. इसे चुनने के लिए, अप और डाउन ऐरो बटन का इस्तेमाल करें. इसके बाद, Enter दबाएं.
   2. लेफ़्ट और राइट ऐरो बटन का इस्तेमाल करके, Authenticate चुनें. इसके बाद, enter दबाएं.
   
   3. नई ब्राउज़र विंडो में दिखाया गया यूआरएल खोलें और पुष्टि करने की प्रोसेस पूरी करें.
   
   4. इसके बाद, क्लिपबोर्ड पर कॉपी करें पर क्लिक करें.
   
   5. अभी-अभी कॉपी किए गए ऑथराइज़ेशन कोड को, Antigravity CLI के साथ चल रहे टर्मिनल में दिखने वाले टेक्स्ट फ़ील्ड में चिपकाएं. इसके बाद, enter दबाएं.
   
   6. अब Auth Needed की जगह Authed स्टेटस दिख रहा है.
   

5. टेस्टिंग टूल

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

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

यूनिवर्सल

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

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

Gmail

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

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

Google Drive

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

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

Google Docs, Sheets, Slides

Drive में मौजूद संसाधनों को खोजने की कोशिश करें:

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

Google Calendar

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

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

Google Chat

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

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

People API

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

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

एक से ज़्यादा सेवाओं को एक साथ इस्तेमाल करना

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

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

अन्य टूल एक्सप्लोर करें

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

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

अपने प्रोजेक्ट को मिटाए बिना उसे साफ़ करने के लिए, चालू किए गए एपीआई और एमसीपी सेवाओं को बंद करें:

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

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

7. बधाई हो

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

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

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