Google Home MCP Sunucusu

   Erken Erişim   

Google Home Model Bağlam Protokolü (MCP) sunucusu, yapay zeka destekli geliştirme araçlarının ve sanal asistanların doğrudan akıllı ev ortamlarıyla etkileşim kurmasına olanak tanır. Sunucu, standart MCP araçlarını ve RPC arayüzlerini kullanıma sunarak büyük dil modellerinin (LLM'ler) ev yapılarını incelemesine, cihaz durumlarını izlemesine, kontrol işlemlerini yürütmesine ve geçmiş etkinlikleri analiz etmesine olanak tanır.

Uyarı!

Gerçek hayattaki bir evi yapay zeka aracısına bağladığınızda bu aracı, cihazları sizin adınıza kontrol edebilir. Ev MCP'si, kapıların kilidini açma gibi hassas işlemlerin yasaklanması gibi sıklık sınırlarını ve güvenlik korumalarını zorunlu kılar. Ancak aracıya bağlı olarak, Home MCP'ye bağlanması beklenmedik veya istenmeyen davranışlara neden olabilir. Geliştirici politikalarını ve hizmet şartlarını dikkatlice inceleyin.

Diğer hane üyeleri tarafından kullanılan bir Google Home'u Home MCP'ye bağlamayı seçerseniz bu kişileri, temsilcinizin cihazları kontrol edebileceği ve ev verilerine erişebileceği konusunda bilgilendirmeniz gerekir. Alternatif olarak, ek bir ev oluşturup geliştirme ve test için cihazları ayarlayabilirsiniz.

Temsilcinizin Home MCP'ye erişimi, Google Home app (GHA) veya Hesaplarım sayfanızdan istediğiniz zaman iptal edilebilir.

Genel Bakış

Bir MCP sunucusu, akıllı ev altyapısı ile yapay zeka uygulamaları arasında proxy görevi görür. Home MCP sunucusu, yapay zeka istemcilerinin anlık ev telemetrisi sorgulamasına ve komut vermesine olanak tanıyan yürütülebilir araçlar sunar.

Temel özellikler

Home MCP sunucusu çeşitli temel özellik alanları sunar:

  • Yapı keşfi: list_homes kullanarak erişilebilir evleri ve yapıları alın.
  • Kaynak keşfi: list_home_resources kullanarak cihazları, alan düzenlerini, özellikleri, nitelikleri ve komut şemalarını listeleyin.
  • Durum izleme: list_home_states kullanarak cihaz bağlantı durumunu ve özellik durumlarını gerçek zamanlı olarak kontrol edin.
  • Cihaz kontrolü: run_home_actions kullanarak hedef cihazlarda parametreli işlem komutları yürütün.
  • Geçmiş analizi: list_home_history kullanarak belirli zaman aralıklarındaki geçmiş durum değişikliklerini ve etkinlik günlüklerini sorgulayın.

Ön koşullar

Ev MCP sunucusunu ayarlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Google Home'da bağlı cihazlarla etkin bir akıllı ev kurulumu.
  • Etkin bir Google Home Premium Advanced aboneliği
  • Google Cloud projesine erişim
  • Google Antigravity, Claude Cowork veya OpenClaw gibi MCP uyumlu bir yapay zeka istemcisi ya da uygulaması

MCP sunucusunu yapılandırın

MCP sunucusunu ayarlamak için Google Cloud projesi oluşturmanız, erişim onayı almanız, Home API'yi etkinleştirmeniz ve OAuth kimlik bilgileri oluşturmanız gerekir.

Google Cloud projesi oluşturma

Henüz bir Google Cloud hesabınız yoksa hesap oluşturmanız gerekir:

  1. Google Cloud konsolunu açın.
  2. Yeni bir Google Cloud projesi oluşturun.

Daha fazla bilgi için Google Cloud belgelerindeki Proje oluşturma makalesine bakın.

Home API'yi etkinleştirme

  1. Google Cloud konsol gezinme menüsünde API'ler ve Hizmetler > Etkin API'ler ve Hizmetler'i seçin.
  2. Home API'yi arayın ve Etkinleştir'i tıklayın.
  1. OAuth kullanıcı rızası ekranını yapılandırın:
    1. API'ler ve Hizmetler > OAuth kullanıcı rızası ekranı'nı açın.
    2. Harici kitleyi seçin, Başlayın'ı tıklayın ve gerekli uygulama bilgilerini ve iletişim e-posta adresini girin.
  2. OAuth istemci kimliği oluşturun:
    1. API'ler ve Hizmetler > Kimlik Bilgileri'ni açın.
    2. + Kimlik bilgileri oluştur'u tıklayın ve OAuth istemci kimliği'ni seçin.
    3. Application type'ı (Uygulama türü) Web application (Web uygulaması) olarak ayarlayın.
    4. Hedef yapay zeka istemcilerinize karşılık gelen yetkilendirilmiş yönlendirme URI'lerini ekleyin:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: Yerel OpenClaw yüklemeniz tarafından belirtilen yönlendirme URI'si
    5. Oluştur'u tıklayın ve istemci kimliğinizi ve istemci gizli anahtarınızı güvenli bir yere kopyalayın.
  3. Uygulamanızı yayınlayın:
    1. Google Auth Platform > Audience'ı (Kitle) açın.
    2. Yayınlama durumu bölümünde Uygulamayı yayınla'yı tıklayın.

Yapay zeka istemcinizi yapılandırma

OAuth kimlik doğrulaması kullanarak Home MCP sunucusuna bağlanmak için çeşitli yapay zeka geliştirme ortamları yapılandırabilirsiniz. OAuth istemci kimliğinizi ve istemci gizli anahtarınızı buraya girin, ardından tercih ettiğiniz kurulum talimatlarını uygulayın.

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

İstem kullanarak otomatik kurulum

Yapay zeka asistanınız, MCP aracı yapılandırmalarının doğrudan sohbetten yönetilmesini destekliyorsa aşağıdaki istemi yapıştırarak asistanınızdan sunucuyu yapılandırmasını isteyebilirsiniz:

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

Manuel kurulum

Manuel kurulum talimatları için tercih ettiğiniz yapay zeka aracını seçin.

Antigravity

Google Antigravity, CLI, IDE ve masaüstü ortamlarında MCP sunucuları için yerleşik entegrasyon sağlar.

  1. Uygulama yapılandırma menüsünü açın: Ayarlar > Gelişmiş ayarlar > Özelleştirmeler > MCP Yapılandırmasını Aç.

  2. mcpServers yapılandırma nesnesi altına home_mcp girişini ekleyin:

    {
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

  3. Kimlik doğrulama işlemini tamamlayın: Ayarlar > Gelişmiş ayarlar > Özelleştirmeler > home_mcp > Kimlik doğrulama'ya gidin.

  4. Web tarayıcınızda Google Home izinleri akışını tamamlayın, ev yapınızı seçin ve yetkilendirme kodunu Antigravity'ye geri kopyalayın.

Daha fazla bilgi için Google Antigravity belgelerine bakın.

Claude

Claude Cowork'ü özel ev MCP sunucunuza bağlanacak şekilde yapılandırın:

  1. Claude Connectors'ı açın.
  2. + simgesini tıklayın ve Özel bağlayıcı ekle'yi seçin.
  3. Sunucu URL'sini girin: https://home.googleapis.com/mcp.
  4. Gelişmiş ayarlar'ı tıklayın ve istemci kimliğinizi ve istemci gizli anahtarınızı girin.
  5. Ekle'yi tıklayın ve tarayıcınızda OAuth yetkilendirme akışını tamamlayın.
  6. Cowork sohbetinde sol alt köşedeki + simgesini tıklayın, Bağlayıcılar'ı seçin ve home_mcp'yi etkinleştirin.

Daha fazla bilgi için Claude Platformu belgelerine bakın.

OpenClaw

OpenClaw'ı OAuth kimlik doğrulaması ile uzak SSE aktarımına bağlanacak şekilde yapılandırın:

  1. Yapılandırma yaması JSON bloğunu hazırlayın:

    {
  "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. Yapılandırma yamasını terminalinizde uygulayın:

    openclaw config patch --stdin

  3. OpenClaw ağ geçidini yeniden başlatın:

    openclaw gateway restart

  4. Kimlik doğrulama akışını başlatın:

    openclaw mcp login home_mcp

  5. Oturum açmak ve erişim izni vermek için oluşturulan yetkilendirme URL'sini kullanın.

Daha fazla bilgi için OpenClaw belgelerine bakın.

Kullanıcıların, Ev MCP'sindeki tanıdık yüzler verilerine erişmek için bu özelliği ayrı olarak açıkça onaylaması gerekir.

Ön koşullar

  • İzin veren kullanıcı, Google Home yapısının yöneticisi olmalıdır.
  • Kullanıcının yapısında en az bir uyumlu Google Nest kamera veya kapı zili ve Tanıdık yüz algılama'nın her kamera veya kapı zili için etkinleştirildiği etkin bir Google Home Premium abonelik olmalıdır.
  • Uygulamanızda Google Cloud içinde oluşturulmuş bir OAuth 2.0 istemci kimliği olmalıdır. Henüz yapmadıysanız OAuth 2.0 istemcisi oluşturmak için AI istemcinizi yapılandırma başlıklı makaleyi inceleyin.

Uygulamanıza erişim izni vermek için OAuth 2.0 istemci kimliğiniz ve Home yapı kimliğinizle kişiselleştirilmiş bir izin bağlantısını ziyaret etmeniz gerekir. İzin bağlantınızı almanın iki yolu vardır.

Bağlantınızı aldıktan sonra bağlantıyı ziyaret edin ve izin verin.

Temsilciniz zaten Home MCP'ye bağlıysa Home Yapı Kimliğinizi otomatik olarak bulabilir ve tıklamaya hazır bir bağlantı oluşturabilir.

Aşağıdaki parametreleri doğrudan bu sayfada güncelleyin, ardından özelleştirilmiş istemi kopyalayıp ajanınızın sohbetine yapıştırın.

  • CLIENT_ID: Google Cloud'dan alınan OAuth 2.0 istemci kimliğiniz. Örneğin, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME — Hedef Home yapısının adı.
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

Temsilciniz zaten Home MCP'ye bağlıysa Home Yapı Kimliğinizi otomatik olarak bulabilir ve tıklamaya hazır bir bağlantı oluşturabilir.

Aşağıdaki parametreleri doğrudan bu sayfada güncelleyin, ardından özelleştirilmiş bağlantıyı bir web tarayıcısında açın.

  • CLIENT_ID: Google Cloud'dan alınan OAuth 2.0 istemci kimliğiniz. Örneğin, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID — Hedef Home yapısının UUID'si. Bu bilgiyi almanın en kolay yolu, Home MCP'yi kullanarak aracınıza "[Yapı Adı] için yapı kimliğini (UUID) söyle" diye sormaktır.
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Bağlantıyı ve işlevselliği doğrulama

İstemciniz yapılandırılıp kimliği doğrulandıktan sonra sunucu bağlantısını doğrulayın:

  1. Yapay zeka asistanınızı veya Workspace oturumunuzu başlatın.
  2. Etkin MCP sunucusu bağlantılarını kontrol edin (Antigravity'de /mcp komutunu çalıştırın veya araç listelerini inceleyin).
  3. home_mcp simgesinin etkin araçlarla birlikte listelendiğini doğrulayın.

  4. Farklı özellikleri test etmek için asistanınıza örnek istemler gönderin:

    • Varlık keşfi: How many lights do I have in my house?
    • Anlık durum izleme: Is my home secured?
    • Cihaz kontrolü: Turn off all the outside lights.
    • Geçmiş etkinlik analizi: What happened while I was out?

  5. İstemciniz tarafından istendiğinde araç yürütme izinleri verin. Yapay zeka asistanı, anlık durum verilerini alabilir ve tüm yanıtlar evinizdeki telemetri verilerine dayandırılır.

Destek

Ev MCP geliştirme desteği için Geliştiriciler için Akıllı Ev Yardım Topluluğu'na gidin. Burada yardım almak için soru yayınlayabilir veya daha önce yayınlanmış sorulara göz atarak sorunuzun yanıtlanıp yanıtlanmadığını görebilirsiniz.

MCP hatası veya özellik isteği bildirmek için herkese açık sorun takip aracımıza gidin.

Bilinen sorunlar

  • Özellik testi: Temsilcileriniz için en geniş işlevsellik setini sağlamak amacıyla deneysel olarak işaretlenmiş bazı özellikleri ekledik. Bu deneysel özelliklerin beklendiği gibi çalışmadığı senaryolarla karşılaşabilirsiniz. Bu durumda, lütfen bildirmek için herkese açık sorun izleyiciyi kullanın.
  • Gecikme: Bazen Home MCP ile beklenenden daha uzun gecikme olduğunu fark edebilirsiniz. Optimizasyon çalışmaları devam ediyor. Gelecekteki sürümlerde gecikme süresinin iyileştirilmesini bekleyebilirsiniz.

Çok Yakında

  • Otomasyonlar: Şu anda Home MCP ile otomasyon oluşturma ve yönetme desteklenmemektedir. Bu işlev üzerinde çalışıyoruz ve gelecekteki bir sürümde otomasyon desteğini kullanıma sunmayı planlıyoruz.