Server MCP Google Home

   Akses Awal   

Server Model Context Protocol (MCP) Google Home memungkinkan alat pengembangan dan asisten virtual yang didukung AI berinteraksi langsung dengan lingkungan smart home. Dengan mengekspos alat MCP standar dan antarmuka RPC, server memungkinkan Model Bahasa Besar (LLM) memeriksa struktur rumah, memantau status perangkat, menjalankan tindakan kontrol, dan menganalisis peristiwa historis.

Peringatan!

Menghubungkan rumah di dunia nyata ke agen AI memungkinkan agen tersebut mengontrol perangkat atas nama Anda. MCP Rumah menerapkan batas frekuensi dan perlindungan keamanan, seperti melarang tindakan sensitif seperti membuka kunci pintu. Namun, bergantung pada agen Anda, menghubungkannya ke Home MCP dapat menyebabkan perilaku yang tidak terduga atau bahkan tidak diinginkan. Tinjau dengan cermat kebijakan developer dan persyaratan layanan.

Jika Anda memilih untuk menghubungkan Google Home yang digunakan oleh anggota keluarga lain dengan MCP Home, Anda harus memberi tahu mereka bahwa agen Anda dapat mengontrol perangkat dan mengakses data rumah. Atau, Anda dapat membuat rumah tambahan dan menyiapkan perangkat untuk pengembangan dan pengujian.

Akses agen Anda ke Home MCP dapat dicabut kapan saja dari Google Home app (GHA) atau halaman Akun Saya.

Ringkasan

Server MCP bertindak sebagai proxy antara infrastruktur smart home dan aplikasi AI. Server MCP Home mengekspos alat yang dapat dieksekusi yang memungkinkan klien AI mengkueri telemetri rumah real-time dan mengeluarkan perintah.

Kemampuan inti

Server MCP Home menyediakan beberapa area kemampuan inti:

  • Penemuan struktur: Mengambil rumah dan struktur yang dapat diakses menggunakan list_homes.
  • Penemuan resource: Mencantumkan perangkat, tata letak area, trait, atribut, dan skema perintah menggunakan list_home_resources.
  • Pemantauan status: Periksa status konektivitas perangkat real-time dan status karakteristik menggunakan list_home_states.
  • Kontrol perangkat: Menjalankan perintah tindakan berparameter pada perangkat target menggunakan run_home_actions.
  • Analisis historis: Kueri perubahan status dan log peristiwa sebelumnya selama rentang waktu tertentu menggunakan list_home_history.

Prasyarat

Sebelum menyiapkan server MCP Home, pastikan Anda memiliki hal berikut:

  • Penyiapan smart home yang aktif di Google Home dengan perangkat yang terhubung.
  • Langganan Google Home Premium Advanced yang aktif.
  • Akses ke project Google Cloud.
  • Klien atau aplikasi AI yang kompatibel dengan MCP, seperti Google Antigravity, Claude Cowork, atau OpenClaw.

Mengonfigurasi server MCP

Penyiapan server MCP memerlukan pembuatan project Google Cloud, mendapatkan persetujuan akses, mengaktifkan Home API, dan membuat kredensial OAuth.

Membuat project Google Cloud

Jika Anda belum memiliki Google Cloud, Anda harus membuatnya:

  1. Buka konsol Google Cloud.
  2. Buat project Google Cloud baru.

Untuk mengetahui informasi selengkapnya, lihat artikel Membuat project dalam dokumentasi Google Cloud.

Mengaktifkan Home API

  1. Di menu navigasi konsol Google Cloud, pilih APIs & Services > Enabled APIs & Services.
  2. Telusuri Home API, lalu klik Aktifkan.
  1. Mengonfigurasi layar izin OAuth:
    1. Buka APIs & Services > Layar izin OAuth.
    2. Pilih audiens Eksternal, klik Mulai, lalu isi informasi aplikasi dan email kontak yang diperlukan.
  2. Buat client ID OAuth:
    1. Buka APIs & Services > Credentials.
    2. Klik + Buat kredensial, lalu pilih ID klien OAuth.
    3. Tetapkan Application type ke aplikasi web.
    4. Tambahkan URI pengalihan yang diberi otorisasi yang sesuai dengan klien AI target Anda:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: URI pengalihan yang ditentukan oleh penginstalan OpenClaw lokal Anda
    5. Klik Buat, lalu salin Client ID dan Client Secret Anda ke lokasi yang aman.
  3. Publikasikan aplikasi Anda:
    1. Buka Google Auth Platform > Audience.
    2. Di bagian Status publikasi, klik Publikasikan aplikasi.

Mengonfigurasi klien AI Anda

Anda dapat mengonfigurasi beberapa lingkungan pengembangan AI untuk terhubung ke server MCP Home menggunakan autentikasi OAuth. Masukkan Client ID dan Client Secret OAuth Anda di sini, lalu ikuti petunjuk penyiapan pilihan Anda.

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

Penyiapan otomatis menggunakan perintah

Jika asisten AI Anda mendukung pengelolaan konfigurasi alat MCP langsung dari chat, Anda dapat menginstruksikan asisten Anda untuk mengonfigurasi server dengan menempelkan perintah berikut:

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

Penyiapan manual

Pilih alat AI pilihan Anda untuk petunjuk penyiapan manual.

Antigravity

Google Antigravity menyediakan integrasi bawaan untuk server MCP di seluruh lingkungan CLI, IDE, dan desktop-nya.

  1. Buka menu konfigurasi aplikasi: Setelan > Setelan lanjutan > Penyesuaian > Buka Konfigurasi MCP.

  2. Tambahkan entri home_mcp di bawah objek konfigurasi mcpServers:

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

  3. Selesaikan autentikasi: Buka Setelan > Setelan lanjutan > Penyesuaian > home_mcp > Autentikasi.

  4. Selesaikan alur izin Google Home di browser web Anda, pilih struktur rumah Anda, dan salin kembali kode otorisasi ke Antigravity.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Google Antigravity.

Claude

Konfigurasi Claude Cowork untuk terhubung ke server MCP rumah kustom Anda:

  1. Buka Claude Connectors.
  2. Klik +, lalu pilih Tambahkan konektor kustom.
  3. Masukkan URL server: https://home.googleapis.com/mcp.
  4. Klik Setelan lanjutan, lalu masukkan Client ID dan Client Secret Anda.
  5. Klik Tambahkan dan selesaikan alur otorisasi OAuth di browser Anda.
  6. Dalam chat Cowork, klik + di pojok kiri bawah, pilih Konektor, lalu aktifkan home_mcp.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Claude Platform.

OpenClaw

Konfigurasi OpenClaw untuk terhubung ke transport SSE jarak jauh dengan autentikasi OAuth:

  1. Siapkan blok JSON patch konfigurasi:

    {
  "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. Terapkan patch konfigurasi di terminal Anda:

    openclaw config patch --stdin

  3. Mulai ulang gateway OpenClaw:

    openclaw gateway restart

  4. Mulai alur autentikasi:

    openclaw mcp login home_mcp

  5. Ikuti URL otorisasi yang dibuat untuk login dan memberikan akses.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi OpenClaw.

Untuk mengakses data wajah yang dikenal di MCP Rumah, pengguna harus memberikan izin eksplisit untuk fitur ini secara terpisah.

Prasyarat

  • Pengguna yang memberikan izin harus menjadi pengelola struktur Google Home.
  • Struktur pengguna harus memiliki setidaknya satu kamera atau bel pintu Google Nestyang kompatibel dan langganan Google Home Premiumyang aktif dengan Deteksi wajah yang dikenali diaktifkan untuk setiap kamera atau bel pintu.
  • Aplikasi Anda harus memiliki Client ID OAuth 2.0 yang dibuat di Google Cloud. Lihat Mengonfigurasi klien AI Anda untuk membuat Klien OAuth 2.0 jika Anda belum melakukannya.

Untuk memberikan akses ke aplikasi Anda, Anda harus membuka link izin yang dipersonalisasi dengan Client ID OAuth 2.0 dan ID Struktur Home Anda. Ada dua cara untuk mendapatkan link izin Anda.

Setelah Anda memiliki link, buka link tersebut dan berikan izin.

Jika agen Anda sudah terhubung ke MCP Home, agen tersebut dapat menemukan ID Struktur Home Anda secara otomatis dan membuat link yang siap diklik.

Perbarui parameter berikut langsung di halaman ini, lalu salin dan tempel perintah yang disesuaikan ke dalam percakapan agen Anda.

  • CLIENT_ID — Client ID OAuth 2.0 Anda dari Google Cloud. Misalnya, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME — Struktur nama target 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

Jika agen Anda sudah terhubung ke MCP Home, agen tersebut dapat menemukan ID Struktur Home Anda secara otomatis dan membuat link yang siap diklik.

Perbarui parameter berikut langsung di halaman ini, lalu buka link yang disesuaikan di browser web.

  • CLIENT_ID — Client ID OAuth 2.0 Anda dari Google Cloud. Misalnya, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID — UUID dari struktur Home target. Cara termudah untuk mendapatkan ID ini adalah dengan bertanya kepada agen Anda menggunakan MCP Rumah, "Beri tahu saya ID struktur (UUID) untuk [Nama Struktur]."
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Memverifikasi koneksi dan fungsi

Setelah klien Anda dikonfigurasi dan diautentikasi, verifikasi koneksi server:

  1. Mulai sesi ruang kerja atau asisten AI Anda.
  2. Periksa koneksi server MCP aktif (di Antigravity, jalankan /mcp atau periksa daftar alat).
  3. Pastikan home_mcp tercantum dengan alat aktif.

  4. Berikan contoh perintah kepada asisten Anda untuk menguji berbagai kemampuan:

    • Penemuan entitas: How many lights do I have in my house?
    • Pemantauan status real-time: Is my home secured?
    • Kontrol perangkat: Turn off all the outside lights.
    • Analisis peristiwa historis: What happened while I was out?

  5. Berikan izin eksekusi alat saat diminta oleh klien Anda. Asisten AI dapat mengambil data status real-time dan semua respons akan didasarkan pada telemetri rumah Anda.

Dukungan

Untuk dukungan pengembangan MCP Home, buka Komunitas Bantuan Smart Home untuk Developer. Di sana, Anda dapat memposting pertanyaan untuk mendapatkan bantuan, atau melihat pertanyaan yang telah diposting sebelumnya untuk melihat apakah pertanyaan Anda sudah dijawab.

Untuk melaporkan bug atau mengajukan permintaan fitur MCP, buka issue tracker publik kami.

Masalah Umum

  • Pengujian Karakteristik — Untuk menyediakan serangkaian fungsi terluas bagi agen Anda, kami telah menyertakan beberapa karakteristik yang ditandai sebagai eksperimental. Anda mungkin mengalami skenario saat trait eksperimental ini tidak berfungsi seperti yang diharapkan. Jika ya, gunakan issue tracker publik untuk melaporkan.
  • Latensi — Terkadang Anda mungkin melihat latensi yang lebih lama dari yang diharapkan dengan MCP Home. Kami sedang aktif berupaya melakukan pengoptimalan. Nantikan peningkatan latensi dalam rilis mendatang.

Segera Hadir

  • Otomatisasi — Membuat dan mengelola otomatisasi dengan MCP Home saat ini tidak didukung. Kami sedang mengerjakan fungsi ini dan berencana merilis dukungan otomatisasi di rilis mendatang.