People API के एमसीपी सर्वर को कॉन्फ़िगर करना

People API, रिमोट मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर उपलब्ध कराता है. इसकी मदद से एआई एजेंट, Google Workspace की प्रोफ़ाइल और संपर्क डेटा के साथ सुरक्षित तरीके से इंटरैक्ट कर सकते हैं. People API के एमसीपी सर्वर को कॉन्फ़िगर करके, Google Antigravity और Claude जैसे एआई ऐप्लिकेशन को People API का इस्तेमाल करके कार्रवाइयां करने की अनुमति दी जा सकती है.

People API का एमसीपी सर्वर, एआई एजेंट को एक स्टैंडर्ड तरीका उपलब्ध कराता है. इससे एआई एजेंट ये काम कर सकते हैं:

  • डेटा पढ़ना: उपयोगकर्ता की प्रोफ़ाइलें वापस पाना और संपर्क या डायरेक्ट्री में मौजूद लोगों को खोजना.
  • सुरक्षा का ध्यान रखना: उपयोगकर्ता के पास मौजूद अनुमतियों और डेटा को मैनेज करने के कंट्रोल का इस्तेमाल करना.

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

People API के एमसीपी सर्वर को कॉन्फ़िगर करना

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

एपीआई और एमसीपी सेवा चालू करना

People API के एमसीपी सर्वर का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट में यह सेवा चालू करनी होगी:

  • People API

सीएलआई

gcloud services enable people.googleapis.com --project=PROJECT_ID

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

कंसोल

Google Cloud Console में जाकर, इन एपीआई को चालू करें:

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

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

  1. Google Cloud Console में, Google Auth Platform > ब्रैंडिंग पर जाएं.

    ब्रैंडिंग पर जाएं

  2. अगर आपने Google Auth Platform को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth के लिए सहमति वाली स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको यह मैसेज दिखता है कि Google Auth Platform को अभी तक कॉन्फ़िगर नहीं किया गया है, तो शुरू करें पर क्लिक करें:

    1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में People API MCP Server टाइप करें.
    2. उपयोगकर्ता सहायता के लिए ईमेल पता में, अपना ईमेल पता या कोई सही Google ग्रुप चुनें.
    3. आगे बढ़ें पर क्लिक करें.
    4. दर्शक में जाकर, इंटरनल चुनें. अगर संगठन के अंदर विकल्प नहीं चुना जा सकता, तो संगठन के बाहर विकल्प चुनें.
    5. आगे बढ़ें पर क्लिक करें.
    6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में होने वाले किसी भी बदलाव की सूचना मिल सके.
    7. आगे बढ़ें पर क्लिक करें.
    8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
    9. जारी रखें पर क्लिक करें.
    10. बनाएं पर क्लिक करें.
    11. अगर आपने उपयोगकर्ता के टाइप के लिए बाहरी चुना है, तो टेस्ट करने वाले उपयोगकर्ताओं को जोड़ें:
      1. ऑडियंस पर क्लिक करें.
      2. टेस्ट ऐप्लिकेशन इस्तेमाल करने वाले लोग में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
      3. अपना ईमेल पता और टेस्ट करने वाले अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, सेव करें पर क्लिक करें.

  3. डेटा का ऐक्सेस > स्कोप जोड़ें या हटाएं पर क्लिक करें. एक पैनल दिखता है. इसमें, हर उस एपीआई के स्कोप की सूची होती है जिसे आपने अपने Google Cloud प्रोजेक्ट में चालू किया है.

    1. स्कोप मैन्युअल तरीके से जोड़ें में जाकर, People API MCP सर्वर के लिए स्कोप चिपकाएं:

      • https://www.googleapis.com/auth/directory.readonly
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/contacts.readonly

    2. टेबल में जोड़ें पर क्लिक करें.

    3. अपडेट करें पर क्लिक करें.

    4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर जाकर, सेव करें पर क्लिक करें.

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

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

Antigravity

Antigravity में People API का रिमोट एमसीपी सर्वर जोड़ने के लिए, अपनी 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. mcp_config.json में mcpServers कॉन्फ़िगरेशन जोड़ें:

    {
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.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. सूची में people ढूंढें. इसके बाद, पुष्टि करें पर क्लिक करें, अपने Google खाते में साइन इन करें, अनुमति देने का कोड कॉपी करें, इसे इनपुट डायलॉग में चिपकाएं, और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

रिमोट एमसीपी सर्वर, Antigravity में इस्तेमाल के लिए तैयार है.

Claude

Claude.ai या Claude Desktop के साथ People API के रिमोट एमसीपी सर्वर का इस्तेमाल करने के लिए, आपके पास Claude Enterprise, Pro, Max या Team प्लान होना चाहिए.

Claude में People API का रिमोट एमसीपी सर्वर जोड़ने के लिए, 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 (या Admin settings) > Connectors पर जाएं.
    2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
    3. People API प्रॉडक्ट के लिए, कनेक्शन की जानकारी डालें:
      • सर्वर का नाम: people.
      • रिमोट एमसीपी सर्वर का यूआरएल: https://people.googleapis.com/mcp/v1
    4. ऐडवांस सेटिंग में जाकर, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
    5. जोड़ें पर क्लिक करें.

अन्य

कई एआई ऐप्लिकेशन में, रिमोट एमसीपी सर्वर से कनेक्ट करने के तरीके होते हैं. आम तौर पर, आपको सर्वर के बारे में जानकारी डालनी होती है. जैसे, उसका नाम, एंडपॉइंट, ट्रांसपोर्ट प्रोटोकॉल, और पुष्टि करने का तरीका. People API के रिमोट एमसीपी सर्वर के लिए, यह जानकारी डालें:

अलग-अलग तरह के क्लाइंट कनेक्ट करने के बारे में ज़्यादा जानने के लिए, एआई ऐप्लिकेशन में एमसीपी कॉन्फ़िगर करना लेख पढ़ें.

People API के एमसीपी सर्वर को टेस्ट करना

एमसीपी क्लाइंट को कॉन्फ़िगर करने के बाद, कुछ टेस्ट प्रॉम्प्ट चलाकर कनेक्शन की पुष्टि की जा सकती है.

अपने एमसीपी क्लाइंट से ये सवाल पूछें:

  • "मेरी Google प्रोफ़ाइल के मुताबिक, मेरा नाम क्या है?"

    क्लाइंट, people.get_user_profile का इस्तेमाल करके आपकी Google Workspace प्रोफ़ाइल की जानकारी को वापस पाने के लिए करता है.

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

समस्या का हल

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

टूल का रेफ़रंस

People API के एमसीपी सर्वर के लिए, ये टूल उपलब्ध हैं:

  • get_user_profile
  • search_contacts
  • search_directory_people

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

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

इन जोखिमों को कम करने के लिए, आपको नुकसान पहुंचाने वाले कॉन्टेंट या प्रॉम्प्ट इंजेक्शन अटैक के लिए, प्रॉम्प्ट और जवाबों की जांच करनी चाहिए. Google की ओर से उपलब्ध कराए गए Model Armor का इस्तेमाल किया जा सकता है. इसके अलावा, अगर आपने अपने समाधान का दस्तावेज़ बनाया है, तो उसका इस्तेमाल किया जा सकता है. इससे उपयोगकर्ता जोखिम को स्वीकार कर पाएंगे. ज़्यादा जानकारी के लिए, Google Workspace के एमसीपी सर्वर के लिए सुरक्षा कॉन्फ़िगर करना लेख पढ़ें.

इन सबसे सही तरीकों को अपनाएं:

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