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

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

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

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

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

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

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

Universal Search MCP Server का इस्तेमाल करने के लिए, अपने Google Cloud प्रोजेक्ट में Google Workspace MCP API को चालू करें:

सीएलआई

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

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

कंसोल

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

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

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

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

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

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

  • 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
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.memberships.readonly

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

हालांकि, अगर आपने 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, https://www.googleapis.com/auth/chat.spaces.readonly, और https://www.googleapis.com/auth/chat.memberships.readonly को ऐक्सेस दिया है, तो यूनिवर्सल सर्च की सुविधा सिर्फ़ Google Drive, Google Calendar, और Google Chat के नतीजे दिखाती है. यह आपके ईमेल नहीं खोजता और न ही Gmail के नतीजे दिखाता है.

  1. Google Cloud Console में, Google Auth Platform > डेटा ऐक्सेस पर जाएं.
  2. Add or Remove Scopes पर क्लिक करें.

  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
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly

    https://www.googleapis.com/auth/chat.spaces.readonly और https://www.googleapis.com/auth/chat.memberships.readonly को शामिल करें, ताकि सर्वर यह बता सके कि Google Chat की हर बातचीत में कौन-कौन शामिल है. इनके बिना, Google Chat के नतीजों को संगठन से बाहर शेयर किया गया माना जाता है. साथ ही, हो सकता है कि उपयोगकर्ता को पुष्टि करनी पड़े या नतीजों को फ़िल्टर कर दिया जाए.

  4. अपडेट करें और फिर सेव करें पर क्लिक करें.

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

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

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

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

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

    {
  "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 User Settings खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में जाकर, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में workspace-universal ढूंढें और पुष्टि करें पर क्लिक करें. इसके बाद, अपने Google खाते में साइन इन करें और अनुमति कोड को कॉपी करें. फिर, उसे इनपुट डायलॉग में चिपकाएं और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

    • Antigravity IDE या जीयूआई के लिए: Customizations > Installed MCP Servers में जाकर, workspace-universal के बगल में मौजूद साइन आउट करें बटन पर क्लिक करें.
    • Antigravity CLI के लिए: कॉन्फ़िगर किए गए एमसीपी सर्वर देखने के लिए, /mcp पैनल खोलें. पुष्टि किए गए सर्वर के नाम के बगल में, इंटरैक्टिव टीयूआई पैनल में पुष्टि की गई दिखता है. डैशबोर्ड व्यू में जाकर, 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, https://www.googleapis.com/auth/chat.spaces.readonly, और https://www.googleapis.com/auth/chat.memberships.readonly शामिल करें.

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

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

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

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

इस्तेमाल किए जा सकने वाले टूल

Universal Search MCP Server में यह टूल उपलब्ध है. इनपुट और आउटपुट स्कीमा के लिए, Universal Search MCP का रेफ़रंस देखें.

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