Developer Knowledge एमसीपी सर्वर से कनेक्ट करना

Google Developer Knowledge MCP सर्वर, एआई की मदद से काम करने वाले डेवलपमेंट टूल को Google के आधिकारिक डेवलपर दस्तावेज़ों को खोजने की सुविधा देता है. साथ ही, Firebase, Google Cloud, Android, Maps वगैरह जैसे Google के प्रॉडक्ट के लिए जानकारी पाने की सुविधा देता है. अपने एआई ऐप्लिकेशन को सीधे तौर पर दस्तावेज़ों की हमारी आधिकारिक लाइब्रेरी से कनेक्ट करने पर, आपको मिलने वाला कोड और दिशा-निर्देश अप-टू-डेट होते हैं. साथ ही, वे भरोसेमंद कॉन्टेक्स्ट पर आधारित होते हैं.

सर्वर सेट अप करने के बाद, इंटिग्रेट किए गए टूल इन जैसे अनुरोधों में आपकी मदद कर सकते हैं:

  • लागू करने के लिए सलाह

    • उदाहरण के लिए: Android ऐप्लिकेशन में, Firebase Cloud Messaging का इस्तेमाल करके पुश नोटिफ़िकेशन लागू करने का सबसे अच्छा तरीका क्या है?

  • कोड जनरेट करना और उसके बारे में जानकारी देना

    • उदाहरण के लिए: Cloud Storage प्रोजेक्ट में मौजूद सभी बकेट की सूची बनाने के लिए, Google के दस्तावेज़ में Python का उदाहरण खोजो.

  • समस्या हल करना और डीबग करना

    • उदाहरण के लिए: मेरी Google Maps API कुंजी पर 'यह सिर्फ़ डेवलेपमेंट के लिए है' वॉटरमार्क क्यों दिख रहा है?

  • तुलनात्मक विश्लेषण और खास जानकारी

    • उदाहरण के लिए: नई माइक्रोसेवा के लिए, Cloud Run और Cloud Functions में से किसी एक को चुनने में मेरी मदद करो. एक Markdown टेबल बनाएं. इसमें मुख्य पहलुओं की तुलना की गई हो. जैसे, इस्तेमाल का मुख्य उदाहरण, एक साथ कई लोगों के इस्तेमाल करने की सुविधा, और कीमत का मॉडल.

एमसीपी सर्वर की सुविधाएं

Google Developer Knowledge का एमसीपी सर्वर, आपके एआई ऐप्लिकेशन को ये टूल उपलब्ध कराता है:

टूल का नाम ब्यौरा
search_documents यह Google के डेवलपर दस्तावेज़ (Firebase, Google Cloud, Android, Maps वगैरह) खोजता है, ताकि आपकी क्वेरी के लिए काम के पेज और स्निपेट मिल सकें. पूरे पेज का कॉन्टेंट पाने के लिए, खोज के नतीजों में मौजूद parent के साथ get_documents का इस्तेमाल करें.
get_documents यह फ़ंक्शन, search_documents के नतीजों से मिले parent का इस्तेमाल करके, कई दस्तावेज़ों का पूरा कॉन्टेंट हासिल करता है.
answer_query (प्रीव्यू) यह सुविधा, डेवलपर के लिए उपलब्ध जानकारी के कॉर्पस का इस्तेमाल करके, जवाब जनरेट करती है.

search_documents टूल, दस्तावेज़ को टेक्स्ट के छोटे-छोटे हिस्सों में बांटता है. इन हिस्सों को एआई की मदद से खोज करने और जानकारी पाने के लिए ऑप्टिमाइज़ किया जाता है. खोज करने पर, यह टूल आपकी क्वेरी से जुड़े एक या उससे ज़्यादा दस्तावेज़ स्निपेट दिखाता है. अगर आपको स्निपेट के आस-पास मौजूद पूरे पेज का कॉन्टेंट देखना है, तो पूरे पेज का कॉन्टेंट पाने के लिए, खोज के नतीजों में दिए गए parent के साथ get_documents का इस्तेमाल करें.

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

इंस्टॉल करना

Google Developer Knowledge एमसीपी सर्वर, एक रिमोट एमसीपी सर्वर है. यह दस्तावेज़ों को खोजने और उन्हें वापस पाने के लिए, Developer Knowledge API का इस्तेमाल करता है. OAuth या एपीआई पासकोड का इस्तेमाल करके पुष्टि की जा सकती है.

OAuth का इस्तेमाल करके पुष्टि करना

इस सेक्शन में, OAuth का इस्तेमाल करके, डेवलपर नॉलेज एमसीपी सर्वर के साथ अपने एआई ऐप्लिकेशन की पुष्टि करने की प्रोसेस के बारे में बताया गया है.

ज़रूरी शर्तें: Google Cloud CLI सेट अप करना

आगे बढ़ने से पहले, पक्का करें कि आपके पास ये चीज़ें हैं:

पहला चरण: किसी प्रोजेक्ट में Developer Knowledge API चालू करना

  1. Google APIs लाइब्रेरी में, Developer Knowledge API पेज खोलें.
  2. देख लें कि आपने वह सही प्रोजेक्ट चुना हो जिसमें आपको एपीआई का इस्तेमाल करना है.
  3. चालू करें पर क्लिक करें. एपीआई को चालू करने या इस्तेमाल करने के लिए, IAM की किसी खास भूमिका की ज़रूरत नहीं होती.

दूसरा चरण: पुष्टि करने का तरीका चुनें

आपने पुष्टि करने का जो तरीका चुना है वह इस बात पर निर्भर करता है कि आपका एआई असिस्टेंट, gcloud CLI का इस्तेमाल करके ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) के साथ काम करता है या उसे स्टैंडअलोन OAuth क्लाइंट आईडी की ज़रूरत होती है. Gemini CLI जैसे असिस्टेंट, आसानी से सेटअप करने के लिए आपके मौजूदा Google Cloud लॉगिन का इस्तेमाल कर सकते हैं. वहीं, Antigravity जैसे अन्य असिस्टेंट के लिए, आपको सुरक्षित कनेक्शन बनाने के लिए, अपने क्रेडेंशियल मैन्युअल तरीके से बनाने और देने होंगे.

उस टैब को चुनें जो आपके एआई असिस्टेंट के सेटअप से जुड़ी खास ज़रूरी शर्तों के बारे में बताता है.

ADC

अपना खाता कनेक्ट करें

  1. एमसीपी सर्वर को आपकी ओर से कार्रवाई करने की अनुमति देने के लिए, नीचे दिए गए कमांड को चलाएं. साथ ही, PROJECT_ID की जगह Google Cloud प्रोजेक्ट का अपना आईडी डालें:

    gcloud auth application-default login
--project=PROJECT_ID

  2. जब कहा जाए, तब कोई खाता चुनें. इसके बाद, जारी रखें पर क्लिक करें.

अपने एआई ऐप्लिकेशन को कॉन्फ़िगर करना

पुष्टि हो जाने के बाद, आखिरी चरण में अपने एआई ऐप्लिकेशन को सर्वर कॉन्फ़िगरेशन की जानकारी देनी होती है. हालांकि, JSON का सटीक स्ट्रक्चर हर ऐप्लिकेशन के हिसाब से अलग-अलग होता है, लेकिन यहां दिए गए उदाहरण का इस्तेमाल टेंप्लेट के तौर पर किया जा सकता है.

  1. Gemini CLI या Gemini Code Assist को कॉन्फ़िगर करने के लिए, इनमें से किसी एक कॉन्फ़िगरेशन फ़ाइल में बदलाव करें या उसे बनाएं:

    • अपने प्रोजेक्ट में: .gemini/settings.json
    • अपनी होम डायरेक्ट्री में: ~/.gemini/settings.json
    {
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
     },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

    यह देखने के लिए कि एमसीपी सर्वर उम्मीद के मुताबिक काम कर रहा है या नहीं, इंस्टॉलेशन की पुष्टि करें पर जाएं.

मैन्युअल क्रेडेंशियल

उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है

प्रोजेक्ट की उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है. साथ ही, खुद को टेस्टर के तौर पर जोड़ें. अगर आपने अपने Google Cloud प्रोजेक्ट के लिए यह चरण पहले ही पूरा कर लिया है, तो अगले चरण पर जाएं.

  1. Google Cloud Console के पुष्टि करने की सुविधा की खास जानकारी वाला पेज खोलें और शुरू करें पर क्लिक करें.
  2. ऐप्लिकेशन का नाम डालें, सहायता के लिए ईमेल पता चुनें, और आगे बढ़ें पर क्लिक करें.
  3. दर्शक में जाकर, बाहरी को चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
  4. संपर्क जानकारी में अपना ईमेल पता डालें. इसके बाद, आगे बढ़ें पर क्लिक करें.
  5. Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति पढ़ें और उससे सहमत हों. इसके बाद, जारी रखें पर क्लिक करें.
  6. बनाएं पर क्लिक करें.

टेस्ट यूज़र जोड़ना

  1. Google Auth Platform में, Audience पर क्लिक करें.
  2. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
  3. अपना ईमेल पता और टेस्ट करने वाले अन्य ज़्यादाृत उपयोगकर्ताओं का ईमेल पता डालें. इसके बाद, सेव करें पर क्लिक करें.

OAuth क्लाइंट बनाना

असली उपयोगकर्ता के तौर पर पुष्टि करने और अपने ऐप्लिकेशन में उपयोगकर्ता का डेटा ऐक्सेस करने के लिए, आपको OAuth 2.0 क्लाइंट आईडी बनाने होंगे. क्लाइंट आईडी का इस्तेमाल, Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए किया जाता है.

  1. Google Auth Platform में, क्लाइंट पर क्लिक करें.
  2. क्लाइंट खाता बनाएं पर क्लिक करें.
  3. ऐप्लिकेशन टाइप सिलेक्टर से, डेस्कटॉप ऐप्लिकेशन चुनें.
  4. नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
  5. बनाएं पर क्लिक करें. OAuth क्लाइंट बनाने की स्क्रीन दिखेगी. इसमें आपको नया क्लाइंट आईडी और क्लाइंट सीक्रेट दिखेगा.
  6. ठीक है पर क्लिक करें. नया क्रेडेंशियल, OAuth 2.0 क्लाइंट आईडी में दिखता है.
  7. हाल ही में बनाए गए क्लाइंट आईडी पर क्लिक करें. क्लाइंट सीक्रेट सेक्शन में जाकर, JSON फ़ाइल सेव करने के लिए, डाउनलोड आइकॉन पर क्लिक करें. इस फ़ाइल में मौजूद client_id और client_secret वैल्यू का इस्तेमाल, अगले चरण में किया जाएगा.

अपने एआई ऐप्लिकेशन को कॉन्फ़िगर करना

इसके बाद, आपको अपने एआई ऐप्लिकेशन को सर्वर कॉन्फ़िगरेशन की जानकारी देनी होगी. हालांकि, हर ऐप्लिकेशन के लिए चरणों का क्रम अलग-अलग होता है, लेकिन यहां दिए गए उदाहरण को टेंप्लेट के तौर पर इस्तेमाल किया जा सकता है.

एमसीपी सर्वर का इस्तेमाल करने के लिए, Antigravity को कॉन्फ़िगर करने के लिए:

  1. Antigravity में, एजेंट पैन में मौजूद ज़्यादा विकल्प मेन्यू पर क्लिक करें > एमसीपी सर्वर > एमसीपी सर्वर मैनेज करें.

  2. एमसीपी सर्वर मैनेज करें पैनल में सबसे ऊपर, mcp_config.json फ़ाइल में बदलाव करने के लिए, रॉ कॉन्फ़िगरेशन देखें पर क्लिक करें:

    {
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}

  3. एमसीपी सर्वर मैनेज करें पर वापस जाएं और रीफ़्रेश करें पर क्लिक करें.

OAuth क्रेडेंशियल जोड़ना

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

  1. एजेंट से, Developer Knowledge एमसीपी सर्वर का इस्तेमाल करने के लिए कहें. इसके लिए, इस तरह का प्रॉम्प्ट दें:

    How do I list Cloud Storage buckets?

  2. अगर आपको एक या उससे ज़्यादा रीडायरेक्ट यूआरआई रजिस्टर करने के लिए कहा जाता है, तो आगे बढ़ने के लिए विकल्प पर क्लिक करें. आपने क्लाइंट आईडी को डेस्कटॉप ऐप्लिकेशन के तौर पर सेट अप किया है. इसलिए, Google Auth Platform में इन यूआरआई को जोड़ने की ज़रूरत नहीं है.

  3. जब आपका एआई असिस्टेंट आपसे क्लाइंट आईडी और क्लाइंट सीक्रेट मांगे, तब क्लाइंट सीक्रेट JSON फ़ाइल में सेव की गई हर कुंजी को चिपकाएं. इस फ़ाइल को आपने पहले सेव किया था.

  4. जब कहा जाए, तब कोई खाता चुनें. इसके बाद, जारी रखें पर क्लिक करें.

  5. अपने एआई असिस्टेंट पर वापस जाएं. अब एजेंट, पुष्टि किए गए नए सर्वर का इस्तेमाल करके आपके अनुरोध को प्रोसेस करेगा.

एपीआई पासकोड का इस्तेमाल करके पुष्टि करना

इस सेक्शन में, एपीआई पासकोड का इस्तेमाल करके, डेवलपर नॉलेज एमसीपी सर्वर के साथ अपने एआई ऐप्लिकेशन की पुष्टि करने की प्रोसेस के बारे में बताया गया है.

पहला चरण: एपीआई पासकोड बनाना

Google Cloud console या gcloud CLI का इस्तेमाल करके, अपने Google Cloud प्रोजेक्ट में Developer Knowledge API पासकोड जनरेट किया जा सकता है:

Google Cloud Console

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

  1. Google APIs लाइब्रेरी में, Developer Knowledge API पेज खोलें.
  2. देख लें कि आपने वह सही प्रोजेक्ट चुना हो जिसमें आपको एपीआई का इस्तेमाल करना है.
  3. चालू करें पर क्लिक करें. एपीआई को चालू करने या इस्तेमाल करने के लिए, IAM की किसी खास भूमिका की ज़रूरत नहीं होती.

एपीआई पासकोड बनाना और उसे सुरक्षित करना

  1. जिस प्रोजेक्ट के लिए आपने एपीआई चालू किया है उसके Google Cloud Console में, क्रेडेंशियल पेज पर जाएं.
  2. क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, मेन्यू से एपीआई पासकोड चुनें.
  3. नाम फ़ील्ड में, कुंजी का नाम डालें.
  4. एपीआई इस्तेमाल करने से जुड़ी पाबंदियां चुनें ड्रॉप-डाउन पर क्लिक करें. इसके बाद, Developer Knowledge API टाइप करें. नतीजे पर क्लिक करें. इसके बाद, ठीक है पर क्लिक करें.
    • ध्यान दें: अगर आपने अभी-अभी Developer Knowledge API चालू किया है, तो हो सकता है कि यह सूची में दिखने में कुछ समय ले. कुछ मिनट बाद फिर से कोशिश करें.
  5. बनाएं पर क्लिक करें.

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

gcloud सीएलआई

  1. अगर आपने अब तक ऐसा नहीं किया है, तो gcloud सीएलआई डाउनलोड और इंस्टॉल करें.

  2. Developer Knowledge API चालू करें. इसके लिए, PROJECT_ID को अपने Google Cloud प्रोजेक्ट आईडी से बदलें:

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

  3. उसी Google Cloud प्रोजेक्ट आईडी का इस्तेमाल करके, एक एपीआई पासकोड बनाएं:

    gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"

    इस कमांड से दो वैल्यू मिलती हैं. इनके बारे में आपको पता होना चाहिए:

  4. एपीआई पासकोड को Developer Knowledge API के लिए सीमित करें. इसके लिए, KEY_NAME को पासकोड के नाम से बदलें. उदाहरण के लिए, projects/my-project/locations/global/keys/12345-67890:

    gcloud services api-keys update KEY_NAME --api-target=service=developerknowledge.googleapis.com

दूसरा चरण: किसी प्रोजेक्ट में डेवलपर नॉलेज एमसीपी सर्वर चालू करना

अपने Google Cloud प्रोजेक्ट में Developer Knowledge MCP सर्वर को चालू करने के लिए, gcloud CLI डाउनलोड और इंस्टॉल करें. इसके बाद, यह कमांड चलाएं. इसमें PROJECT_ID की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

अगर आपके Google Cloud प्रोजेक्ट के लिए Developer Knowledge सेवा चालू नहीं है, तो रिमोट एमसीपी सर्वर को चालू करने से पहले, आपको इस सेवा को चालू करने के लिए कहा जाएगा.

सुरक्षा के लिहाज़ से हमारा सुझाव है कि आप एमसीपी सर्वर को सिर्फ़ उन सेवाओं के लिए चालू करें जिनकी ज़रूरत आपके एआई ऐप्लिकेशन को काम करने के लिए होती है.

तीसरा चरण: एआई ऐप्लिकेशन को कॉन्फ़िगर करना

इन निर्देशों का इस्तेमाल करके, लोकप्रिय एआई ऐप्लिकेशन कॉन्फ़िगर करें. पिछले चरण में जनरेट की गई Developer Knowledge API (एपीआई) कुंजी से YOUR_API_KEY को बदलें:

Gemini CLI

Gemini CLI को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

इसके अलावा, इनमें से किसी कॉन्फ़िगरेशन फ़ाइल में बदलाव करें या नई फ़ाइल बनाएं:

  • अपने प्रोजेक्ट में: .gemini/settings.json
  • अपनी होम डायरेक्ट्री में: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Gemini Code Assist को कॉन्फ़िगर करने के लिए, इनमें से किसी एक कॉन्फ़िगरेशन फ़ाइल में बदलाव करें या उसे बनाएं:

  • अपने प्रोजेक्ट में: .gemini/settings.json
  • अपनी होम डायरेक्ट्री में: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Claude Code को कॉन्फ़िगर करने के लिए, अपने ऐप्लिकेशन फ़ोल्डर में जाकर यह निर्देश चलाएं.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

कर्सर

कर्सर को कॉन्फ़िगर करने के लिए, .cursor/mcp.json (किसी खास प्रोजेक्ट के लिए) या ~/.cursor/mcp.json (सभी प्रोजेक्ट के लिए) में से किसी एक में बदलाव करें.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

किसी एक प्रोजेक्ट के लिए VS Code में GitHub Copilot को कॉन्फ़िगर करने के लिए, अपने वर्कस्पेस में मौजूद .vscode/mcp.json फ़ाइल में बदलाव करें.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

सर्वर को हर प्रोजेक्ट में उपलब्ध कराने के लिए, अपनी उपयोगकर्ता सेटिंग में बदलाव करें. सेटिंग (JSON) खोलें बटन पर क्लिक करें.

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

विंडसर्फ़

Windsurf Editor को कॉन्फ़िगर करने के लिए, ~/.codeium/windsurf/mcp_config.jsonफ़ाइल में बदलाव करें.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

इंस्टॉल हो जाने की पुष्टि करें

कॉन्फ़िगर हो जाने के बाद, एआई ऐप्लिकेशन खोलें और कोई प्रॉम्प्ट डालें. जैसे:

How do I list Cloud Storage buckets?

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

टोकन के इस्तेमाल को मैनेज करना

दस्तावेज़ का कॉन्टेंट वापस पाने के लिए, आपके एआई ऐप्लिकेशन की कॉन्टेक्स्ट विंडो में मौजूद टोकन खर्च होते हैं. ऐसा खास तौर पर तब होता है, जब batch_get_documents का इस्तेमाल किया जा रहा हो. Google के डेवलपर दस्तावेज़ के कुछ पेज काफ़ी बड़े होते हैं. इसलिए, कई दस्तावेज़ों को फ़ेच करने से, लागत तेज़ी से बढ़ सकती है, मॉडल के जवाब देने में ज़्यादा समय लग सकता है, और कॉन्टेक्स्ट विंडो ओवरफ़्लो हो सकती है.

परफ़ॉर्मेंस को ऑप्टिमाइज़ करने और अचानक मिलने वाले बिल से बचने के लिए, ऐसे खास प्रॉम्प्ट बनाएं जिनमें सिर्फ़ वह जानकारी शामिल हो जिसकी आपको ज़रूरत है. ऐसे सामान्य अनुरोध न करें (उदाहरण के लिए, "सभी Firebase प्रॉडक्ट की तुलना करें"), जिनसे एजेंट को एक बार में बहुत ज़्यादा डेटा प्रोसेस करना पड़े.

शामिल किए गए दस्तावेज़

सर्वर किन दस्तावेज़ों में खोज करता है, इस बारे में जानने के लिए कॉर्पस रेफ़रंस देखें.

सीमाएं

  • कॉन्टेंट का दायरा: इसमें सिर्फ़ वे पेज शामिल होते हैं जो कॉर्पस के रेफ़रंस पर सार्वजनिक तौर पर दिखते हैं. इसमें GitHub, ओएसएस साइटों, ब्लॉग या YouTube जैसे अन्य सोर्स से मिला कॉन्टेंट शामिल नहीं है.
  • सिर्फ़ अंग्रेज़ी में नतीजे: सर्वर सिर्फ़ अंग्रेज़ी में नतीजे दिखाता है.
  • नेटवर्क पर निर्भर: सर्वर के टूल, Google Cloud की लाइव सेवाओं पर निर्भर होते हैं. अगर आपको लगातार गड़बड़ियों का सामना करना पड़ रहा है, तो अपने इंटरनेट कनेक्शन और Developer Knowledge API की कॉन्फ़िगरेशन की जांच करें.

सुरक्षा से जुड़े वैकल्पिक कॉन्फ़िगरेशन

एमसीपी टूल से कई तरह की कार्रवाइयां की जा सकती हैं. इसलिए, एमसीपी से सुरक्षा से जुड़े नए जोखिम और समस्याएं पैदा हो सकती हैं. इन जोखिमों को कम करने और मैनेज करने के लिए, Google Cloud डिफ़ॉल्ट सेटिंग और ज़रूरत के मुताबिक बनाई जा सकने वाली नीतियां उपलब्ध कराता है. इनकी मदद से, Google Cloud संगठन या प्रोजेक्ट में एमसीपी टूल के इस्तेमाल को कंट्रोल किया जा सकता है.

एमसीपी की सुरक्षा और गवर्नेंस के बारे में ज़्यादा जानने के लिए, एआई की सुरक्षा और बचाव लेख पढ़ें.

Model Armor का इस्तेमाल करना

Model Armor, Google Cloud की एक सेवा है. इसे आपके एआई ऐप्लिकेशन की सुरक्षा और संरक्षा को बेहतर बनाने के लिए डिज़ाइन किया गया है. यह टूल, एलएलएम के प्रॉम्प्ट और जवाबों की पहले से ही जांच करता है. इससे कई तरह के जोखिमों से सुरक्षा मिलती है और रिस्पॉन्सिबल एआई के सिद्धांतों का पालन करने में मदद मिलती है. चाहे आपको अपने क्लाउड एनवायरमेंट में एआई को डिप्लॉय करना हो या बाहरी क्लाउड सेवा देने वाली कंपनियों के साथ, Model Armor आपकी मदद कर सकता है. इससे आपको नुकसान पहुंचाने वाले इनपुट को रोकने, कॉन्टेंट की सुरक्षा की पुष्टि करने, संवेदनशील डेटा को सुरक्षित रखने, नियमों का पालन करने, और एआई की सुरक्षा से जुड़ी नीतियों को लागू करने में मदद मिलती है. साथ ही, यह एआई से जुड़े अलग-अलग कामों में लगातार आपकी मदद करता है.

लॉगिंग की सुविधा चालू होने पर, Model Armor की सुविधा चालू होने पर, Model Armor पूरे पेलोड को लॉग करता है. इससे आपके लॉग में मौजूद संवेदनशील जानकारी का पता चल सकता है.

Model Armor की सुविधा चालू करना

Model Armor को चालू करने के लिए, Google और Google Cloud के एमसीपी सर्वर के साथ इंटिग्रेट करना में दिया गया तरीका अपनाएं.

Google और Google Cloud के रिमोट एमसीपी सर्वर के लिए सुरक्षा कॉन्फ़िगर करना

एमसीपी टूल कॉल और जवाबों को सुरक्षित रखने के लिए, Model Armor की फ़्लोर सेटिंग का इस्तेमाल किया जा सकता है. फ़्लोर सेटिंग से, कम से कम उन सुरक्षा फ़िल्टर के बारे में पता चलता है जो पूरे प्रोजेक्ट पर लागू होते हैं. इस कॉन्फ़िगरेशन से, प्रोजेक्ट में एमसीपी टूल के सभी कॉल और जवाबों पर एक जैसे फ़िल्टर लागू होते हैं.

एमसीपी सैनिटाइज़ेशन की सुविधा चालू करके, Model Armor के लिए फ़्लोर सेटिंग सेट अप करें. ज़्यादा जानकारी के लिए, Model Armor की फ़्लोर सेटिंग कॉन्फ़िगर करना लेख पढ़ें.

कमांड का यह उदाहरण देखें:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें.

इन सेटिंग के बारे में ध्यान दें:

  • INSPECT_AND_BLOCK: यह नीति उल्लंघन ठीक करने का एक तरीका है. यह Google MCP सर्वर के लिए कॉन्टेंट की जांच करता है. साथ ही, फ़िल्टर से मेल खाने वाले प्रॉम्प्ट और जवाबों को ब्लॉक करता है.
  • ENABLED: यह सेटिंग, फ़िल्टर या पाबंदी लागू करने की सुविधा चालू करती है.
  • MEDIUM_AND_ABOVE: यह 'ज़िम्मेदारी के साथ एआई का इस्तेमाल' सिद्धांत के तहत, खतरनाक कॉन्टेंट को फ़िल्टर करने की सेटिंग का कॉन्फ़िडेंस लेवल है. इस सेटिंग में बदलाव किया जा सकता है. हालांकि, कम वैल्यू सेट करने पर, फ़ॉल्स पॉज़िटिव के ज़्यादा मामले सामने आ सकते हैं. ज़्यादा जानकारी के लिए, Model Armor के कॉन्फ़िडेंस लेवल देखें.

Model Armor की मदद से, एमसीपी ट्रैफ़िक को स्कैन करने की सुविधा बंद करना

प्रोजेक्ट की फ़्लोर सेटिंग के आधार पर, Google MCP सर्वर से आने-जाने वाले ट्रैफ़िक को अपने-आप स्कैन करने से Model Armor को रोकने के लिए, यह कमांड चलाएं:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

PROJECT_ID की जगह प्रोजेक्ट आईडी डालें. Model Armor, इस प्रोजेक्ट की फ़्लोर सेटिंग में तय किए गए नियमों को Google MCP सर्वर के किसी भी ट्रैफ़िक पर अपने-आप लागू नहीं करता है.

मॉडल आर्मर की फ़्लोर सेटिंग और सामान्य कॉन्फ़िगरेशन से, सिर्फ़ एमसीपी पर ही असर नहीं पड़ता. Model Armor, Vertex AI जैसी सेवाओं के साथ इंटिग्रेट होता है. इसलिए, फ़्लोर सेटिंग में किए गए किसी भी बदलाव का असर, इंटिग्रेट की गई सभी सेवाओं पर पड़ सकता है. जैसे, ट्रैफ़िक स्कैनिंग और सुरक्षा से जुड़ी सेटिंग पर. इसका असर सिर्फ़ एमसीपी पर नहीं पड़ता.

मॉडल आर्मर की सेटिंग में बदलाव करना

अगर आपने अपने ऐप्लिकेशन को सुरक्षित रखने के लिए Model Armor का इस्तेमाल किया है, तो आपको कुछ क्वेरी के लिए 403 PERMISSION_DENIED गड़बड़ियां दिख सकती हैं. डेवलपर नॉलेज एमसीपी सर्वर, सिर्फ़ भरोसेमंद Google सोर्स से सार्वजनिक दस्तावेज़ दिखाता है. इसलिए, हमारा सुझाव है कि प्रॉम्प्ट इंजेक्शन और जेलब्रेक (पीआईजेबी) फ़िल्टर को HIGH_AND_ABOVE कॉन्फ़िडेंस लेवल पर सेट करें, ताकि गलत पॉज़िटिव की संख्या कम हो सके. अगर आपके इस्तेमाल के उदाहरण में ऐसे अन्य टूल शामिल नहीं हैं जो निजी या संवेदनशील डेटा को ऐक्सेस करते हैं, तो PIJB फ़िल्टर बंद किए जा सकते हैं.

समस्या का हल

अगर आपको कोई समस्या आती है, तो पुष्टि करें कि: