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

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

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

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

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

  • 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 Sheets के एमसीपी सर्वर को कॉन्फ़िगर करना

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

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

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

  • Google Sheets API

CLI

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

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

कंसोल

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

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

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

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

  • Google Sheets MCP API

CLI

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

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

कंसोल

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

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

Google Sheets का एमसीपी सर्वर, पुष्टि करने और अनुमति देने के लिए 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 में Sheets 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 Sheets के एमसीपी सर्वर के लिए स्कोप चिपकाएं:

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

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

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

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

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

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

Antigravity

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

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

Claude में, Google Sheets का रिमोट एमसीपी सर्वर जोड़ने के लिए, 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 Sheets प्रॉडक्ट के लिए, कनेक्शन की जानकारी डालें:
      • Server name: Google Sheets.
      • Remote MCP server URL: https://sheetsmcp.googleapis.com/mcp/v1
    4. Advanced settings में, अपना OAuth क्लाइंट ID और क्लाइंट सीक्रेट डालें.
    5. Add पर क्लिक करें.

अन्य

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

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

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

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

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

  • "Google Sheet abcd123 से, Sheet1 को पढ़ें."

    क्लाइंट, sheets.get_values का इस्तेमाल करके, ग्रिड की वैल्यू फ़ेच करता है.

  • "Google Sheet abcd123 में, कॉलम इंडेक्स 2 पर एक कॉलम जोड़ें."

    क्लाइंट, कॉलम में बदलाव करने के लिए sheets.insert_dimension का इस्तेमाल करता है.

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

समस्या का हल

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

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

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

  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension

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

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

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

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