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

1. परिचय

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

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

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

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, कई सेवाओं के ज़रिए टास्क मैनेज करता है. इससे MCP की असली ताकत का पता चलता है. क्रॉस-सर्विस की सुविधाओं को दिखाने वाले इन प्रॉम्प्ट को आज़माएँ:

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

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

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

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

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

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

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

8. बधाई हो

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

आपको क्या सीखने को मिला

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

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

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