Drive MCP सर्वर को कॉन्फ़िगर करना

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

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

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

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

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

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

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

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

  • Google Drive API

CLI

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

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

कंसोल

Google Cloud कंसोल में एपीआई चालू करें:

एपीआई चालू करें

एमसीपी सेवाएं चालू करना

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

  • Google Drive MCP API

CLI

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

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

कंसोल

Google Cloud कंसोल में एमसीपी सेवाएं चालू करें:

एमसीपी सेवाएं चालू करें

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

  1. Google Cloud कंसोल में, Google Auth Platform > Branding पर जाएं.

    Branding पर जाएं

  2. अगर आपने Google Auth Platform को पहले ही कॉन्फ़िगर कर लिया है, तो Branding, ऑडियंस, और डेटा ऐक्सेस में, ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है, की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको Google Auth Platform not configured yet मैसेज दिखता है, तो Get Started पर क्लिक करें:

    1. App Information में, App name में Drive MCP Server टाइप करें.
    2. User support email में, अपना ईमेल पता या कोई सही Google group चुनें.
    3. आगे बढ़ें पर क्लिक करें.
    4. Audience में, Internal को चुनें. अगर Internal को नहीं चुना जा सकता, तो External को चुनें.
    5. आगे बढ़ें पर क्लिक करें.
    6. Contact Information में, कोई ईमेल पता डालें. इस पते पर, आपको अपने प्रोजेक्ट में होने वाले बदलावों के बारे में सूचनाएं मिलेंगी.
    7. आगे बढ़ें पर क्लिक करें.
    8. Finish में, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो I agree to the Google API Services: User Data Policy को चुनें.
    9. जारी रखें पर क्लिक करें.
    10. बनाएं पर क्लिक करें.
    11. अगर आपने उपयोगकर्ता के टाइप के लिए External को चुना है, तो टेस्ट करने वाले उपयोगकर्ता जोड़ें:
      1. Audience पर क्लिक करें.
      2. Test users में, Add users पर क्लिक करें.
      3. अपना ईमेल पता और टेस्ट करने के लिए अनुमति पाए अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, Save पर क्लिक करें.

  3. Data Access > Add or Remove Scopes पर क्लिक करें. एक पैनल दिखता है. इसमें, आपके Google Cloud प्रोजेक्ट में चालू किए गए हर एपीआई के लिए स्कोप की सूची होती है.

    1. Manually add scopes में, Google Drive के एमसीपी सर्वर के लिए स्कोप चिपकाएं:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file

    2. Add to Table पर क्लिक करें.

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

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

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

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

Antigravity

Antigravity में Google Drive का रिमोट एमसीपी सर्वर जोड़ने के लिए, अपनी mcp_config.json फ़ाइल में सर्वर का कॉन्फ़िगरेशन जोड़ें. ये निर्देश, Antigravity 2.0, Antigravity IDE, और Antigravity CLI के लिए हैं.

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud कंसोल में, Google Auth Platform > Clients > Create Client पर जाएं

      Create Client पर जाएं

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

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

    4. Authorized redirect URIs सेक्शन में, + Add URI पर क्लिक करें. इसके बाद, https://antigravity.google/oauth-callback को URIs फ़ील्ड में जोड़ें.

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

  2. ~/.gemini/antigravity/mcp_config.json कॉन्फ़िगरेशन फ़ाइल खोलें या बनाएं.

  3. mcp_config.json में, mcpServers कॉन्फ़िगरेशन जोड़ें:

    {
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.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 या जीयूआई (Antigravity 2.0) के लिए:

      1. सेटिंग स्क्रीन खोलें. जैसे, सबसे नीचे बाईं ओर मौजूद Settings पर क्लिक करें या Antigravity User Settings खोलें.
      2. Customizations पर जाएं.
      3. Installed MCP Servers में, Refresh पर क्लिक करें.
      4. सूची में drive ढूंढें. इसके बाद, Authenticate पर क्लिक करें. अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, इसे इनपुट डायलॉग में चिपकाएं, और Submit पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

Claude में Google Drive का रिमोट एमसीपी सर्वर जोड़ने के लिए, OAuth क्लाइंट आईडी और सीक्रेट के साथ कोई कस्टम कनेक्टर कॉन्फ़िगर करें.

  1. OAuth 2.0 क्लाइंट आईडी और सीक्रेट बनाएं:

    1. Google Cloud कंसोल में, Google Auth Platform > Clients > Create Client पर जाएं

      Create Client पर जाएं

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

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

    4. Authorized redirect URIs सेक्शन में, + Add URI पर क्लिक करें. इसके बाद, https://claude.ai/api/mcp/auth_callback को URIs फ़ील्ड में जोड़ें.

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

  2. Claude में एमसीपी सर्वर को कॉन्फ़िगर करें:

    1. Claude.ai या Claude Desktop में, Settings (या Admin settings) > Connectors पर जाएं.
    2. Add custom connector पर क्लिक करें.
    3. Google Drive प्रॉडक्ट के लिए, कनेक्शन की जानकारी डालें:
      • Server name: Google Drive.
      • Remote MCP server URL: https://drivemcp.googleapis.com/mcp/v1
    4. Advanced settings में, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
    5. Add पर क्लिक करें.

अन्य

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

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

Google Drive के एमसीपी सर्वर की जांच करना

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

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

  • " Marketing Plan फ़ाइल की खास जानकारी दें."

    क्लाइंट, "Marketing Plan" को ढूंढने के लिए drive.search_files को कॉल करता है. इसके बाद, इसका कॉन्टेंट वापस पाने और खास जानकारी देने के लिए, drive.read_file_content का इस्तेमाल करता है.

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

समस्या का हल

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

टूल के बारे में जानकारी

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

  • copy_file
  • create_file
  • download_file_content
  • get_file_metadata
  • get_file_permissions
  • list_recent_files
  • read_file_content
  • search_files

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

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

इन जोखिमों को कम करने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं:

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