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

1. परिचय

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

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

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

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

• Chrome जैसे वेब ब्राउज़र
• Google Cloud प्रोजेक्ट
• Google Workspace खाता
• आपकी लोकल मशीन पर इंस्टॉल किया गया Gemini CLI

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

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

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. इसे Gemini CLI नाम दें.
4. बनाएं पर क्लिक करें. इसके बाद, क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें. आपको अगले चरण में इनकी ज़रूरत होगी.

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

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

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

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

अपनी होम डायरेक्ट्री में ~/.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 CLI में उनसे जुड़ा कमांड चलाएं. आपको सिर्फ़ उन सेवाओं के साथ पुष्टि करनी होगी जिनका इस्तेमाल, इस कोडलैब में करना है.

Calendar

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

People

/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] माइलस्टोन अपडेट' से जुड़ी फ़ाइलें खोजो. उनके कॉन्टेंट का सारांश बताओ. ‘[NAME]' के लिए ईमेल पता खोजो. साथ ही, उन्हें सारांश के साथ Gmail का ड्राफ़्ट भेजो."

अन्य टूल के बारे में जानें

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

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

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

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

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

8. बधाई हो

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

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

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

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

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