Server MCP Google Home

   Akses Awal   

Server Model Context Protocol (MCP) Google Home memungkinkan alat developer 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. Home MCP menerapkan pembatasan kapasitas 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 kebijakan dan persyaratan layanan developer dengan cermat.

Jika Anda memilih untuk menghubungkan Google Home yang digunakan oleh anggota keluarga lain dengan Home MCP, 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 smart home real-time dan mengeluarkan perintah.

Kemampuan inti

Server MCP Home menyediakan beberapa area kemampuan inti:

  • Penemuan struktur: Ambil 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 dan status karakteristik secara real-time menggunakan list_home_states.
  • Kontrol perangkat: Menjalankan perintah tindakan berparameter di perangkat target menggunakan run_home_actions.
  • Analisis historis: Buat 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 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 belum memiliki Google Cloud, Anda harus membuatnya:

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

Untuk mengetahui informasi selengkapnya, lihat artikel Membuat project di 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 Enable.
  1. Konfigurasikan layar izin OAuth:
    1. Buka APIs & Services > Layar izin OAuth.
    2. Pilih audiens External, klik Get started, lalu isi informasi aplikasi dan email kontak yang diperlukan.
  2. Buat client ID OAuth:
    1. Buka APIs & Services > Credentials.
    2. Klik + Create credentials, lalu pilih OAuth client ID.
    3. Tetapkan Application type ke aplikasi web.
    4. Tambahkan URI pengalihan yang diizinkan 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 Create dan 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 Rahasia Klien OAuth Anda di sini, lalu ikuti petunjuk penyiapan yang Anda inginkan.

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 untuk mengonfigurasi server dengan menempelkan perintah berikut:

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

Penyiapan manual

Pilih alat AI yang Anda inginkan untuk mendapatkan 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: Settings > Advanced settings > Customizations > Open MCP Config.

  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 Settings > Advanced settings > Customizations > home_mcp > Authentication.

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

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Google Antigravity.

Claude

Konfigurasikan 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 Advanced settings, lalu masukkan Client ID dan Client Secret Anda.
  5. Klik Add dan selesaikan alur otorisasi OAuth di browser Anda.
  6. Dalam chat Cowork, klik + di pojok kiri bawah, pilih Connectors, dan aktifkan home_mcp.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Claude Platform.

OpenClaw

Konfigurasikan 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 dikenali di MCP Home, pengguna harus secara eksplisit menyetujui fitur ini secara terpisah.

Prasyarat

  • Pengguna yang memberikan izin harus merupakan pengelola struktur Google Home.
  • Struktur pengguna harus memiliki setidaknya satu kamera atau bel pintu Google Nest yang kompatibel dan langganan Google Home Premium 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 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 Home MCP, agen tersebut dapat otomatis menemukan ID Struktur Home Anda dan membuat link yang siap diklik.

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

  • CLIENT_ID — Client ID OAuth 2.0 Anda dari Google Cloud. Misalnya, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME — Nama struktur Home target.
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 Home MCP, agen tersebut dapat otomatis menemukan ID Struktur Home Anda 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 struktur Home target. Cara termudah untuk mendapatkannya adalah dengan bertanya kepada agen Anda menggunakan MCP Home, "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. Luncurkan sesi asisten AI atau ruang kerja Anda.
  2. Periksa koneksi server MCP yang aktif (di Antigravity, jalankan /mcp atau periksa daftar alat).
  3. Pastikan home_mcp tercantum dengan alat aktif.

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

    • Penemuan entity: 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 mendapatkan 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 mengetahui apakah pertanyaan Anda sudah dijawab.

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

Masalah Umum

  • Penegakan Hak — Akses MCP Home harus dibatasi untuk pengguna dengan langganan Google Home Premium Advanced. Saat ini, ada bug yang memungkinkan pelanggan Nest Aware Plus memiliki akses Home MCP. Kami sedang berupaya mengatasi masalah ini dan perbaikan akan segera dirilis.
  • Pengujian Karakteristik — Untuk menyediakan serangkaian fungsi terluas bagi agen Anda, kami telah menyertakan beberapa karakteristik yang ditandai sebagai eksperimental. Anda mungkin mengalami skenario saat karakteristik 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 Home MCP. Kami sedang berupaya secara aktif untuk 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 untuk merilis dukungan otomatisasi dalam rilis mendatang.