Google Antigravity में Google Workspace के एमसीपी सर्वर

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 के एमसीपी सर्वर का ऐक्सेस, Public Developer Preview Program का हिस्सा है. अगर आपने अब तक साइन अप नहीं किया है, तो कृपया साइन अप करें. साथ ही, पक्का करें कि आपका खाता https://developers.google.com/workspace/preview पर जाकर, इस प्रोग्राम में स्वीकार कर लिया गया हो.

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 > मैनेज करें > कॉन्फ़िगरेशन पर क्लिक करें.

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

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

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

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

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

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

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

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

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 के आधिकारिक एमसीपी सर्वर को कॉन्फ़िगर और उनकी जांच कर ली है.

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

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