Android Management API के एमसीपी सर्वर का इस्तेमाल करना

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) यह तय करता है कि लार्ज लैंग्वेज मॉडल (एलएलएम) और एआई ऐप्लिकेशन या एजेंट, बाहरी डेटा सोर्स से कैसे कनेक्ट होंगे. एमसीपी सर्वर की मदद से, उनके टूल, संसाधनों, और प्रॉम्प्ट का इस्तेमाल किया जा सकता है. इससे कार्रवाइयाँ की जा सकती हैं और उनकी बैकएंड सेवा से अपडेट किया गया डेटा पाया जा सकता है.

लोकल और रिमोट एमसीपी सर्वर में क्या अंतर है?

लोकल एमसीपी सर्वर

आम तौर पर, इन्हें आपकी लोकल मशीन पर चलाया जाता है. साथ ही, ये एक ही डिवाइस पर मौजूद सेवाओं के बीच कम्यूनिकेशन के लिए, स्टैंडर्ड इनपुट और आउटपुट स्ट्रीम (stdio) का इस्तेमाल करते हैं.

रिमोट एमसीपी सर्वर

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

स्टेटलेस कोर

एमसीपी वर्शन 2026-07-28 के साथ, एमसीपी को दोतरफ़ा और स्टेटफ़ुल प्रोटोकॉल से स्टेटलेस प्रोटोकॉल में बदल दिया गया है. हर एमसीपी अनुरोध में, अनुरोध के बारे में पूरी जानकारी होती है. साथ ही, इसे हेडर का इस्तेमाल करके रूट किया जा सकता है. initialize/initialized हैंडशेक या Mcp-Session-Id की ज़रूरत नहीं होती, क्योंकि हर अनुरोध में एचटीटीपी हेडर या _meta पैरामीटर में ज़रूरी जानकारी शामिल होती है. एमसीपी सर्वर, मल्टी-राउंड-ट्रिप अनुरोधों (एमआरटीआर) के ज़रिए, किसी टूल के लिए ज़रूरी अतिरिक्त जानकारी का अनुरोध कर सकते हैं.

अनुरोध के मुख्य हिस्से को पार्स किए बिना अनुरोधों को रूट करने और उन्हें प्रोसेस करने के लिए, कुछ एमसीपी हेडर ज़रूरी होते हैं. इनमें ये शामिल हैं:

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

एमसीपी आर्किटेक्चर के बारे में ज़्यादा जानने के लिए, एमसीपी वर्शन 2026-07-28 का स्पेसिफ़िकेशन और मुख्य बदलाव देखें.

शुरू करने से पहले

Android Management API के रिमोट एमसीपी सर्वर का इस्तेमाल करने के लिए, आपको एक Google Cloud प्रोजेक्ट बनाना होगा और Android Management API को चालू करना होगा.

1. Cloud Console में, प्रोजेक्ट चुनने वाले पेज पर जाकर, कोई Google Cloud प्रोजेक्ट चुनें या बनाएं.

   प्रोजेक्ट चुनने वाले टूल पर जाएं

2. अगर Android Management API पहले से चालू नहीं है, तो उसे चालू करें.

   एपीआई चालू करने के लिए ज़रूरी भूमिकाएं

   एपीआई चालू करने के लिए, आपके पास serviceusage.services.enable अनुमति होनी चाहिए. अगर आपने प्रोजेक्ट बनाया है, तो आपके पास मालिक की भूमिका (roles/owner) के ज़रिए यह अनुमति पहले से ही होगी. अगर ऐसा नहीं है, तो आपको सेवा के इस्तेमाल से जुड़े एडमिन की भूमिका (roles/serviceusage.serviceUsageAdmin) के ज़रिए यह अनुमति मिल सकती है. भूमिकाएं असाइन करने का तरीका जानें.

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

ज़रूरी भूमिकाएं

Android Management API के रिमोट एमसीपी सर्वर का इस्तेमाल करने के लिए, अपने एडमिन से Google Cloud प्रोजेक्ट पर पहचान और ऐक्सेस मैनेजमेंट की ये भूमिकाएं असाइन करने के लिए कहें. ऐसा उस Google Cloud प्रोजेक्ट पर करें जहां आपको Android Management API के एमसीपी सर्वर को चालू करना है:

• एमसीपी टूल को कॉल करना: MCP टूल का इस्तेमाल करने वाला व्यक्ति (roles/mcp.toolUser)
• Android Management के संसाधनों को ऐक्सेस करना: Android Management का उपयोगकर्ता (roles/androidmanagement.user)

भूमिकाएं असाइन करने के बारे में ज़्यादा जानने के लिए, प्रोजेक्ट, फ़ोल्डर, और संगठनों का ऐक्सेस मैनेज करना लेख पढ़ें.

इन पहले से तय की गई भूमिकाओं में, Android Management API के रिमोट एमसीपी सर्वर का इस्तेमाल करने के लिए ज़रूरी अनुमतियां शामिल होती हैं. ज़रूरी अनुमतियों के बारे में जानने के लिए, ज़रूरी अनुमतियां सेक्शन को बड़ा करें.

पुष्टि करना और अनुमति देना

Android Management API के एमसीपी सर्वर, पुष्टि करने और अनुमति देने के लिए पहचान और ऐक्सेस मैनेजमेंट के साथ OAuth 2.0 प्रोटोकॉल का इस्तेमाल करते हैं. एमसीपी सर्वर पर पुष्टि करने के लिए, Google Cloud की सभी पहचानों का इस्तेमाल किया जा सकता है.

Android Management API का रिमोट एमसीपी सर्वर, एपीआई पासकोड स्वीकार नहीं करता.

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

Android Management API MCP के OAuth स्कोप

OAuth 2.0, स्कोप और क्रेडेंशियल का इस्तेमाल करके यह तय करता है कि पुष्टि किए गए किसी प्रिंसिपल को किसी संसाधन पर कोई खास कार्रवाई करने की अनुमति है या नहीं. Google पर OAuth 2.0 के दायरों के बारे में ज़्यादा जानने के लिए, Google APIs को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

Android Management API में, एमसीपी टूल के लिए OAuth के ये स्कोप उपलब्ध हैं:

टूल कॉल के दौरान ऐक्सेस किए गए संसाधनों के लिए, अतिरिक्त स्कोप की ज़रूरत पड़ सकती है. Android Management API के लिए ज़रूरी स्कोप की सूची देखने के लिए, Android Management API पर जाएं.

Android Management API एमसीपी सर्वर का इस्तेमाल करने के लिए, एमसीपी क्लाइंट को कॉन्फ़िगर करना

Claude या Antigravity जैसे एआई ऐप्लिकेशन और एजेंट, एक एमसीपी क्लाइंट को इंस्टैंटिएट कर सकते हैं. यह क्लाइंट, एक एमसीपी सर्वर से कनेक्ट होता है. किसी एआई ऐप्लिकेशन के कई क्लाइंट हो सकते हैं. ये क्लाइंट, अलग-अलग एमसीपी सर्वर से कनेक्ट होते हैं. अगर आपका ऐप्लिकेशन, क्लाइंट के हिसाब से दिए गए दिशा-निर्देशों में शामिल नहीं है, तो ज़्यादातर ऐप्लिकेशन से कनेक्ट करने के लिए, यहां दी गई जानकारी का इस्तेमाल किया जा सकता है.

अपने एआई ऐप्लिकेशन में, रिमोट एमसीपी सर्वर को जोड़ने या उससे कनेक्ट करने का तरीका देखें. Android Management API के एमसीपी सर्वर के लिए, यहां दी गई जानकारी डालें:

• सर्वर का नाम: Android Management API एमसीपी सर्वर
• सर्वर यूआरएल या एंडपॉइंट: https://androidmanagement.googleapis.com/mcp
• ट्रांसपोर्ट: स्ट्रीम किया जा सकने वाला एचटीटीपी
• पुष्टि करने की जानकारी: पुष्टि करने के तरीके के आधार पर, Google Cloud के क्रेडेंशियल, OAuth क्लाइंट आईडी और सीक्रेट या एजेंट की पहचान और क्रेडेंशियल डाले जा सकते हैं. पुष्टि करने के बारे में ज़्यादा जानकारी के लिए, एमसीपी सर्वर से पुष्टि करना लेख पढ़ें.
• OAuth स्कोप: वह [OAuth 2.0 स्कोप][oauth-scopes-overview] जिसका इस्तेमाल आपको Android Management API MCP सर्वर से कनेक्ट करते समय करना है.

एमसीपी सर्वर को सेट अप करने और उससे कनेक्ट करने के बारे में, ऐप्लिकेशन से जुड़ी सलाह के लिए, क्लाइंट से जुड़ी सलाह देखें.

ज़्यादा जानकारी के लिए, यहां दिए गए संसाधन देखें:

• रिमोट एमसीपी सर्वर से कनेक्ट करें.
• एआई ऐप्लिकेशन में एमसीपी को कॉन्फ़िगर करना.

उपलब्ध टूल

Android Management API के एमसीपी सर्वर के लिए उपलब्ध एमसीपी टूल और उनके ब्यौरे की जानकारी देखने के लिए, Android Management API के एमसीपी के बारे में जानकारी देखें.

सूची बनाने वाले टूल

टूल की सूची बनाने के लिए, एमसीपी इंस्पेक्टर का इस्तेमाल करें या Android Management API के रिमोट एमसीपी सर्वर को सीधे tools/list एचटीटीपी अनुरोध भेजें. tools/list तरीके के लिए, पुष्टि करने की ज़रूरत नहीं होती.

curl -X POST https://androidmanagement.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

इनकी जगह ये डालें:

• TOOLSET_ENDPOINT: यह एमसीपी एंडपॉइंट का वह हिस्सा होता है जो सेवा के नाम के बाद आता है. उदाहरण के लिए, Android Management API के लिए यह mcp/toolset-name हो सकता है.
• MCP_PROTOCOL_VERSION: यह एमसीपी प्रोटोकॉल का वर्शन है. उदाहरण के लिए, 2026-07-28.

सैंपल के तौर पर दिए गए इस्तेमाल के उदाहरण

Android Management API के एमसीपी सर्वर के इस्तेमाल के उदाहरण यहां दिए गए हैं:

• सामान्य भाषा में क्वेरी पूछना: कोड लिखे बिना, अपने डिवाइस फ्लीट के बारे में मुश्किल सवाल पूछें. उदाहरण के लिए, "मेरे कौनसे डिवाइस, सुरक्षा से जुड़े नए पैच के मुताबिक नहीं हैं?"
• अपने-आप होने वाली ऑडिट: समय-समय पर डेटा फ़ेच करना और डिवाइस की स्थिति और नीति के पालन से जुड़ी रिपोर्ट कंपाइल करना.
• स्मार्ट सूचनाएं: फ्लीट के डेटा को मॉनिटर करें, ताकि रीयल-टाइम में मिली अहम जानकारी के आधार पर गड़बड़ियों या संभावित समस्याओं का पता लगाया जा सके.

प्रॉम्प्ट के सैंपल

Android Management API के संसाधनों के बारे में जानकारी पाने के लिए, यहां दिए गए सैंपल प्रॉम्प्ट का इस्तेमाल किया जा सकता है:

• Enterprise ENTERPRISE_ID में मौजूद डिवाइसों की सूची दिखाओ.
• डिवाइस DEVICE_ID के बारे में जानकारी पाएं. यह डिवाइस एंटरप्राइज़ ENTERPRISE_ID में है.
• नीति POLICY_NAME के बारे में जानकारी दिखाओ.
• एंटरप्राइज़ ENTERPRISE_ID में कौनसे ऐप्लिकेशन उपलब्ध हैं?

प्रॉम्प्ट में, इनकी जगह ये डालें:

• ENTERPRISE_ID: एंटरप्राइज़ का संसाधन नाम—उदाहरण के लिए, enterprises/LC012345.
• DEVICE_ID: डिवाइस का संसाधन नाम.
• POLICY_NAME: नीति के संसाधन का नाम.

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

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

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

IAM नीतियों की मदद से, एमसीपी के इस्तेमाल को कंट्रोल करना

पहचान और ऐक्सेस मैनेजमेंट अनुमति न देने से जुड़ी नीतियां और अनुमति देने से जुड़ी नीतियां, Google Cloud और Google MCP सर्वर को सुरक्षित रखने में आपकी मदद करती हैं.

अपनी ज़रूरत के हिसाब से सुरक्षा और गवर्नेंस की नीतियां बनाने के लिए, कई शर्तों को एक साथ इस्तेमाल किया जा सकता है. इसके लिए, यहां दी गई शर्तों के आधार पर ऐक्सेस दिया या नकारा जा सकता है:

• मुख्य रकम.
• टूल की प्रॉपर्टी, जैसे कि सिर्फ़ पढ़ने के लिए उपलब्ध एट्रिब्यूट.
• सेवा या टूल का नाम.
• ऐप्लिकेशन का OAuth क्लाइंट आईडी.

ज़्यादा जानकारी के लिए, पहचान और ऐक्सेस मैनेजमेंट की मदद से, एमसीपी के इस्तेमाल को कंट्रोल करना लेख पढ़ें.

आगे क्या करना है

• Android Management API MCP से जुड़ा दस्तावेज़ पढ़ें.
• Google Cloud MCP सर्वर के बारे में ज़्यादा जानें.