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

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

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

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

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

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

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

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

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

  • Gmail API

CLI

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

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

कंसोल

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

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

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

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

  • Gmail MCP API

CLI

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

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

कंसोल

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

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

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

      • https://www.googleapis.com/auth/gmail.readonly
      • https://www.googleapis.com/auth/gmail.compose

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

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

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

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

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

Antigravity

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

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

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

अन्य

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

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

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

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

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

  • "Ariel ने हमारे मार्केटिंग प्लान के बारे में अपने आखिरी ईमेल में क्या कहा था?"

    क्लाइंट, gmail.search_threads का इस्तेमाल करके, Ariel के ईमेल को फ़िल्टर करता है. इसके बाद, gmail.get_thread का इस्तेमाल करके, सबसे नए थ्रेड का कॉन्टेंट वापस पाता है. फिर, आपके लिए उसका सारांश तैयार करता है.

  • " ariel@example.com को एक ईमेल का ड्राफ़्ट तैयार करो. इसमें लिखो कि मैंने मार्केटिंग प्लान को मंज़ूरी दे दी है."

    क्लाइंट, gmail.create_draft का इस्तेमाल करके, आपके ड्राफ़्ट फ़ोल्डर में एक ईमेल बनाता है. इससे आपको Gmail से उसकी समीक्षा करने और उसे भेजने की अनुमति मिलती है.

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

समस्या का हल

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

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

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

  • create_draft
  • get_thread
  • label_message
  • label_thread
  • list_drafts
  • list_labels
  • search_threads
  • unlabel_message
  • unlabel_thread

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

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

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

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