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 खाते में जानकारी खोजने का एक स्टैंडर्ड तरीका उपलब्ध कराता है. इसके लिए, उन्हें हर प्रॉडक्ट के लिए अलग-अलग टूल इस्तेमाल करने की ज़रूरत नहीं पड़ती.

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

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

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

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

Universal Search MCP सर्वर का इस्तेमाल करने के लिए, अपने 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

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 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
  4. अपडेट करें पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

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

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

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

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 या GUI (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 पैनल खोलें. पुष्टि किए गए सर्वर के नाम के बगल में, इंटरैक्टिव टीयूआई पैनल में पुष्टि की गई दिखता है. डैशबोर्ड व्यू में जाकर, 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) में खोज करता है.