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

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

Google Workspace के एमसीपी सर्वर, एआई एजेंट को एक स्टैंडर्ड तरीका उपलब्ध कराते हैं, ताकि वे:

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

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

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

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

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

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

  • Gmail API
  • Google Drive API
  • Google Docs API
  • Google Sheets API
  • Google Slides API
  • Google Calendar API
  • Google Chat API
  • People API

  • Google Classroom API

सीएलआई

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

PROJECT_ID को अपने Google Cloud प्रोजेक्ट आईडी से बदलें.

कंसोल

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

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

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

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

  • Gmail MCP API
  • Google Drive MCP API
  • Google Docs MCP API
  • Google Sheets MCP API
  • Google Slides MCP API
  • Google Calendar MCP API
  • Google Chat MCP API
  • People MCP API

  • Google Classroom MCP API

सीएलआई

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

PROJECT_ID को अपने Google Cloud प्रोजेक्ट आईडी से बदलें.

कंसोल

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

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

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

Google Chat के एमसीपी सर्वर का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में Chat ऐप्लिकेशन को कॉन्फ़िगर करना होगा.

  1. Google Cloud Console में, Google Chat API खोजें. इसके बाद, Google Chat API > मैनेज करें > कॉन्फ़िगरेशन पर क्लिक करें.

    Google Chat API पर जाएं

  2. Chat ऐप्लिकेशन सेट अप करें:

    1. ऐप्लिकेशन का नाम फ़ील्ड में, Chat MCP डालें.
    2. अवतार यूआरएल फ़ील्ड में, https://developers.google.com/chat/images/quickstart-app-avatar.png डालें.
    3. Description में, Chat MCP server डालें.
    4. फ़ंक्शन में जाकर, इंटरैक्टिव सुविधाएं चालू करें को टॉगल करके, इंटरैक्टिव सुविधाएं बंद करें.
    5. लॉग में जाकर, लॉगिंग में गड़बड़ियों को लॉग करें को चुनें.

  3. सेव करें पर क्लिक करें.

चैट ऐप्लिकेशन बनाने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन का आर्किटेक्चर चुनना लेख पढ़ें.

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

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

    ब्रैंडिंग पर जाएं

  2. अगर आपने 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. अपना ईमेल पता और टेस्ट करने वाले अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, सेव करें पर क्लिक करें.

  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 Docs:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • Google Sheets:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • Google Slides:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • 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.messages.create
        • https://www.googleapis.com/auth/chat.users.readstate
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly

    2. टेबल में जोड़ें पर क्लिक करें.

    3. अपडेट करें पर क्लिक करें.

    4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर, सेव करें पर क्लिक करें.

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

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

Antigravity

Antigravity में Google Workspace के रिमोट एमसीपी सर्वर जोड़ने के लिए, सर्वर कॉन्फ़िगरेशन को अपनी mcp_config.json फ़ाइल में जोड़ें. ये निर्देश Antigravity 2.0, Antigravity IDE, और Antigravity CLI पर लागू होते हैं.

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं

      'क्लाइंट बनाएं' पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. अनुमति वाले रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://antigravity.google/oauth-callback जोड़ें.

    5. एआई की मदद से काम करने वाले एजेंट के लिए, इस क्लाइंट का इस्तेमाल करें को चुनें.

    6. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  2. कॉन्फ़िगरेशन फ़ाइल ~/.gemini/config/mcp_config.json खोलें या बनाएं.

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

    {
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

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

    • OAUTH_CLIENT_ID: आपका बनाया गया क्लाइंट आईडी.
    • OAUTH_CLIENT_SECRET: आपका बनाया गया क्लाइंट सीक्रेट.

  4. mcp_config.json की बचत करें.

  5. एमसीपी सर्वर की पुष्टि करें. जीयूआई सेटिंग या सीएलआई का इस्तेमाल करके, पुष्टि की जा सकती है:

    • Antigravity IDE या GUI (Antigravity 2.0) के लिए:

      1. सेटिंग स्क्रीन खोलें. उदाहरण के लिए, सबसे नीचे बाईं ओर मौजूद सेटिंग पर क्लिक करें या Antigravity User Settings खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में दिए गए हर सर्वर (gmail, drive, docs, sheets, slides, calendar, chat, people, और classroom) के लिए, पुष्टि करें पर क्लिक करें. इसके बाद, अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, उसे इनपुट डायलॉग में चिपकाएं, और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

      1. Antigravity CLI को शुरू करें:

        agy

      2. इंटरैक्टिव एमसीपी मैनेजमेंट पैनल खोलने के लिए, यह कमांड चलाएं:

        /mcp

      3. हर एमसीपी सर्वर की पुष्टि करें:

        1. सर्वर चुनने के लिए, ऐरो बटन का इस्तेमाल करें. इसके बाद, Authenticate कार्रवाई पर जाएं और Enter दबाएं. अपने ब्राउज़र में साइन-इन की प्रोसेस पूरी करें. इसके बाद, ऑथराइज़ेशन कोड को कॉपी करके टर्मिनल प्रॉम्प्ट में चिपकाएं और Enter दबाएं.
        2. आपने जिन सर्वर को कॉन्फ़िगर किया है उनके लिए, यह तरीका दोहराएं (gmail, drive, docs, sheets, slides, calendar, chat, people, और classroom).

  6. पुष्टि करें कि सर्वर सही तरीके से कॉन्फ़िगर किए गए हैं और काम कर रहे हैं:

    • Antigravity IDE या जीयूआई के लिए: पसंद के मुताबिक़ बनाएँ > इंस्टॉल किए गए एमसीपी सर्वर में जाकर, हर सर्वर के बगल में साइन आउट करें बटन दिखता है.
    • Antigravity CLI के लिए: कॉन्फ़िगर किए गए एमसीपी सर्वर देखने के लिए, /mcp पैनल खोलें. जिन सर्वर की पुष्टि हो चुकी है उनके नाम के बगल में, इंटरैक्टिव टीयूआई पैनल में पुष्टि हो चुकी है दिखता है. डैशबोर्ड व्यू में जाकर, किसी भी सर्वर को चुना जा सकता है. इससे उसकी स्थिति देखी जा सकती है और उसमें उपलब्ध सभी टूल की सूची देखी जा सकती है.

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

Claude

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

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

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud Console में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं

      'क्लाइंट बनाएं' पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. अनुमति वाले रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://claude.ai/api/mcp/auth_callback जोड़ें.

    5. एआई की मदद से काम करने वाले एजेंट के लिए, इस क्लाइंट का इस्तेमाल करें को चुनें.

    6. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  2. Claude में एमसीपी सर्वर को कॉन्फ़िगर करें:

    1. Claude.ai या Claude Desktop में, Settings (या Admin settings) > Connectors पर जाएं.
    2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.

    3. Google Workspace के जिस प्रॉडक्ट को जोड़ना है उसके लिए कनेक्शन की जानकारी डालें:

      • सर्वर का नाम: सर्वर का नाम, जैसे कि Gmail.
      • रिमोट एमसीपी सर्वर का यूआरएल: Google Workspace के प्रॉडक्ट का यूआरएल, जैसे कि इनमें से कोई एक:
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google Drive: https://drivemcp.googleapis.com/mcp/v1
        • Google Docs: https://docsmcp.googleapis.com/mcp/v1
        • Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
        • Google Slides: https://slidesmcp.googleapis.com/mcp/v1
        • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • Google Classroom: https://classroommcp.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 Docs: https://docsmcp.googleapis.com/mcp/v1
    • Google Sheets: https://sheetsmcp.googleapis.com/mcp/v1
    • Google Slides: https://slidesmcp.googleapis.com/mcp/v1
    • Google Calendar: https://calendarmcp.googleapis.com/mcp/v1
    • Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • People API: https://people.googleapis.com/mcp/v1
    • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

  • ट्रांसपोर्ट: स्ट्रीम किया जा सकने वाला एचटीटीपी

  • पुष्टि करना: Google Workspace का रिमोट एमसीपी सर्वर, OAuth 2.0 का इस्तेमाल करता है. OAuth 2.0 क्लाइंट बनाते समय, इस क्लाइंट का इस्तेमाल एआई की मदद से काम करने वाले एजेंट के लिए करें को चुनें. ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने के बारे में जानें लेख पढ़ें.

    आपके एमसीपी क्लाइंट को रीफ़्रेश टोकन की ज़रूरत होती है, ताकि उपयोगकर्ताओं को हर घंटे फिर से साइन इन न करना पड़े. Google का OAuth 2.0 सर्वर, रीफ़्रेश टोकन सिर्फ़ तब जारी करता है, जब अनुमति के अनुरोध में access_type=offline शामिल हो. सिर्फ़ OpenID Connect (OIDC) offline_access स्कोप का अनुरोध करने पर, आईडी टोकन नहीं मिलता. अगर आपका एमसीपी क्लाइंट, कस्टम ऑथराइज़ेशन पैरामीटर के साथ काम करता है, तो ऑथराइज़ेशन के अनुरोध में access_type=offline जोड़ें. जिस उपयोगकर्ता ने पहले ही ऐक्सेस दे दिया है उसके लिए नया रीफ़्रेश टोकन पाने के लिए, prompt=consent भी जोड़ें. अगर आपका एमसीपी क्लाइंट, कस्टम ऑथराइज़ेशन पैरामीटर के साथ काम नहीं करता है, तो ऐक्सेस टोकन की समयसीमा खत्म होने पर, उपयोगकर्ताओं को हर बार फिर से साइन इन करना होगा. ज़्यादा जानकारी के लिए, ऐक्सेस टोकन रीफ़्रेश करना लेख पढ़ें.

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

Google Workspace के एमसीपी सर्वर की जांच करना

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

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

  • "आरती ने अपने पिछले ईमेल में हमारे मार्केटिंग प्लान के बारे में क्या कहा था?"

    क्लाइंट, gmail.search_threads का इस्तेमाल करके, Ariel से मिले ईमेल फ़िल्टर करता है. इसके बाद, gmail.get_thread का इस्तेमाल करके, सबसे नई थ्रेड का कॉन्टेंट हासिल करता है और फिर आपके लिए उसकी खास जानकारी तैयार करता है.

  • "ariel@example.com को भेजने के लिए एक ईमेल का ड्राफ़्ट बनाओ. इसमें बताओ कि मैंने मार्केटिंग प्लान को मंज़ूरी दे दी है."

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

  • "मार्केटिंग प्लान फ़ाइल की खास जानकारी दो."

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

  • "मुझे Google Docs में मीटिंग के नोट का स्ट्रक्चर दिखाओ."

    क्लाइंट, docs.read_doc का इस्तेमाल करके दस्तावेज़ का स्ट्रक्चर और कॉन्टेंट फ़ेच करता है.

  • "Google Sheets में मौजूद Quarterly Sales स्प्रेडशीट की Sheet1 शीट पढ़ो."

    क्लाइंट, sheets.get_values का इस्तेमाल करके ग्रिड वैल्यू फ़ेच करता है.

  • "मुझे Google Slides प्रज़ेंटेशन 'प्रॉडक्ट की खास जानकारी' का बोलकर बताया गया लेआउट दिखाओ."

    क्लाइंट, slides.read_presentation का इस्तेमाल करके प्रज़ेंटेशन के विज़ुअल लेआउट स्ट्रक्चर फ़ेच करता है.

  • "एरियल के साथ मेरी अगली मीटिंग कब है?"

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

  • "मेरी Google प्रोफ़ाइल के मुताबिक, मेरा नाम क्या है?"

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

  • "फ़िलहाल, मैं कौनसी क्लास पढ़ा रहा/रही हूं?"

    क्लाइंट, classroom.list_course_summaries का इस्तेमाल करके आपका शेड्यूल देखता है और उन ऐक्टिव कोर्स की खास जानकारी देता है जिनमें आपकी भूमिका शिक्षक की है.

  • "मेरी जियोलॉजी क्लास के लिए, आने वाली फ़ील्ड ट्रिप के बारे में सूचना का ड्राफ़्ट तैयार करो."

    क्लाइंट, सूचना का ड्राफ़्ट तैयार करने के लिए classroom.create_announcement का इस्तेमाल करता है. इस सूचना की समीक्षा करके, इसे Google Classroom ऐप्लिकेशन में पोस्ट किया जा सकता है.

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

समस्या का हल

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

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

अगर आपका ऐप्लिकेशन, डोमेन-वाइड डेलिगेशन वाले सेवा खाते का इस्तेमाल करता है, तो उसके लिए एआई की मदद से काम करने वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को नहीं चुना जा सकता. ऐसा इसलिए, क्योंकि सेवा खातों को Google Auth Platform > क्लाइंट में मैनेज नहीं किया जाता. डोमेन-वाइड डेलिगेशन का इस्तेमाल करने वाले सेवा खातों से एमसीपी सर्वर को किए गए अनुरोधों को इस वजह से अस्वीकार नहीं किया जाता है. ऐक्सेस को डोमेन-वाइड डेलिगेशन सेटिंग से कंट्रोल किया जाता है. इन्हें आपका Google Workspace एडमिन मैनेज करता है. ज़्यादा जानकारी के लिए, पूरे डोमेन के लोगों को डेटा का ऐक्सेस देकर, एपीआई ऐक्सेस को कंट्रोल करना लेख पढ़ें.

अगर Google Apps Script से एमसीपी सर्वर पर अनुरोध भेजे जाते हैं, तो Apps Script आपकी स्क्रिप्ट के लिए एक डिफ़ॉल्ट OAuth क्लाइंट बनाता है और उसे मैनेज करता है. हालांकि, इसके लिए इस क्लाइंट का इस्तेमाल एआई की मदद से काम करने वाले एजेंट के लिए करें को नहीं चुना जा सकता. यह शर्त तब भी लागू होती है, जब आपकी स्क्रिप्ट में स्टैंडर्ड Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा हो. इसके बजाय, यह तरीका अपनाएं:

  1. Google Cloud Console में, Google Auth Platform > क्लाइंट पर जाएं. इसके बाद, OAuth क्लाइंट बनाएं और एआई की मदद से काम करने वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को चुनें.
  2. अपनी स्क्रिप्ट में, Apps Script लाइब्रेरी के लिए OAuth2 का इस्तेमाल करें, ताकि उस OAuth क्लाइंट की मदद से उपयोगकर्ताओं को अनुमति दी जा सके.
  3. एमसीपी सर्वर को कॉल करते समय, ScriptApp.getOAuthToken से मिले टोकन के बजाय, लाइब्रेरी से मिला ऐक्सेस टोकन भेजें.

Apps Script के ऐसे प्रोजेक्ट जो एमसीपी सर्वर को कॉल नहीं करते हैं उन पर कोई असर नहीं पड़ेगा.

अगर आपको हर घंटे फिर से साइन इन करने के लिए कहा जाता है, तो इसका मतलब है कि आपके एमसीपी क्लाइंट को रीफ़्रेश टोकन नहीं मिल रहा है. Google का OAuth 2.0 सर्वर, रीफ़्रेश टोकन सिर्फ़ तब जारी करता है, जब अनुमति के अनुरोध में access_type=offline शामिल हो. सिर्फ़ OpenID Connect (OIDC) offline_access स्कोप का अनुरोध करने पर, यह नहीं दिखता. अगर आपका एमसीपी क्लाइंट, कस्टम ऑथराइज़ेशन पैरामीटर के साथ काम करता है, तो ऑथराइज़ेशन के अनुरोध में access_type=offline जोड़ें. जिस उपयोगकर्ता को पहले ही ऐक्सेस दिया जा चुका है उसके लिए नया रीफ़्रेश टोकन पाने के लिए, prompt=consent भी जोड़ें. अगर आपका एमसीपी क्लाइंट, कस्टम ऑथराइज़ेशन पैरामीटर के साथ काम नहीं करता है, तो ऐक्सेस टोकन की समयसीमा खत्म होने पर आपको हर बार फिर से साइन इन करना होगा. ज़्यादा जानकारी के लिए, ऐक्सेस टोकन रीफ़्रेश करना लेख पढ़ें.

इस्तेमाल किए जा सकने वाले प्रॉडक्ट

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

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

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

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

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