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

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

Calendar का एमसीपी सर्वर, एआई एजेंट को ये काम करने की सुविधा देता है:

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

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

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

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

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

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

  • Google Calendar API

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

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

कंसोल

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

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

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

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

  • Calendar MCP API

CLI

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

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

कंसोल

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

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

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

  1. कंसोल में, Google Auth Platform > ब्रैंडिंग पर जाएं.

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

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

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

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

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

      • https://www.googleapis.com/auth/calendar.calendarlist.readonly
      • https://www.googleapis.com/auth/calendar.events.freebusy
      • https://www.googleapis.com/auth/calendar.events.readonly

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

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

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

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

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

Antigravity

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

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

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

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

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

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

    4. ऑथराइज़्ड रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, https://antigravity.google/oauth-callback को यूआरआई फ़ील्ड में जोड़ें.

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

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

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

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.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. सेटिंग स्क्रीन खोलें. उदाहरण के लिए, सबसे नीचे बाईं ओर मौजूद सेटिंग पर क्लिक करें या Antigravity की उपयोगकर्ता सेटिंग खोलें.
      2. कस्टमाइज़ेशन पर जाएं.
      3. इंस्टॉल किए गए एमसीपी सर्वर में, रीफ़्रेश करें पर क्लिक करें.
      4. सूची में calendar ढूंढें. इसके बाद, पुष्टि करें पर क्लिक करें. अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, इसे इनपुट डायलॉग में चिपकाएं, और सबमिट करें पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

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

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

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

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

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

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

    4. ऑथराइज़्ड रीडायरेक्ट यूआरआई सेक्शन में, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, https://claude.ai/api/mcp/auth_callback को यूआरआई फ़ील्ड में जोड़ें.

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

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

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

अन्य

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

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

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

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

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

  • "एरियल के साथ मेरी अगली मीटिंग कब है?"

    क्लाइंट, calendar.list_events का इस्तेमाल करके आपका शेड्यूल देखता है और Ariel के साथ आपकी अगली मीटिंग की जानकारी देता है.

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

समस्या का हल

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

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

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

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

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

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

इन जोखिमों को कम करने के लिए, आपको प्रॉम्प्ट और जवाबों में, नुकसान पहुंचाने वाला कॉन्टेंट या प्रॉम्प्ट इंजेक्शन के हमलों की जांच करनी होगी. इसके लिए, Google की ओर से उपलब्ध कराए गए Model Armor का इस्तेमाल किया जा सकता है. इसके अलावा, अपना कोई समाधान भी इस्तेमाल किया जा सकता है. हालांकि, इसके लिए आपको दस्तावेज़ तैयार करना होगा, ताकि उपयोगकर्ता उस जोखिम को स्वीकार कर सकें. ज़्यादा जानकारी के लिए, Google Workspace के एमसीपी सर्वर के लिए सुरक्षा कॉन्फ़िगर करना लेख पढ़ें.

इन सबसे सही तरीकों को अपनाएं:

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