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

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

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

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

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

  • एक Google Cloud प्रोजेक्ट. प्रोजेक्ट बनाने के लिए, प्रोजेक्ट बनाना लेख पढ़ें.

  • एक एमसीपी क्लाइंट, जैसे कि Google Antigravity.

  • इस पेज पर दिए गए कमांड चलाने के लिए, इनमें से किसी एक डेवलपमेंट एनवायरमेंट में gcloud सीएलआई सेट अप करें:

    Cloud Shell

    gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell को चालू करें:

    Cloud Shell चालू करें

    लोकल शेल

    लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

    1. Google Cloud CLI इंस्टॉल करें. अगर आपने gcloud सीएलआई को पहले इंस्टॉल किया है, तो पक्का करें कि आपके पास इसका सबसे नया वर्शन हो. इसके लिए, gcloud components update चलाएं.
    2. अगर किसी बाहरी आइडेंटिटी प्रोवाइडर (आईडीपी) का इस्तेमाल किया जा रहा है, तो फ़ेडरेटेड आइडेंटिटी का इस्तेमाल करके, gcloud सीएलआई में साइन इन करें. ज़्यादा जानकारी के लिए, फ़ेडरेटेड आइडेंटिटी का इस्तेमाल करके, gcloud सीएलआई में साइन इन करना लेख पढ़ें.
    3. gcloud सीएलआई का इस्तेमाल शुरू करें.

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

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

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

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

  • Google Docs API

CLI

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

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

कंसोल

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

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

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

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

  • Google Docs MCP API

CLI

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

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

कंसोल

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

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

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

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

    Branding पर जाएं

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

    1. App Information में, App name में Docs MCP Server टाइप करें.
    2. User support email में, अपना ईमेल पता या कोई सही Google group चुनें.
    3. Next पर क्लिक करें.
    4. Audience में, Internal को चुनें. अगर Internal को नहीं चुना जा सकता, तो External को चुनें.
    5. Next पर क्लिक करें.
    6. Contact Information में, Email address डालें. इस पते पर, आपको अपने प्रोजेक्ट में होने वाले किसी भी बदलाव के बारे में सूचनाएं मिलेंगी.
    7. Next पर क्लिक करें.
    8. Finish में, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो I agree to the Google API Services: User Data Policy को चुनें.
    9. Continue पर क्लिक करें.
    10. Create पर क्लिक करें.
    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 Docs के एमसीपी सर्वर के लिए स्कोप चिपकाएं:

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

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

    3. Update पर क्लिक करें.

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

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

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

Antigravity

Antigravity में, Google Docs का रिमोट एमसीपी सर्वर जोड़ने के लिए, अपने 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. कोई Name डालें.

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

    5. Create पर क्लिक करें. इसके बाद, अपना Client ID और Client Secret कॉपी करें.

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

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

    {
  "mcpServers": {
    "docs": {
      "serverUrl": "https://docsmcp.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. सूची में docs ढूंढें. इसके बाद, Authenticate पर क्लिक करें. अपने Google खाते में साइन इन करें. ऑथराइज़ेशन कोड कॉपी करें. इसे इनपुट डायलॉग में चिपकाएं. इसके बाद, Submit पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

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

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

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

      Create Client पर जाएं

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

    3. कोई Name डालें.

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

    5. Create पर क्लिक करें. इसके बाद, अपना Client ID और Client Secret कॉपी करें.

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

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

अन्य

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

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

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

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

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

  • "मुझे Google Docs abcd123 का स्ट्रक्चरल कॉन्टेंट दिखाओ."

    क्लाइंट, docs.read_doc का इस्तेमाल करके, दस्तावेज़ का स्ट्रक्चर और कॉन्टेंट फ़ेच करता है.

  • "Google Docs abcd123 में, 'My Marketing Plan' टाइटल जोड़ो."

    क्लाइंट, स्ट्रक्चरल एलिमेंट को अपडेट करने और टेक्स्ट जोड़ने के लिए, docs.update_doc कार्रवाई करता है.

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

समस्या का हल

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

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

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

  • read_doc
  • update_doc

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

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

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

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