Google Home MCP Sunucusu

   Erken Erişim   

Google Home Model Context Protocol (MCP) sunucusu, yapay zeka destekli geliştirici araçlarının ve sanal asistanların akıllı ev ortamlarıyla doğrudan etkileşim kurmasına olanak tanır. Sunucu, standart MCP araçlarını ve RPC arayüzlerini göstererek 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 bir evi yapay zeka ajanına bağladığınızda bu ajan, cihazları sizin adınıza kontrol edebilir. Home MCP, sıklık sınırlamalarını ve güvenlik korumalarını uygular. Örneğin, kapı kilidini açma gibi hassas işlemleri yasaklar. Ancak temsilcinize bağlı olarak, temsilciyi Home MCP'ye bağlamak beklenmedik, hatta istenmeyen davranışlara yol açabilir. 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 temsilcinizin cihazları kontrol edebileceğini ve ev verilerine erişebileceğini onlara bildirmeniz gerekir. Alternatif olarak, ek bir ev oluşturabilir ve geliştirme ve test için cihazlar kurabilirsiniz.

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

Genel Bakış

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 telemetrisini 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 gerçek zamanlı cihaz bağlantı durumunu ve özellik durumlarını kontrol edin.
  • Cihaz kontrolü: run_home_actions kullanarak hedef cihazlarda parametreleştirilmiş işlem komutlarını yürütme
  • Geçmiş analizi: list_home_history kullanarak belirli zaman aralıklarındaki geçmiş durum değişikliklerini ve olay günlüklerini sorgulayın.

Ön koşullar

Home MCP sunucusunu kurmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Google Home'da bağlı cihazların bulunduğu 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ırma

MCP sunucusunu kurmak 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

Google Cloud hesabınız yoksa bir 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 konsolunun 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-postasını doldurun.
  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. Uygulama türü'nü 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 kurulumunuz tarafından belirtilen yönlendirme URI'si
    5. Create'i (Oluştur) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret (İstemci Gizli Anahtarı) değerlerinizi güvenli bir konuma kopyalayın.
  3. Uygulamanızı yayınlama:
    1. Google Auth Platform > Kitle'yi açın.
    2. Yayınlama durumu bölümünde Uygulamayı yayınla'yı tıklayın.

Yapay zeka istemcinizi yapılandırma

Home MCP sunucusuna OAuth kimlik doğrulaması kullanarak bağlanmak için çeşitli yapay zeka geliştirme ortamlarını 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ı doğrudan sohbetten yönetmeyi destekliyorsa aşağıdaki istemi yapıştırarak asistanınıza sunucuyu yapılandırma talimatı verebilirsiniz:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://home.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 sunar.

  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 nesnesinin 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 izin akışını tamamlayın, ev yapınızı seçin ve yetkilendirme kodunu kopyalayıp Antigravity'ye yapıştırın.

Daha fazla bilgi için Google Antigravity belgelerine göz atı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. Advanced settings'i (Gelişmiş ayarlar) tıklayın ve Client ID (İstemci Kimliği) ile Client Secret'ı (İstemci Gizli Anahtarı) 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 Platform belgelerine bakın.

OpenClaw

OpenClaw'u, OAuth kimlik doğrulamasıyla 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. Terminalinizde yapılandırma yamasını 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 takip edin.

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

Kullanıcıların, Home MCP'deki tanıdık yüz verilerine erişmek için bu özelliğe ayrıca açıkça izin vermesi 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 her kamera veya kapı zili için Tanıdık yüz algılama özelliği etkinleştirilmiş etkin bir Google Home Premium aboneliği olmalıdır.
  • Uygulamanızın 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 Yapay zeka 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ı iki şekilde alabilirsiniz.

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

Temsilciniz Home MCP'ye zaten 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 temsilcinizin sohbetine yapıştırın.

  • CLIENT_ID: Google Cloud adresindeki 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 Home MCP'ye zaten 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'ten OAuth 2.0 istemci kimliğiniz. Örneğin, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: Hedef Home yapısının UUID'si. Bunu öğrenmenin en kolay yolu, Home MCP'yi kullanan temsilcinize "[Yapı Adı] için yapı kimliğini (UUID) söyle" demektir.
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şlevleri 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 uygulamasının etkin araçlar arasında listelendiğini onaylayı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?
    • Gerçek zamanlı 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 ev telemetrinize dayalı olur.

Destek

Home 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 gönderebilir veya daha önce gönderilen sorulara göz atarak sorunuzun yanıtlanıp yanıtlanmadığını kontrol edebilirsiniz.

MCP ile ilgili hata bildiriminde bulunmak veya özellik isteği göndermek için herkese açık sorun izleyicimize gidin.

Bilinen sorunlar

  • Yararlanma Hakkı Yaptırımı: Ana MCP erişimi, Google Home Premium Advanced aboneliği olan kullanıcılarla kısıtlanmalıdır. Şu anda bir hata nedeniyle Nest Aware Plus aboneleri Home MCP'ye erişebiliyor. Bu sorunu çözmek için çalışıyoruz. Kısa süre içinde bir düzeltme yayınlanacak.
  • Özellik Testi: Temsilcileriniz için en geniş işlev kümesini sağlamak amacıyla deneysel olarak işaretlenmiş bazı özellikler ekledik. Bu deneysel özelliklerin beklendiği gibi çalışmadığı durumlarla karşılaşabilirsiniz. Bu durumda, bildirmek için lütfen herkese açık Issue Tracker'ı kullanın.
  • Gecikme: Bazen Home MCP'de beklenenden daha uzun gecikme süresiyle karşılaşabilirsiniz. Optimizasyon çalışmalarımız devam ediyor. Gelecekteki sürümlerde gecikme süresinde iyileştirmeler yapılacaktır.

Çok Yakında

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