Workspace के लिए Universal Search MCP Server की मदद से, एआई एजेंट को Workspace में खोजने की अनुमति देना

Google Workspace के लिए, Universal Search MCP Server, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) स्टैंडर्ड का इस्तेमाल करता है. इससे एआई एजेंट, आपके Workspace के आर्टफ़ैक्ट खोज सकते हैं. इस सर्वर की मदद से, एक ही टूल का इस्तेमाल करके Google Workspace के कई प्रॉडक्ट में खोज की जा सकती है. इनमें Gmail मैसेज, Google Drive फ़ाइलें, Google Calendar इवेंट, और Google Chat के स्पेस और मैसेज शामिल हैं.

Universal Search MCP Server, एआई एजेंट को आपके पूरे Google Workspace खाते में जानकारी खोजने का एक स्टैंडर्ड तरीका उपलब्ध कराता है. इसके लिए, प्रॉडक्ट के हिसाब से अलग-अलग टूल को कॉल करने की ज़रूरत नहीं होती.

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

  • एक Google Cloud प्रोजेक्ट. प्रोजेक्ट बनाने के लिए, प्रोजेक्ट बनाना लेख पढ़ें.

  • एक एमसीपी क्लाइंट, जैसे कि Google Antigravity.

  • इस पेज पर दिए गए कमांड चलाने के लिए, इनमें से किसी एक डेवलपमेंट एनवायरमेंट में gcloud सीएलआई सेट अप करें:

    Cloud Shell

    gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell को चालू करें:

    Cloud Shell चालू करें

    लोकल शेल

    लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

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

Universal Search MCP Server को कॉन्फ़िगर करना

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

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

Universal Search MCP Server का इस्तेमाल करने के लिए, अपने Google Cloud प्रोजेक्ट में Google Workspace MCP API और उन प्रॉडक्ट के एपीआई चालू करें जिनमें आपको खोज करनी है:

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • Google Workspace MCP API

CLI

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

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

कंसोल

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

एपीआई चालू करें

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

अगर आपने अन्य एमसीपी सर्वर के लिए, OAuth को सहमति देने वाली स्क्रीन पहले से कॉन्फ़िगर की है, तो पक्का करें कि आपने Universal Search MCP Server के लिए ज़रूरी स्कोप जोड़े हों.

Universal Search MCP Server से पुष्टि करते समय, आपके पास अनुरोध किए गए सभी स्कोप या सिर्फ़ कुछ स्कोप की पुष्टि करने का विकल्प होता है. सर्वर इन विकल्पों का पालन करता है और सिर्फ़ उन प्रॉडक्ट में खोज करता है जिनके लिए ऐक्सेस दिया गया है.

उदाहरण के लिए, अगर आपने इन सभी स्कोप से पुष्टि की है:

  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/chat.messages.readonly

Universal Search MCP Server, Gmail, Google Drive, Google Calendar, और Google Chat में खोज करेगा.

हालांकि, अगर आपने सिर्फ़ https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, और https://www.googleapis.com/auth/chat.messages.readonly को ऐक्सेस करने की अनुमति दी है (और https://www.googleapis.com/auth/gmail.readonly को छोड़ दिया है), तो यूनिवर्सल सर्च के नतीजे सिर्फ़ Google Drive, Google Calendar, और Google Chat से मिलेंगे. यह आपके ईमेल में खोज नहीं करेगा और Gmail के नतीजे नहीं दिखाएगा.

  1. Google Cloud कंसोल में, Google Auth Platform > डेटा ऐक्सेस पर जाएं.
  2. स्कोप जोड़ें या हटाएं पर क्लिक करें.

  3. इनमें से एक या ज़्यादा स्कोप जोड़ें:

    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/drive.readonly
    • https://www.googleapis.com/auth/calendar.readonly
    • https://www.googleapis.com/auth/chat.messages.readonly

  4. अपडेट करें पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है सेट अप करने के बारे में ज़्यादा जानने के लिए, Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना लेख पढ़ें.

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

अपने एमसीपी क्लाइंट में Universal Search MCP Server जोड़ने के लिए, अपने क्लाइंट के लिए दिए गए निर्देशों का पालन करें.

Antigravity

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

  1. वेब ऐप्लिकेशन टाइप का OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं. ऑथराइज़्ड रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, https://antigravity.google/oauth-callback को यूआरआई फ़ील्ड में जोड़ें. निर्देशों के लिए, Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना लेख पढ़ें.

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

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

    {
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.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 या जीयूआई (Antigravity 2.0) के लिए:

      1. सेटिंग स्क्रीन खोलें. जैसे, सबसे नीचे बाईं ओर मौजूद सेटिंग पर क्लिक करें या Antigravity की उपयोगकर्ता सेटिंग खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में workspace-universal ढूंढें. इसके बाद, पुष्टि करें पर क्लिक करें. अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, इसे इनपुट डायलॉग में चिपकाएं, और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

      3. ऐरो की का इस्तेमाल करके workspace-universal चुनें. इसके बाद, पुष्टि करें ऐक्शन पर जाएं और Enter दबाएं. अपने ब्राउज़र में साइन-इन की प्रोसेस पूरी करें, ऑथराइज़ेशन कोड कॉपी करें, इसे टर्मिनल प्रॉम्प्ट में चिपकाएं, और Enter दबाएं.

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

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

Claude

Claude में Universal Search MCP Server जोड़ने के लिए, कस्टम कनेक्टर कॉन्फ़िगर करें.

  1. वेब ऐप्लिकेशन टाइप का OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं. निर्देशों के लिए, Google Workspace के एमसीपी सर्वर कॉन्फ़िगर करना लेख पढ़ें.

  2. Claude की सेटिंग में, कस्टम कनेक्टर जोड़ें:

    • सर्वर का नाम: Universal Search MCP Server
    • रिमोट एमसीपी सर्वर का यूआरएल: https://workspacemcp.googleapis.com/mcp/v1
    • OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट: अपने क्रेडेंशियल डालें.
    • स्कोप: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, और https://www.googleapis.com/auth/chat.messages.readonly शामिल करें.

Universal Search MCP Server की जांच करना

अपने एमसीपी क्लाइंट से ऐसे सवाल पूछें जिनके लिए अलग-अलग प्रॉडक्ट में खोज करनी पड़े:

  • "मेरे ईमेल, दस्तावेज़ों, और चैट मैसेज में, प्रोजेक्ट X से जुड़ी कोई भी चीज़ ढूंढो."
  • "मार्केटिंग प्लान के बारे में मेरी अगली मीटिंग कब है? साथ ही, इस बारे में मेरे पास मौजूद सबसे नए नोट और चैट मैसेज कौनसे हैं?"

अगर टूल सही तरीके से काम करते हैं और आपको कई प्रॉडक्ट से काम के जवाब मिलते हैं, तो आपका Universal Search MCP Server सही तरीके से कॉन्फ़िगर किया गया है.

इन टूल पर पासकी का इस्तेमाल किया जा सकता है

Universal Search MCP Server, यह टूल उपलब्ध कराता है:

  • search_corpus: दी गई क्वेरी के आधार पर, Google Workspace के कई प्रॉडक्ट (Google Drive, Gmail, Google Calendar, और Google Chat) में खोज करता है.