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

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

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

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

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

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

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

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

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

  • Google Calendar API

CLI

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

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

कंसोल

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

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

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

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

  • Google Calendar MCP API

CLI

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

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

कंसोल

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

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

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

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

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

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

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

Antigravity

Antigravity में Google Calendar का रिमोट एमसीपी सर्वर जोड़ने के लिए, अपनी 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": {
    "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. सेटिंग स्क्रीन खोलें. जैसे, सबसे नीचे बाईं ओर मौजूद Settings पर क्लिक करें या Antigravity User Settings खोलें.
      2. Customizations पर जाएं.
      3. Installed MCP Servers में, Refresh पर क्लिक करें.
      4. सूची में calendar ढूंढें. इसके बाद, Authenticate पर क्लिक करें. अपने Google खाते में साइन इन करें, ऑथराइज़ेशन कोड कॉपी करें, इसे इनपुट डायलॉग में चिपकाएं, और Submit पर क्लिक करें.

    • Antigravity CLI के लिए:

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

        agy

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

        /mcp

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

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

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

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

Claude

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

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

अन्य

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

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

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

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

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

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

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

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

समस्या का हल

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

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

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

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

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

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

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

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