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

Google Drive, रिमोट मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर की सुविधा देता है. इसकी मदद से, एआई एजेंट Google Drive के डेटा के साथ सुरक्षित तरीके से इंटरैक्ट कर सकते हैं. Google Drive के एमसीपी सर्वर को कॉन्फ़िगर करके, Gemini CLI, Claude या IDE जैसे एआई ऐप्लिकेशन को 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 > ब्रैंडिंग पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

Gemini CLI

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

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

    1. Google Cloud कंसोल में, Google Auth Platform > क्लाइंट > क्लाइंट बनाएं पर जाएं

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

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

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

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

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

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

    {
  "mcpServers": {
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    }
  }
}

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

    • OAUTH_CLIENT_ID: वह क्लाइंट आईडी जो आपने बनाया है.
    • OAUTH_CLIENT_SECRET: वह क्लाइंट सीक्रेट जो आपने बनाया है.

  4. settings.json सेव करें.

  5. Gemini CLI शुरू करें:

    gemini

  6. Gemini CLI में, एमसीपी सर्वर से पुष्टि करने के लिए, यह कमांड चलाएं:

    /mcp auth drive
    1. प्रॉम्प्ट दिखने पर, अपने ब्राउज़र में पुष्टि करने वाला पेज खोलने के लिए, 1 दबाएं. अगर SSH के ज़रिए काम किया जा रहा है, तो सीएलआई में दिए गए निर्देशों का पालन करें.
    2. अपने Google खाते में साइन इन करें.
    3. OAuth के लिए अनुरोध किए गए स्कोप की समीक्षा करें और अनुमति दें पर क्लिक करें.
    4. आपको एक मैसेज दिखेगा. इससे पता चलेगा कि पुष्टि की प्रोसेस पूरी हो गई है.

  7. Gemini CLI में, कॉन्फ़िगर किए गए एमसीपी सर्वर और उनके टूल देखने के लिए, /mcp list चलाएं.

    आपको इस तरह का जवाब मिलेगा:

    🟢 drive - Ready (8 tools)
  Tools:
  - copy_file
  - create_file
  - download_file_content
  - get_file_metadata
  - get_file_permissions
  - list_recent_files
  - read_file_content
  - search_files

अब Gemini CLI में, रिमोट एमसीपी सर्वर का इस्तेमाल किया जा सकता है.

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 > क्लाइंट > क्लाइंट बनाएं पर जाएं

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

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

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

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

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

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

    1. Claude.ai या Claude Desktop में, सेटिंग (या एडमिन सेटिंग) > कनेक्टर पर जाएं.
    2. कस्टम कनेक्टर जोड़ें पर क्लिक करें.
    3. Google Drive प्रॉडक्ट के लिए कनेक्शन की जानकारी डालें:
      • सर्वर का नाम: Google Drive.
      • रिमोट एमसीपी सर्वर का यूआरएल: https://drivemcp.googleapis.com/mcp/v1
    4. ऐडवांस सेटिंग में, अपना OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.
    5. जोड़ें पर क्लिक करें.

अन्य

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

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

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

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

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

  • "मार्केटिंग प्लान फ़ाइल की खास जानकारी दो."

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

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

समस्या का हल

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

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

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

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

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

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

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

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