Google Workspace MCP और Gemini CLI का इस्तेमाल शुरू करना

1. परिचय

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

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

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

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

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

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

इस कोडलैब को पूरा करने में करीब 30 मिनट लगेंगे.

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

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

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

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

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

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

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

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

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

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

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

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

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

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 डालें.
   • Description में, 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. अगर आपने External चुना है, तो Audience पर जाएं और Test users में जाकर अपना ईमेल पता जोड़ें.
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 क्लाइंट आईडी बनाना

Google Workspace के एमसीपी सर्वर के लिए OAuth 2.0 क्लाइंट को कॉन्फ़िगर करते समय, आपको एजेंटिक क्लासिफ़िकेशन सेटिंग (is_agentic) चालू करनी होगी. इसके लिए, एआई की मदद से काम करने वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को चुनें. जिन OAuth क्लाइंट के लिए यह सेटिंग चालू नहीं है वे Google Workspace के एमसीपी एंडपॉइंट पर अनुरोध नहीं भेज पाएंगे.

1. Google Auth Platform > क्लाइंट > क्लाइंट बनाएं (या एपीआई और सेवाएं > क्रेडेंशियल > क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी) पर जाएं.
2. ऐप्लिकेशन टाइप के तौर पर, डेस्कटॉप ऐप्लिकेशन चुनें.
3. इसे Gemini CLI नाम दें.
4. OAuth क्लाइंट पर is_agentic क्लासिफ़िकेशन फ़्लैग को चालू करने के लिए, एआई की मदद से काम करने वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को चुनें.
5. Create पर क्लिक करें और Client ID और क्लाइंट सीक्रेट को कॉपी करें. आपको अगले चरण में इनकी ज़रूरत पड़ेगी.

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

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

लोकल एनवायरमेंट ज़रूरी है: इस चरण के लिए Cloud Shell का इस्तेमाल न करें. Gemini CLI को OAuth से पुष्टि करने के लिए, लोकल ब्राउज़र की ज़रूरत होती है. कृपया अपनी लोकल मशीन के टर्मिनल का इस्तेमाल करें. ज़्यादा जानकारी के लिए, ब्राउज़र रीडायरेक्ट से जुड़ी ज़रूरी शर्तें देखें.

कॉन्फ़िगरेशन फ़ाइल बनाना

अपनी होम डायरेक्ट्री में ~/.gemini/settings.json खोलें या बनाएं और यह कॉन्फ़िगरेशन जोड़ें. प्लेसहोल्डर को अपने OAuth क्रेडेंशियल से बदलें.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

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

एमसीपी सर्वर इस्तेमाल करने से पहले, आपको उनकी पुष्टि करनी होगी और यह पक्का करना होगा कि वे कनेक्ट हैं.

Gemini CLI का इस्तेमाल शुरू करना

Gemini CLI को शुरू करने के लिए, अपने टर्मिनल में यह कमांड चलाएं:

gemini

पुष्टि करें

Gemini सीएलआई में, आपको जिन सेवाओं को टेस्ट करना है उनसे जुड़ी कमांड चलाकर, अपनी पहचान की पुष्टि करें. आपको सिर्फ़ उन सेवाओं के लिए पुष्टि करनी होगी जिनका इस्तेमाल आपको इस कोडलैब में करना है.

Calendar

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

लोग

/mcp auth people

हर सेवा को अनुमति देने के लिए, अपने ब्राउज़र में दिए गए निर्देशों का पालन करें.

कनेक्शन की पुष्टि करें

पुष्टि करें कि टूल लोड हो गए हैं और इस्तेमाल के लिए तैयार हैं:

/mcp list

आपको आउटपुट दिखना चाहिए. इससे पता चलता है कि सेवाएं Ready हैं और उनके टूल की सूची दी गई है.

6. एमसीपी सर्वर की जांच करें

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

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

Google Calendar

Gemini से अपने शेड्यूल के बारे में पूछें:

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

Google Chat

Gemini से मैसेज खोजने के लिए कहें:

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

Google Drive

Gemini से फ़ाइलें ढूँढने या पढ़ने के लिए कहें:

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

Gmail

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

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

People API

Gemini से अपनी प्रोफ़ाइल या संपर्कों के बारे में पूछें:

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

एक से ज़्यादा सेवाओं को जोड़ना

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

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

ज़्यादा टूल एक्सप्लोर करें

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

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

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

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

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

8. बधाई हो

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

आपने क्या सीखा

• Google Cloud में Google Workspace की एमसीपी सेवाएं चालू करने का तरीका.
• एमसीपी के लिए OAuth क्लाइंट को कॉन्फ़िगर करने का तरीका.
• स्टैंडर्ड टूल का इस्तेमाल करके, Google Workspace के डेटा के साथ इंटरैक्ट करने के लिए, Gemini CLI का इस्तेमाल करने का तरीका.

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

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