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. चैट ऐप्लिकेशन सेट अप करें:

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

  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
        • https://www.googleapis.com/auth/chat.users.spacesettings
      • 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 के रिमोट एमसीपी सर्वर जोड़ने के लिए, अपने क्लाइंट के लिए दिए गए निर्देशों का पालन करें.

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

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. mcpServers कॉन्फ़िगरेशन को mcp_config.json में जोड़ें:

    {
  "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 या जीयूआई के लिए: Customizations > Installed MCP Servers में जाकर, हर सर्वर के बगल में साइन आउट करें बटन दिखता है.
    • Antigravity CLI के लिए: कॉन्फ़िगर किए गए एमसीपी सर्वर देखने के लिए, /mcp पैनल खोलें. जिन सर्वर की पुष्टि हो चुकी है उनके नाम के बगल में, इंटरैक्टिव टीयूआई पैनल में Authed दिखता है. डैशबोर्ड व्यू में जाकर, किसी भी सर्वर को चुना जा सकता है. इससे उसकी स्थिति देखी जा सकती है और उसमें उपलब्ध सभी टूल की सूची देखी जा सकती है.

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 > Connectors या 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 Developers के लाइव और आधिकारिक दस्तावेज़ों को खोजता है. इनमें developers.google.com/workspace भी शामिल है. इससे आपका एआई एजेंट, सिर्फ़ अपने ट्रेनिंग डेटा पर निर्भर रहने के बजाय, मौजूदा एपीआई के तरीकों, OAuth के स्कोप, और कोड सैंपल को खोज सकता है. यह सर्वर search_documents, get_documents, और answer_query टूल उपलब्ध कराता है. साथ ही, यह Google Workspace के एमसीपी सर्वर के साथ काम करता है. इससे आपका एजेंट, Google Workspace के डेटा पर कार्रवाई कर पाता है. इनके साथ Developer Knowledge MCP सर्वर जोड़ने से, आपके एजेंट को Google Workspace API का इस्तेमाल करके ऐप्लिकेशन बनाने से जुड़े सवालों के जवाब देने में मदद मिलती है. इसके लिए, वह मौजूदा दस्तावेज़ों का इस्तेमाल करता है.

इस सर्वर को अपने एआई ऐप्लिकेशन में जोड़ने के लिए, अपना आईडीई या कोडिंग एजेंट कॉन्फ़िगर करें और अपना क्लाइंट चुनें. अपने एजेंट को यह तय करने में मदद करें कि उसे दस्तावेज़ों को कब खोजना है और किस टूल का इस्तेमाल करना है. इसके लिए, retrieving-developer-knowledge एजेंट स्किल भी इंस्टॉल करें.

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 ऐप्लिकेशन में पोस्ट किया जा सकता है.

  • "Gmail create_draft टूल के लिए ज़रूरी OAuth स्कोप के बारे में जानने के लिए, Google Workspace के आधिकारिक दस्तावेज़ देखें. इसके बाद, ariel@example.com को एक ईमेल ड्राफ़्ट करके, मार्केटिंग प्लान की पुष्टि करें."

    अगर आपने डेवलपर नॉलेज एमसीपी सर्वर जोड़ा है, तो क्लाइंट Gmail एमसीपी रेफ़रंस दस्तावेज़ में स्कोप ढूंढने के लिए, search_documents को कॉल करता है. इसके बाद, ड्राफ़्ट बनाने के लिए gmail.create_draft का इस्तेमाल करता है.

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

समस्या का हल

Google Workspace के एमसीपी सर्वर से जुड़ी, पुष्टि करने और कनेक्शन की सामान्य समस्याओं को हल करने के लिए, यहां दिए गए सेक्शन देखें.

OAuth के लॉग इवेंट देखना

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

उपयोगकर्ता के असाइन किए गए OAuth क्लाइंट से मिले अनुरोधों को अस्वीकार किया गया

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

  • मौजूदा क्लाइंट, सेटिंग के साथ काम करता है: अपने मौजूदा OAuth क्लाइंट पर, इस क्लाइंट का इस्तेमाल एआई की मदद से काम करने वाले एजेंट के लिए करें को चुनें.
  • मौजूदा क्लाइंट को अपडेट नहीं किया जा सकता: एआई की मदद से काम करने वाले एजेंट के लिए इस क्लाइंट का इस्तेमाल करें को चुनकर, नया OAuth क्लाइंट बनाएं. इसके बाद, इसका इस्तेमाल करने के लिए अपने ऐप्लिकेशन को अपडेट करें.
  • मौजूदा क्लाइंट, नॉन-एजेंट सुविधाओं के साथ भी काम करता है: एआई एजेंट के लिए एक अलग OAuth क्लाइंट बनाएं और मौजूदा क्लाइंट को नॉन-एजेंट सुविधाओं के लिए इस्तेमाल करें.

निर्देशों के लिए, अपना एमसीपी क्लाइंट कॉन्फ़िगर करना और OAuth क्लाइंट मैनेज करना लेख पढ़ें.

डोमेन के सभी उपयोगकर्ताओं के डेटा का ऐक्सेस देने वाले सेवा खाते

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

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

Apps Script से मिले अनुरोध

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

Apps Script से एमसीपी सर्वर को कॉल करने के लिए, यह तरीका अपनाएं:

  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 शामिल हो. सिर्फ़ ओआईडीसी offline_access स्कोप का अनुरोध करने पर, यह टोकन नहीं मिलता.

देखें कि आपका एमसीपी क्लाइंट, अनुमति देने के लिए कस्टम पैरामीटर के साथ काम करता है या नहीं:

  • क्लाइंट, अनुमति देने के लिए कस्टम पैरामीटर का इस्तेमाल करता है: अनुमति देने के अनुरोध में access_type=offline जोड़ें. जिस उपयोगकर्ता को पहले ही ऐक्सेस दिया जा चुका है उसके लिए नया रीफ़्रेश टोकन पाने के लिए, prompt=consent भी जोड़ें.
  • क्लाइंट, कस्टम ऑथराइज़ेशन पैरामीटर के साथ काम नहीं करता: ऐक्सेस टोकन की समयसीमा खत्म होने पर, हर बार फिर से साइन इन करें.

ज़्यादा जानकारी के लिए, ऐक्सेस टोकन को रीफ़्रेश करना लेख पढ़ें.

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

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

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

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

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

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