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

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

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

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

यूनिवर्सल सर्च के एमसीपी सर्वर को कॉन्फ़िगर करना

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

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

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

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

  • Google Workspace MCP API

सीएलआई

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 Console में जाकर, इन एपीआई को चालू करें:

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

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

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

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

यूनिवर्सल सर्च एमसीपी सर्वर, 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 Console में, 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. अपडेट करें पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

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

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

अपने एमसीपी क्लाइंट में 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/antigravity/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 या GUI (Antigravity 2.0) के लिए:

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

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

    • Antigravity IDE या GUI के लिए: कस्टमाइज़ेशन > इंस्टॉल किए गए एमसीपी सर्वर में जाकर, 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 शामिल करें.

यूनिवर्सल सर्च एमसीपी सर्वर की जांच करना

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

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

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

इन टूल के साथ काम करता है

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

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