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

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

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

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

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

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

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

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

People API MCP सर्वर का इस्तेमाल करने के लिए, आपको अपने 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. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें. अगर Internal को नहीं चुना जा सकता, तो External को चुनें.
    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 > Clients > Create Client पर जाएं

      क्लाइंट बनाएं पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. रीडाइरेक्ट करने के लिए अनुमति वाले यूआरआई सेक्शन में जाकर, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://antigravity.google/oauth-callback जोड़ें.

    5. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  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 चुनें. इसके बाद, Authenticate ऐक्शन पर जाएं और Enter दबाएं. अपने ब्राउज़र में साइन इन करने की प्रोसेस पूरी करें. इसके बाद, ऑथराइज़ेशन कोड को कॉपी करें और उसे टर्मिनल प्रॉम्प्ट में चिपकाएं. इसके बाद, Enter दबाएं.

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

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

रिमोट एमसीपी सर्वर, 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 > Clients > Create Client पर जाएं

      क्लाइंट बनाएं पर जाएं

    2. ऐप्लिकेशन टाइप के तौर पर, वेब ऐप्लिकेशन चुनें.

    3. कोई नाम डालें.

    4. रीडाइरेक्ट करने के लिए अनुमति वाले यूआरआई सेक्शन में जाकर, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, यूआरआई फ़ील्ड में https://claude.ai/api/mcp/auth_callback जोड़ें.

    5. बनाएं पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट कॉपी करें.

  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 के एमसीपी सर्वर को ऐसे ऐप्लिकेशन से कभी कनेक्ट न करें जिन पर भरोसा नहीं किया जा सकता या जिनकी पुष्टि नहीं हुई है.
  • गैर-भरोसेमंद इनपुट से सावधान रहें. अपने एमसीपी क्लाइंट से, बिना पुष्टि किए गए स्रोतों से मिले संसाधनों को प्रोसेस करने के लिए न कहें. इन इनपुट में छिपे हुए निर्देश हो सकते हैं. इनसे आपका सेशन हाइजैक किया जा सकता है. इससे हमलावर को आपके डेटा में बदलाव करने, उसे चुराने या मिटाने की अनुमति मिल जाती है.
  • सभी कार्रवाइयों की समीक्षा करें. हमेशा इस बात की सावधानीपूर्वक समीक्षा करें कि आपके एआई क्लाइंट ने आपकी ओर से कौनसी कार्रवाइयां की हैं. इससे यह पक्का किया जा सकेगा कि वे सही हैं और आपके इरादों के मुताबिक हैं.