Google Home MCP Server

   अर्ली ऐक्सेस   

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

चेतावनी!

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

अगर आपको परिवार के अन्य सदस्यों के इस्तेमाल किए जा रहे Google Home को Home MCP से कनेक्ट करना है, तो उन्हें बताएं कि आपका एजेंट डिवाइसों को कंट्रोल कर सकता है और होम डेटा को ऐक्सेस कर सकता है. इसके अलावा, एक और होम बनाएं और डेवलपमेंट और टेस्टिंग के लिए डिवाइस सेट अप करें.

आपके एजेंट के पास Home MCP का ऐक्सेस होता है. इसे Google Home app (GHA) या 'मेरे खाते' पेज से किसी भी समय रद्द किया जा सकता है.

खास जानकारी

एमसीपी सर्वर, स्मार्ट होम इंफ़्रास्ट्रक्चर और एआई ऐप्लिकेशन के बीच प्रॉक्सी के तौर पर काम करता है. होम एमसीपी सर्वर, ऐसे टूल उपलब्ध कराता है जिन्हें चलाया जा सकता है. इनकी मदद से, एआई क्लाइंट, होम टेलीमेट्री के बारे में रीयल-टाइम में क्वेरी कर सकते हैं और निर्देश दे सकते हैं.

मुख्य सुविधाएं

होम एमसीपी सर्वर, कई मुख्य सुविधाएं उपलब्ध कराता है:

  • स्ट्रक्चर की जानकारी पाना: list_homes का इस्तेमाल करके, ऐक्सेस किए जा सकने वाले घरों और स्ट्रक्चर की जानकारी पाएं.
  • संसाधन ढूंढना: list_home_resources का इस्तेमाल करके, डिवाइसों, एरिया लेआउट, ट्रेट, एट्रिब्यूट, और कमांड स्कीमा की सूची बनाएं.
  • स्टेट मॉनिटरिंग: list_home_states का इस्तेमाल करके, डिवाइस की कनेक्टिविटी का रीयल-टाइम स्टेटस और उसकी खासियतें देखें.
  • डिवाइस कंट्रोल: run_home_actions का इस्तेमाल करके, टारगेट किए गए डिवाइसों पर पैरामीटर वाली कार्रवाई के निर्देश लागू करें.
  • पिछला विश्लेषण: list_home_history का इस्तेमाल करके, स्थिति में हुए पिछले बदलावों और इवेंट लॉग के बारे में क्वेरी करें. इसके लिए, समय की खास सीमाएं तय करें.

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

होम एमसीपी सर्वर सेट अप करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

  • Google Home में स्मार्ट होम सेटअप किया गया हो और उससे डिवाइस कनेक्ट किए गए हों.
  • Google Home Premium Advanced की चालू सदस्यता.
  • Google Cloud प्रोजेक्ट का ऐक्सेस.
  • एमसीपी के साथ काम करने वाला एआई क्लाइंट या ऐप्लिकेशन, जैसे कि Google Antigravity, Claude Cowork या OpenClaw.

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

एमसीपी सर्वर को सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना, ऐक्सेस की मंज़ूरी पाना, Home API चालू करना, और OAuth क्रेडेंशियल जनरेट करना ज़रूरी है.

Google Cloud प्रोजेक्ट बनाना

अगर आपके पास Google Cloud नहीं है, तो आपको एक बनाना होगा:

  1. Google Cloud कंसोल खोलें.
  2. नया Google Cloud प्रोजेक्ट बनाएं.

ज़्यादा जानकारी के लिए, Google Cloud के दस्तावेज़ में प्रोजेक्ट बनाना लेख पढ़ें.

Home API चालू करना

  1. Google Cloud console के नेविगेशन मेन्यू में, एपीआई और सेवाएं > चालू किए गए एपीआई और सेवाएं को चुनें.
  2. Home API खोजें और चालू करें पर क्लिक करें.
  1. उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है:
    1. एपीआई और सेवाएं > OAuth के लिए सहमति देने वाली स्क्रीन खोलें.
    2. बाहरी ऑडियंस को चुनें. इसके बाद, शुरू करें पर क्लिक करें. अब ऐप्लिकेशन के बारे में ज़रूरी जानकारी और संपर्क ईमेल भरें.
  2. OAuth क्लाइंट आईडी बनाएं:
    1. एपीआई और सेवाएं > क्रेडेंशियल खोलें.
    2. + क्रेडेंशियल बनाएं पर क्लिक करें और OAuth क्लाइंट आईडी चुनें.
    3. ऐप्लिकेशन टाइप को वेब ऐप्लिकेशन पर सेट करें.
    4. अपने टारगेट एआई क्लाइंट से जुड़े, अनुमति वाले रीडायरेक्ट यूआरआई जोड़ें:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: आपके स्थानीय OpenClaw इंस्टॉलेशन से तय किया गया रीडायरेक्ट यूआरआई
    5. बनाएं पर क्लिक करें. इसके बाद, अपने क्लाइंट आईडी और क्लाइंट सीक्रेट को किसी सुरक्षित जगह पर कॉपी करें.
  3. अपना ऐप्लिकेशन पब्लिश करें:
    1. Google Auth Platform > Audience खोलें.
    2. पब्लिश करने की स्थिति में जाकर, ऐप्लिकेशन पब्लिश करें पर क्लिक करें.

अपने एआई क्लाइंट को कॉन्फ़िगर करना

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

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

प्रॉम्प्ट का इस्तेमाल करके, अपने-आप होने वाला सेटअप

अगर आपकी एआई असिस्टेंट, चैट से सीधे तौर पर एमसीपी टूल के कॉन्फ़िगरेशन को मैनेज करने की सुविधा देती है, तो असिस्टेंट को सर्वर कॉन्फ़िगर करने के लिए निर्देश दिया जा सकता है. इसके लिए, यह प्रॉम्प्ट चिपकाएं:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://preprod-home.sandbox.googleapis.com/mcp
- Transport: sse
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

मैन्युअल सेटअप

मैन्युअल तरीके से सेटअप करने के निर्देशों के लिए, अपना पसंदीदा एआई टूल चुनें.

Antigravity

Google Antigravity, अपने सीएलआई, आईडीई, और डेस्कटॉप एनवायरमेंट में एमसीपी सर्वर के लिए, पहले से मौजूद इंटिग्रेशन की सुविधा देता है.

  1. ऐप्लिकेशन कॉन्फ़िगरेशन मेन्यू खोलें: सेटिंग > ऐडवांस सेटिंग > कस्टमाइज़ेशन > MCP कॉन्फ़िगरेशन खोलें.
  2. mcpServers कॉन्फ़िगरेशन ऑब्जेक्ट में home_mcp एंट्री जोड़ें:

    {
      "mcpServers": {
        "home_mcp": {
          "serverUrl": "https://home.googleapis.com/mcp",
          "oauth": {
            "clientId": "YOUR_CLIENT_ID",
            "clientSecret": "YOUR_CLIENT_SECRET"
          }
        }
      }
    }
    
  3. पुष्टि की प्रोसेस पूरी करें: सेटिंग > ऐडवांस सेटिंग > कस्टमाइज़ेशन > home_mcp > पुष्टि करें पर जाएं.

  4. अपने वेब ब्राउज़र में, Google Home की अनुमतियों से जुड़ी प्रोसेस पूरी करें. इसके बाद, अपने होम स्ट्रक्चर को चुनें और ऑथराइज़ेशन कोड को वापस Antigravity में कॉपी करें.

ज़्यादा जानकारी के लिए, Google Antigravity का दस्तावेज़ देखें.

Claude

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

  1. Claude Connectors खोलें.
  2. + पर क्लिक करें और कस्टम कनेक्टर जोड़ें को चुनें.
  3. सर्वर का यूआरएल डालें: https://home.googleapis.com/mcp.
  4. ऐडवांस सेटिंग पर क्लिक करें. इसके बाद, अपना क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
  5. जोड़ें पर क्लिक करें और अपने ब्राउज़र में OAuth ऑथराइज़ेशन फ़्लो पूरा करें.
  6. Cowork चैट में, सबसे नीचे बाएं कोने में मौजूद + पर क्लिक करें. इसके बाद, कनेक्टर को चुनें और home_mcp को टॉगल करके चालू करें.

ज़्यादा जानकारी के लिए, Claude Platform के दस्तावेज़ देखें.

OpenClaw

OAuth की पुष्टि करने की सुविधा के साथ, रिमोट एसएसई ट्रांसपोर्ट से कनेक्ट करने के लिए OpenClaw को कॉन्फ़िगर करें:

  1. कॉन्फ़िगरेशन पैच का JSON ब्लॉक तैयार करें:

    {
      "mcp": {
        "servers": {
          "home_mcp": {
            "url": "https://home.googleapis.com/mcp",
            "transport": "sse",
            "auth": "oauth",
            "oauth": {
              "scope": "https://www.googleapis.com/auth/home.platform.v2",
              "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
            },
            "env": {
              "CLIENT_ID": "YOUR_CLIENT_ID",
              "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            }
          }
        }
      }
    }
    
  2. अपने टर्मिनल में कॉन्फ़िगरेशन पैच लागू करें:

    openclaw config patch --stdin
    
  3. OpenClaw गेटवे को रीस्टार्ट करें:

    openclaw gateway restart
    
  4. पुष्टि करने का फ़्लो शुरू करें:

    openclaw mcp login home_mcp
    
  5. साइन इन करने और ऐक्सेस करने की अनुमति देने के लिए, जनरेट किए गए ऑथराइज़ेशन यूआरएल का इस्तेमाल करें.

ज़्यादा जानकारी के लिए, OpenClaw के बारे में जानकारी देने वाला दस्तावेज़ पढ़ें.

होम एमसीपी में, जाने-पहचाने चेहरों का डेटा ऐक्सेस करने के लिए, उपयोगकर्ताओं को इस सुविधा के लिए अलग से सहमति देनी होगी.

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

  • सहमति देने वाला उपयोगकर्ता, Google Home स्ट्रक्चर का मैनेजर होना चाहिए.
  • उपयोगकर्ता के स्ट्रक्चर में, कम से कम एक ऐसा Google Nestकैमरा या दरवाज़े की घंटी होनी चाहिए जो इस सुविधा के साथ काम करता हो. साथ ही, उसके पास Google Home Premiumपैसे चुकाकर ली गई सदस्यता होनी चाहिए. इसके अलावा, हर कैमरे या दरवाज़े की घंटी के लिए, जाने-पहचाने चेहरों की पहचान करने की सुविधा चालू होनी चाहिए.
  • आपके ऐप्लिकेशन में, Google Cloud में बनाया गया OAuth 2.0 क्लाइंट आईडी होना चाहिए. अगर आपने अब तक OAuth 2.0 क्लाइंट नहीं बनाया है, तो अपने एआई क्लाइंट को कॉन्फ़िगर करें लेख पढ़ें.

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

लिंक मिलने के बाद, उस पर जाएं और सहमति दें.

अगर आपका एजेंट पहले से ही Home MCP से कनेक्ट है, तो वह आपके Home स्ट्रक्चर आईडी का पता अपने-आप लगा सकता है. साथ ही, क्लिक करने के लिए तैयार लिंक जनरेट कर सकता है.

इस पेज पर सीधे तौर पर इन पैरामीटर को अपडेट करें. इसके बाद, अपनी ज़रूरत के मुताबिक बनाए गए प्रॉम्प्ट को अपने एजेंट की चैट में कॉपी करके चिपकाएं.

  • CLIENT_IDGoogle Cloud से मिला OAuth 2.0 क्लाइंट आईडी. उदाहरण के लिए, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME — टारगेट Home स्ट्रक्चर का नाम.
Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

अगर आपका एजेंट पहले से ही Home MCP से कनेक्ट है, तो वह आपके Home स्ट्रक्चर आईडी का पता अपने-आप लगा सकता है. साथ ही, क्लिक करने के लिए तैयार लिंक जनरेट कर सकता है.

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

  • CLIENT_IDGoogle Cloud से मिला OAuth 2.0 क्लाइंट आईडी. उदाहरण के लिए, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID — टारगेट Home स्ट्रक्चर का यूयूआईडी. इसे पाने का सबसे आसान तरीका यह है कि Home MCP का इस्तेमाल करके, अपने एजेंट से पूछें, "मुझे [स्ट्रक्चर का नाम] के लिए स्ट्रक्चर आईडी (यूयूआईडी) बताओ."
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

कनेक्शन और फ़ंक्शन की पुष्टि करना

क्लाइंट को कॉन्फ़िगर करने और उसकी पुष्टि करने के बाद, सर्वर कनेक्शन की पुष्टि करें:

  1. अपने एआई असिस्टेंट या Workspace सेशन को लॉन्च करें.
  2. चालू एमसीपी सर्वर कनेक्शन देखें. इसके लिए, Antigravity में /mcp चलाएं या टूल की सूचियों की जांच करें.
  3. पुष्टि करें कि home_mcp चालू टूल के साथ सूची में शामिल है.
  4. अपनी Assistant को सैंपल प्रॉम्प्ट देकर, अलग-अलग सुविधाओं को आज़माएं:

    • इकाई की खोज: How many lights do I have in my house?
    • रीयल-टाइम में स्थिति की निगरानी करना: Is my home secured?
    • डिवाइस कंट्रोल करने की सुविधा: Turn off all the outside lights.
    • इतिहास के इवेंट का विश्लेषण: What happened while I was out?
  5. जब आपका क्लाइंट आपसे टूल को चलाने की अनुमतियां मांगे, तब उन्हें अनुमति दें. एआई असिस्टेंट, रीयल-टाइम में डिवाइस की स्थिति से जुड़ा डेटा हासिल कर सकती है. साथ ही, सभी जवाब आपके होम टेलीमेट्री के आधार पर दिए जाएँगे.

सहायता

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

एमसीपी में मौजूद किसी गड़बड़ी की शिकायत करने या किसी सुविधा का अनुरोध करने के लिए, हमारे सार्वजनिक समस्या ट्रैकर पर जाएं.

आम तौर पर होने वाली समस्याएं

  • ट्रेट टेस्टिंग — हम आपके एजेंट के लिए, ज़्यादा से ज़्यादा फ़ंक्शन उपलब्ध कराना चाहते हैं. इसलिए, हमने कुछ ऐसी ट्रेट शामिल की हैं जिन्हें एक्सपेरिमेंट के तौर पर मार्क किया गया है. ऐसा हो सकता है कि कुछ मामलों में, एक्सपेरिमेंट के तौर पर उपलब्ध ये सुविधाएं आपकी उम्मीद के मुताबिक काम न करें. अगर ऐसा है, तो कृपया शिकायत करने के लिए सार्वजनिक समस्या ट्रैकर का इस्तेमाल करें.
  • लेटेंसी — कभी-कभी आपको होम एमसीपी में उम्मीद से ज़्यादा लेटेंसी दिख सकती है. हम इसे बेहतर बनाने के लिए लगातार काम कर रहे हैं. आने वाले समय में, आपको इस समस्या में सुधार देखने को मिल सकता है.

जल्द आ रहा है

  • ऑटोमेशन — फ़िलहाल, Home MCP के साथ ऑटोमेशन बनाने और उन्हें मैनेज करने की सुविधा उपलब्ध नहीं है. हम इस सुविधा पर काम कर रहे हैं. हमारा प्लान है कि हम आने वाले समय में, ऑटोमेशन की सुविधा को रिलीज़ करें.