Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना

इस प्रोग्राम के तहत, कुछ सुविधाओं को सार्वजनिक तौर पर उपलब्ध होने से पहले इस्तेमाल करने का ऐक्सेस मिलता है.

Google Workspace, रिमोट मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर उपलब्ध कराता है. इनकी मदद से, एआई एजेंट Google Workspace के डेटा के साथ सुरक्षित तरीके से इंटरैक्ट कर सकते हैं. Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करके, एआई ऐप्लिकेशन को Google Workspace के ऐप्लिकेशन में कार्रवाइयां करने की अनुमति दी जा सकती है. जैसे, Gemini CLI, Claude या IDE को Gmail, Google Drive, और Google Calendar में कार्रवाइयां करने की अनुमति देना. Google Workspace के हर प्रॉडक्ट का अपना अलग MCP सर्वर होता है.

Google Workspace के एमसीपी सर्वर, एआई एजेंट को इन कामों को स्टैंडर्ड तरीके से करने की सुविधा देते हैं:

डेटा पढ़ना: ईमेल खोजना, फ़ाइलें वापस पाना, और कैलेंडर इवेंट की सूची बनाना.
कार्रवाई करना: ईमेल के ड्राफ़्ट बनाना, फ़ाइलें अपलोड करना, और मीटिंग शेड्यूल करना.
सुरक्षा का ध्यान रखना: उपयोगकर्ता के पास मौजूद अनुमतियां और डेटा गवर्नेंस कंट्रोल को इनहेरिट करना.

ज़रूरी शर्तें

Google Cloud प्रोजेक्ट. प्रोजेक्ट बनाने के लिए, प्रोजेक्ट बनाना लेख पढ़ें.
एमसीपी क्लाइंट, जैसे कि Gemini CLI.
इस पेज पर दिए गए निर्देशों को चलाने के लिए, gcloud CLI को इनमें से किसी एक डेवलपमेंट एनवायरमेंट में सेट अप करें:
Cloud Shell
gcloud सीएलआई के साथ पहले से सेट अप किए गए ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell चालू करें:

Cloud Shell चालू करें
लोकल शेल
लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, यह तरीका अपनाएं:
1. Google Cloud सीएलआई इंस्टॉल करें. अगर आपने gcloud सीएलआई को पहले इंस्टॉल किया था, तो पक्का करें कि आपके पास इसका नया वर्शन हो. इसके लिए, gcloud components update चलाएं.
2. अगर किसी बाहरी आइडेंटिटी प्रोवाइडर (आईडीपी) का इस्तेमाल किया जा रहा है, तो फ़ेडरेट की गई अपनी पहचान का इस्तेमाल करके, gcloud CLI में साइन इन करें. ज़्यादा जानकारी के लिए, फ़ेडरेट की गई अपनी पहचान का इस्तेमाल करके gcloud CLI में साइन इन करना लेख पढ़ें.
3. gcloud सीएलआई का इस्तेमाल शुरू करें.

Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना

Google Workspace के एमसीपी सर्वर का इस्तेमाल करने के लिए, आपको उन्हें अपने Google Cloud प्रोजेक्ट में चालू करना होगा. इसके बाद, एमसीपी क्लाइंट को उनसे कनेक्ट करने के लिए कॉन्फ़िगर करना होगा.

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

Google Workspace MCP सर्वर का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में ये एपीआई चालू करने होंगे:

Gmail API
Google Drive API
Google Calendar API
People API

सीएलआई

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.

कंसोल

Google Cloud Console में जाकर, इन एपीआई को चालू करें:

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

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

हर Google Workspace प्रॉडक्ट के लिए, MCP कॉम्पोनेंट चालू करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में ये सेवाएं चालू करनी होंगी:

Gmail MCP API
Google Drive MCP API
Google Calendar MCP API
People MCP API

सीएलआई

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
calendarmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID

PROJECT_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें.

कंसोल

Google Cloud Console में एमसीपी सेवाएं चालू करें:

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

Google Workspace के एमसीपी सर्वर, पुष्टि करने और अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करते हैं. OAuth क्लाइंट आईडी बनाने से पहले, आपको उस स्क्रीन को कॉन्फ़िगर करना होगा जहां OAuth को सहमति दी जाती है.

Google Cloud Console में, Google Auth Platform > ब्रैंडिंग पर जाएं.

ब्रैंडिंग पर जाएं
अगर आपने पहले ही Google Auth Platform को कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth Platform को अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में Workspace MCP Servers टाइप करें.
2. उपयोगकर्ता सहायता के लिए ईमेल पता में, अपना ईमेल पता या कोई सही Google ग्रुप चुनें.
3. आगे बढ़ें पर क्लिक करें.
4. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें. अगर इंटरनल को नहीं चुना जा सकता, तो एक्सटर्नल को चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
11. अगर आपने उपयोगकर्ता के टाइप के लिए बाहरी चुना है, तो टेस्ट उपयोगकर्ता जोड़ें:
  1. ऑडियंस पर क्लिक करें.
  2. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
  3. अपना ईमेल पता और टेस्ट के लिए अनुमति पा चुके अन्य उपयोगकर्ताओं का ईमेल पता डालें. इसके बाद, सेव करें पर क्लिक करें.
डेटा ऐक्सेस > स्कोप जोड़ें या हटाएं पर क्लिक करें. एक पैनल दिखता है. इसमें हर उस एपीआई के लिए स्कोप की सूची होती है जिसे आपने अपने Google Cloud प्रोजेक्ट में चालू किया है.
1. स्कोप मैन्युअल तरीके से जोड़ें में जाकर, उन एमसीपी सर्वर के स्कोप चिपकाएं जिनका इस्तेमाल करना है:
  - 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 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
  - People API:
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
2. टेबल में जोड़ें पर क्लिक करें.
3. अपडेट करें पर क्लिक करें.
4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर जाकर, सेव करें पर क्लिक करें.

एमसीपी क्लाइंट को कॉन्फ़िगर करना

Google Workspace के रिमोट एमसीपी सर्वर को अपने एमसीपी क्लाइंट में जोड़ने के लिए, अपने क्लाइंट के लिए दिए गए निर्देशों का पालन करें.

Gemini CLI

Google Workspace के रिमोट एमसीपी सर्वर को Gemini CLI में जोड़ने के लिए, सर्वर कॉन्फ़िगरेशन को अपनी settings.json फ़ाइल में जोड़ें.

OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:
1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं
  
  क्लाइंट बनाएं पर जाएं
2. ऐप्लिकेशन के टाइप के तौर पर, डेस्कटॉप ऐप्लिकेशन चुनें.
3. कोई नाम डालें.
4. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.
कॉन्फ़िगरेशन फ़ाइल ~/.gemini/settings.json खोलें या बनाएं.

settings.json में mcpServers कॉन्फ़िगरेशन जोड़ें:

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

इनकी जगह ये डालें:

OAUTH_CLIENT_ID: यह वह क्लाइंट आईडी है जिसे आपने बनाया है.
OAUTH_CLIENT_SECRET: आपके बनाए गए क्लाइंट सीक्रेट.

settings.json की बचत करें.
Gemini CLI शुरू करें:
```
gemini
```
Gemini CLI में, हर एमसीपी सर्वर के साथ पुष्टि करें. इसके लिए, यह कमांड चलाएं:
```
/mcp auth gmail
```
1. जब कहा जाए, तब अपने ब्राउज़र में पुष्टि करने वाला पेज खोलने के लिए, 1 दबाएं. अगर SSH पर काम किया जा रहा है, तो सीएलआई में दिए गए निर्देशों का पालन करें.
2. अपने Google खाते में साइन इन करें.
3. OAuth के लिए अनुरोध किए गए स्कोप की समीक्षा करें और अनुमति दें पर क्लिक करें.
4. आपको एक मैसेज दिखेगा, जिसमें पुष्टि की जाएगी कि पुष्टि करने की प्रोसेस पूरी हो गई है.
5. हर एमसीपी सर्वर के लिए, यह तरीका दोहराएं:
  - /mcp auth drive
  - /mcp auth calendar
  - /mcp auth people

कॉन्फ़िगर किए गए एमसीपी सर्वर और उनके टूल देखने के लिए, Gemini CLI में /mcp list चलाएं.

जवाब कुछ इस तरह का होगा:

🟢 gmail - Ready (9 tools)
  Tools:
  - create_draft
  - get_thread
  - label_message
  - label_thread
  - list_drafts
  - list_labels
  - search_threads
  - unlabel_message
  - unlabel_thread

🟢 drive - Ready (7 tools)
  Tools:
  - create_file
  - download_file_content
  - get_file_metadata
  - get_file_permissions
  - list_recent_files
  - read_file_content
  - search_files

🟢 calendar - Ready (8 tools)
  Tools:
  - create_event
  - delete_event
  - get_event
  - list_calendars
  - list_events
  - respond_to_event
  - suggest_time
  - update_event

🟢 people - Ready (3 tools)
  Tools:
  - get_user_profile
  - search_contacts
  - search_directory_people

रिमोट एमसीपी सर्वर का इस्तेमाल, Gemini CLI में किया जा सकता है.

Claude

Claude.ai या Claude Desktop के साथ Google Workspace के रिमोट एमसीपी सर्वर का इस्तेमाल करने के लिए, आपके पास Claude Enterprise, Pro, Max या Team प्लान होना चाहिए.

Google Workspace के रिमोट एमसीपी सर्वर को Claude में जोड़ने के लिए, OAuth क्लाइंट आईडी और सीक्रेट के साथ कस्टम कनेक्टर कॉन्फ़िगर करें.

OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:
1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं
  
  क्लाइंट बनाएं पर जाएं
2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.
3. कोई नाम डालें.
4. रीडायरेक्ट यूआरआई को अनुमति दें सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://claude.ai/api/mcp/auth_callback जोड़ें.
5. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.
Claude में एमसीपी सर्वर को कॉन्फ़िगर करें:
1. Claude.ai या Claude Desktop में, सेटिंग (या एडमिन सेटिंग) > कनेक्टर पर जाएं.
2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
3. आपको जिस Google Workspace प्रॉडक्ट को जोड़ना है उसके कनेक्शन की जानकारी डालें:
  - सर्वर का नाम: सर्वर का नाम, जैसे कि Gmail.
  - रिमोट एमसीपी सर्वर का यूआरएल: Google Workspace प्रॉडक्ट का यूआरएल. जैसे, इनमें से कोई एक:
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive: https://drivemcp.googleapis.com/mcp/v1
    - Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
4. ऐडवांस सेटिंग में जाकर, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
5. जोड़ें पर क्लिक करें.
6. Google Workspace के हर उस प्रॉडक्ट के लिए यह तरीका दोहराएं जिसे आपको जोड़ना है.

अन्य

कई एआई ऐप्लिकेशन में, रिमोट एमसीपी सर्वर से कनेक्ट करने के तरीके होते हैं. आम तौर पर, आपको सर्वर के बारे में जानकारी डालनी होती है. जैसे, उसका नाम, एंडपॉइंट, ट्रांसपोर्ट प्रोटोकॉल, और पुष्टि करने का तरीका. Google Workspace के रिमोट एमसीपी सर्वर के लिए, यह जानकारी डालें:

सर्वर का नाम: googleworkspace
सर्वर: Google Workspace के हर प्रॉडक्ट का अपना सर्वर यूआरएल होता है:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Google Drive: https://drivemcp.googleapis.com/mcp/v1
- Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
ट्रांसपोर्ट: एचटीटीपी
पुष्टि करना: Google Workspace का रिमोट एमसीपी सर्वर, OAuth 2.0 का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

अलग-अलग तरह के क्लाइंट कनेक्ट करने के बारे में ज़्यादा जानने के लिए, एआई ऐप्लिकेशन में एमसीपी कॉन्फ़िगर करना लेख पढ़ें.

Google Workspace MCP सर्वर की जांच करना

एमसीपी क्लाइंट को कॉन्फ़िगर करने के बाद, कनेक्शन की पुष्टि करने के लिए, कुछ टेस्ट प्रॉम्प्ट चलाए जा सकते हैं.

अपने एमसीपी क्लाइंट से ये सवाल पूछें:

"मैं कौन हूँ?"

क्लाइंट, आपकी Google Workspace प्रोफ़ाइल की जानकारी पाने के लिए people.get_user_profile का इस्तेमाल करता है.
"मार्केटिंग प्लान फ़ाइल की खास जानकारी दो."

क्लाइंट, "मार्केटिंग प्लान" का पता लगाने के लिए drive.search_files को कॉल करता है. इसके बाद, drive.read_file_content का इस्तेमाल करके, कॉन्टेंट को वापस पाता है और उसकी खास जानकारी देता है.
"एरिएल ने हमारे मार्केटिंग प्लान के बारे में अपने पिछले ईमेल में क्या कहा था?"

क्लाइंट, gmail.search_threads का इस्तेमाल करके, Ariel से मिले ईमेल को फ़िल्टर करता है. इसके बाद, gmail.get_thread का इस्तेमाल करके, थ्रेड का नया कॉन्टेंट वापस लाता है. इसके बाद, वह आपके लिए कॉन्टेंट की खास जानकारी तैयार करता है.
"ariel@example.com को एक ईमेल लिखो. इसमें लिखो कि मैंने मार्केटिंग प्लान को मंज़ूरी दे दी है."

क्लाइंट, gmail.create_draft का इस्तेमाल करके आपके ड्राफ़्ट फ़ोल्डर में एक ईमेल बनाता है. इससे आपको Gmail में जाकर, ईमेल की समीक्षा करने और उसे भेजने की सुविधा मिलती है.
"मेरी अगली मीटिंग एरियल के साथ कब है?"

क्लाइंट, calendar.list_events का इस्तेमाल करके आपका शेड्यूल देखता है. साथ ही, वह आपको एरियल के साथ होने वाली अगली मीटिंग के बारे में बताता है.

अगर टूल सही तरीके से काम करते हैं और आपको काम के जवाब मिलते हैं, तो इसका मतलब है कि आपके Google Workspace MCP सर्वर सही तरीके से कॉन्फ़िगर किए गए हैं.

समस्या का हल

अगर आपको एमसीपी सर्वर से कनेक्ट करने में समस्याएं आ रही हैं, तो OAuth लॉग में गड़बड़ियां देखें. अपने एडमिन से कहें कि वह सुरक्षा जांच टूल में OAuth लॉग इवेंट देखें.

सुविधा वाले प्रॉडक्ट

Google Workspace के इन प्रॉडक्ट में, Google Workspace MCP सर्वर काम करते हैं. साथ ही, इनमें ये टूल उपलब्ध हैं:

Gmail
- create_draft
- get_thread
- label_message
- label_thread
- list_drafts
- list_labels
- search_threads
- unlabel_message
- unlabel_thread
Google Drive
- create_file
- download_file_content
- get_file_metadata
- get_file_permissions
- list_recent_files
- read_file_content
- search_files
Google Calendar
- create_event
- delete_event
- get_event
- list_calendars
- list_events
- respond_to_event
- suggest_time
- update_event
People API
- get_user_profile
- search_contacts
- search_directory_people

सुरक्षा से जुड़ी अहम जानकारी: प्रॉम्प्ट इंजेक्शन का अप्रत्यक्ष तरीका

किसी भाषा मॉडल को ऐसे डेटा के संपर्क में लाने पर जिस पर भरोसा नहीं किया जा सकता, अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन अटैक का खतरा होता है. Gemini CLI जैसे MCP क्लाइंट के पास, Google Workspace MCP सर्वर के ज़रिए शक्तिशाली टूल और एपीआई का ऐक्सेस होता है. इसलिए, वे आपके Google खाते में मौजूद डेटा को पढ़ सकते हैं, उसमें बदलाव कर सकते हैं, और उसे मिटा सकते हैं.

इन जोखिमों को कम करने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं:

सिर्फ़ भरोसेमंद टूल का इस्तेमाल करें. Google Workspace के एमसीपी सर्वर को कभी भी ऐसे ऐप्लिकेशन से कनेक्ट न करें जिन पर भरोसा नहीं किया जा सकता या जिनकी पुष्टि नहीं हुई है.
गैर-भरोसेमंद इनपुट से सावधान रहें. अपने एमसीपी क्लाइंट से, बिना पुष्टि किए गए सोर्स से मिले ईमेल, दस्तावेज़ या अन्य संसाधनों को प्रोसेस करने के लिए न कहें. इन इनपुट में छिपे हुए निर्देश हो सकते हैं. इनकी वजह से, आपका सेशन हाइजैक हो सकता है. इससे हमलावर को आपके डेटा में बदलाव करने, उसे चुराने या मिटाने की अनुमति मिल जाती है.
सभी कार्रवाइयों की समीक्षा करें. हमेशा इस बात की सावधानीपूर्वक समीक्षा करें कि आपके एआई क्लाइंट ने आपकी ओर से कौनसी कार्रवाइयां की हैं. इससे यह पक्का किया जा सकेगा कि वे सही हैं और आपके इरादों के मुताबिक हैं.

ज़रूरी शर्तें

Cloud Shell

लोकल शेल

Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना

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

सीएलआई

कंसोल

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

सीएलआई

कंसोल

ऐसी स्क्रीन सेट अप करना जहां OAuth के लिए सहमति दी जाती है

एमसीपी क्लाइंट को कॉन्फ़िगर करना

Gemini CLI

Claude

अन्य

Google Workspace MCP सर्वर की जांच करना

समस्या का हल

सुविधा वाले प्रॉडक्ट

सुरक्षा से जुड़ी अहम जानकारी: प्रॉम्प्ट इंजेक्शन का अप्रत्यक्ष तरीका