Cara Menghubungkan Claude ke Home Assistant dengan MCP
Pelajari cara memakai MCP Server bawaan Home Assistant sejak 2025.2, menyiapkan alamat HTTPS publik yang aman, dan membatasi Claude ke akun khusus baca saja.
Cara menghubungkan Claude ke Home Assistant dengan MCP
Untuk menghubungkan Claude ke Home Assistant dengan MCP, aktifkan integrasi Model Context Protocol bawaan Home Assistant, lalu tambahkan alamatnya ke Claude sebagai konektor kustom. Claude kemudian masuk melalui login OAuth milik Home Assistant. OAuth adalah standar terbuka untuk memberikan akses kepada aplikasi tanpa membagikan kata sandi Anda. Home Assistant terlebih dahulu memerlukan alamat HTTPS publik. Alamat tersebut merupakan bagian pekerjaan terbesar karena Claude mengakses jaringan rumah Anda dari cloud Anthropic, bahkan saat Anda menggunakan Claude Desktop.
MCP (Model Context Protocol) adalah standar terbuka yang memungkinkan klien AI memanggil tool pada server lain. Home Assistant telah menyediakan integrasi MCP Server sejak rilis 2025.2. Tool tersebut dapat membaca status rumah Anda dan, dengan opsi yang tepat, mengendalikannya. Jadi, keputusan utamanya berkaitan dengan keamanan. Siapa yang dapat mengakses alamat yang Anda buka, dan tindakan apa yang diizinkan bagi akun di balik alamat tersebut? Jika Anda masih menentukan posisi MCP di antara cara lain untuk memperluas Claude, mulai dengan perbandingan MCP dengan keterampilan agen dan file aturan.
Panduan ini diperiksa berdasarkan dokumentasi Home Assistant, Anthropic, Tailscale, Caddy, dan Nabu Casa pada 22 November 2026. Rilis Home Assistant saat itu adalah 2026.11.2. Beberapa opsi di bawah ini baru berusia beberapa bulan, jadi perbarui Home Assistant sebelum memulai.
Mengapa Claude memerlukan Home Assistant di Internet publik
Artikel bantuan Anthropic tentang custom connector menyatakannya secara langsung: "Claude terhubung ke server MCP jarak jauh Anda dari infrastruktur cloud Anthropic, bukan dari perangkat lokal Anda." Dokumentasi Home Assistant menyatakan hal yang sama tentang aplikasi desktop: "Claude terhubung ke server MCP Anda dari cloud, termasuk saat Anda menggunakan Claude Desktop."
Dua persyaratan berlaku. Server Anda harus dapat dijangkau melalui Internet publik dari rentang IP Anthropic. Server juga harus merespons pada port HTTPS standar, 443. Oleh karena itu, http://homeassistant.local:8123 tidak pernah dapat digunakan sebagai URL connector. Server Anthropic tidak dapat me-resolve nama yang hanya ada di jaringan rumah Anda, dan port 8123 bukan 443.
Claude Desktop juga memiliki mekanisme kedua. Server MCP lokal yang tercantum dalam claude_desktop_config.json menggunakan jaringan lokal Anda. Server tersebut terpisah dari connector dan tidak tersedia di claude.ai atau dalam sesi Cowork yang berjalan di cloud. Dokumentasi Home Assistant hanya menjelaskan jalur connector untuk Claude Desktop, sehingga panduan ini menggunakan jalur tersebut.
Claude Code berbeda. Claude Code berjalan di komputer atau server Anda sendiri dan membuka koneksi MCP secara langsung, sehingga URL hanya perlu dapat dijangkau dari mesin tersebut. Home Assistant mencatat bahwa "Claude Code hanya terhubung ke server MCP melalui HTTPS". Karena itu, alamat HTTPS privat di dalam jaringan Anda sendiri juga dapat digunakan. Perbedaan antara Tailscale Serve dan Tailscale Funnel tepatnya berkaitan dengan pilihan ini: Serve menyediakan alamat HTTPS privat pada tailnet Anda, sedangkan Funnel menyediakan alamat publik.
Custom connector tersedia pada paket Free, Pro, Max, Ultra, Team, dan Enterprise. Pengguna Free dibatasi hingga satu custom connector. Batas tersebut termasuk dalam hal-hal yang termasuk dalam paket Claude Free.
Aktifkan integrasi MCP Server
- Di Home Assistant, buka Settings > Devices & services, lalu pilih Add Integration.
- Pilih Model Context Protocol dari daftar, lalu ikuti langkah yang ditampilkan di layar.
- Buka Settings > System > AI. Jika kartu Model Context Protocol menampilkan tombol Enable, pilih tombol tersebut.
- Salin Main URL. Path-nya adalah
/api/mcp.
URL konektor lengkap terdiri atas hostname publik dan path tersebut, misalnya https://ha.example.com/api/mcp. Hostname bergantung pada jalur akses yang Anda pilih pada bagian berikutnya.
Yang diekspos URL utama secara default
URL utama memiliki tiga opsi, dan opsi tersebut hanya berlaku untuk /api/mcp. Baca semuanya sebelum menghubungkan apa pun.
- Expose all AI tools aktif secara default. URL utama kemudian mengekspos setiap set alat, termasuk set yang ditambahkan oleh integrasi pada waktu berikutnya. Salah satu set tersebut bernama Home Assistant. Set ini dapat membaca semua entitas, log, dan histori, serta menjalankan tindakan apa pun.
- Require an administrator account aktif secara default. Jika URL utama mengekspos set Home Assistant, akun administrator selalu diperlukan, apa pun nilai switch ini.
- Read-only nonaktif secara default. Jika diaktifkan, URL utama hanya mengekspos alat yang ditandai tidak mengubah apa pun, seperti mengambil status rumah saat ini.
- Penyiapan yang lebih lama membuat dua switch ini nonaktif. Untuk Expose all AI tools, dokumentasi menyatakan bahwa opsi tersebut "tetap nonaktif agar klien Anda tetap menggunakan set alat AI yang Anda pilih." Switch administrator "tetap nonaktif agar klien Anda tetap berfungsi." Jika entri MCP Server Anda lebih lama daripada opsi ini, buka opsinya dan periksa nilainya.
Nonaktifkan Expose all AI tools untuk memilih set alat satu per satu. Set Device control memberikan AI alat yang sama seperti voice assistant Anda, dan set ini "hanya mengakses entitas yang Anda ekspos ke voice assistant." Set Home Assistant tidak memiliki batasan tersebut.
Ada juga URL terpisah untuk satu set alat. /api/mcp/assist hanya mengekspos Device control. URL ini mengabaikan tiga opsi di atas. URL tersebut tidak pernah bersifat read-only. Semua URL tersebut, kecuali URL Device control, memerlukan akun administrator.
Periksa entitas yang dapat dijangkau Device control sebelum mempercayainya. Assist secara default mengekspos entitas baru, termasuk covers. Dokumentasi Home Assistant menjelaskannya secara spesifik: "Covers mencakup pintu garasi dan gerbang, sehingga Home Assistant juga mengeksposnya secara otomatis." Locks, alarm panels, dan scripts tidak diekspos secara otomatis. Buka pengaturan eksposur Assist dan hapus entitas apa pun yang tidak ingin Anda izinkan untuk dibuka oleh jendela chat.
Gunakan akun khusus, bukan akun pemilik
Saat Anda memilih Connect di Claude, Anda login ke Home Assistant melalui browser. Akses yang diterima Claude berasal dari akun yang Anda gunakan untuk login. Jika Anda login sebagai pemilik, Claude bertindak sebagai pemilik dan memiliki semua hak pemilik.
Buat person terpisah di Home Assistant dengan login sendiri, lalu gunakan akun itu hanya untuk Claude. Untuk mencabut akses Claude nanti, hapus akun tersebut. Login Anda sendiri tidak akan terpengaruh. Selanjutnya, pilih salah satu dari dua konfigurasi berikut.
Terbatas: Claude mengontrol beberapa perangkat. Pertahankan akun tersebut sebagai pengguna biasa, bukan administrator. Pada opsi URL utama, nonaktifkan Expose all AI tools, pilih hanya Device control, dan nonaktifkan Require an administrator account. Claude kemudian hanya dapat mengakses entitas yang diekspos ke voice. Aktifkan Read-only juga jika Claude hanya boleh melaporkan status. Anda juga dapat menggunakan /api/mcp/assist, yang tidak memerlukan administrator. Namun, URL tersebut mengabaikan pengaturan Read-only.
Luas: Claude membaca log dan riwayat. Kumpulan tool Home Assistant selalu memerlukan akun administrator. Jadikan akun khusus tersebut sebagai administrator, tetap pisahkan dari akun pemilik, lalu aktifkan Read-only. Claude kemudian dapat membaca entitas, log, dan riwayat. Tool yang mengubah sesuatu tidak akan diekspos.
Saat melakukan langkah Connect, periksa akun yang Anda gunakan untuk login. Lakukan langkah tersebut di jendela browser privat agar sesi pemilik tidak digunakan kembali secara tidak sengaja.
Jangan mengandalkan permintaan persetujuan di client sebagai perlindungan. Dalam alur connector, dokumentasi Home Assistant menyatakan bahwa Claude meminta izin sebelum memanggil tool, kecuali Anda memilih untuk selalu mengizinkannya. Claude Code berbeda. Mulai v2.1.283, auto mode menjadi mode izin awal untuk sesi terminal interaktif dan VS Code, dan auto mode tidak meminta persetujuan sebelum setiap tindakan. Home Assistant sendiri tetap menerapkan hak akun dan pengaturan Read-only, terlepas dari keputusan client.
Bagaimana cloud Claude dapat mengakses Home Assistant?
Bagian ini merupakan model ancaman yang disusun khusus untuk panduan ini berdasarkan dokumentasi setiap layanan. Anggap perbandingan keamanan di bawah ini sebagai hasil penalaran, bukan klaim vendor.
Semua jalur di bawah memiliki satu kesamaan: siapa pun yang dapat mengakses URL tersebut dapat mengakses halaman login Home Assistant. Jadi, siapkan perlindungan login terlebih dahulu. Di Settings > System > Network, pada bagian HTTP server, aktifkan Enable IP banning. Kemudian atur Login attempts before ban, yang menerima nilai 1 hingga 1000 dan hanya muncul jika Unlimited login attempts dinonaktifkan. Di balik proxy atau tunnel apa pun, aktifkan juga Trust X-Forwarded-For dan tambahkan alamat proxy ke Trusted proxies. Dokumentasi Home Assistant memperingatkan: "Requests from reverse proxies are blocked if these options are not set." Sebelum Home Assistant 2026.8, pengaturan ini berada di blok http: pada configuration.yaml.
Contoh di bawah menggunakan port Home Assistant 8123. Sejak Home Assistant 2026.8, nilai defaultnya adalah 80 pada Home Assistant Operating System dan 8123 pada Container. Jadi, ganti 8123 dengan port yang Anda konfigurasi di setiap kemunculannya.
UI jarak jauh Nabu Casa (Home Assistant Link)
Nama layanan Nabu Casa sekarang adalah Home Assistant Link (sebelumnya Home Assistant Cloud). Pada 15 November 2026, halaman harganya mencantumkan $6.50 USD per bulan atau $65.00 USD per tahun, belum termasuk pajak. Halaman tersebut juga mencantumkan uji coba gratis selama 31 hari yang tidak memerlukan kartu. Akses jarak jauh merupakan salah satu manfaat yang tercantum.
Yang diekspos: seluruh antarmuka web Home Assistant dan halaman login Anda pada alamat HTTPS publik. Yang tidak dicakup: password lemah pada akun yang digunakan Claude atau token yang bocor dari tempat lain. Dokumentasi dukungan Nabu Casa menyatakan bahwa akses jarak jauh menggunakan enkripsi end-to-end, dengan private key yang hanya disimpan pada sistem Home Assistant Anda. Jadi, relay-nya tidak dapat membaca data Anda.
Tailscale Funnel
Funnel merutekan trafik dari Internet publik ke layanan lokal, dan Tailscale menyatakan bahwa fitur ini tersedia pada semua paket. Fitur ini memerlukan Tailscale v1.38.3 atau yang lebih baru, MagicDNS, sertifikat HTTPS yang valid untuk tailnet Anda, serta atribut funnel node dalam file kebijakan tailnet Anda. Fitur ini hanya dapat listen pada port 443, 8443, dan 10000. Port 443 adalah port yang diperlukan Claude. Jika persyaratan tersebut masih baru bagi Anda, penjelasan tentang Tailscale dan cara kerja tailnet menjelaskannya. Pada mesin yang menjalankan Home Assistant, jalankan:
sudo tailscale funnel 8123Tailscale menampilkan alamat publik https://<machine>.<tailnet>.ts.net yang mem-proxy ke http://127.0.0.1:8123. Gunakan hostname tersebut dalam URL connector. Tambahkan 127.0.0.1 ke Trusted proxies di Home Assistant karena setiap request sekarang berasal dari proxy Tailscale lokal. Perintah tersebut berjalan di foreground sampai Anda menekan Ctrl+C.
Yang diekspos: seluruh port Home Assistant kepada siapa pun di Internet. Pengunjung Funnel tidak memerlukan Tailscale, sehingga tailnet privat Anda tidak memberi mereka penghalang tambahan. Trafik Funnel juga memiliki batas bandwidth yang tidak dapat Anda konfigurasi.
Cloudflare Tunnel
Cloudflare Tunnel menggunakan koneksi outbound-only. Daemon cloudflared di dalam jaringan Anda terhubung keluar ke Cloudflare. Dengan demikian, Anda tidak perlu membuka port inbound atau memiliki IP publik di rumah.
Yang diekspos: hostname yang Anda publikasikan kepada seluruh Internet, kecuali Anda menambahkan aturan di depannya. Aturan yang mengharuskan seseorang login ke Cloudflare terlebih dahulu harus mengizinkan rentang IP yang dipublikasikan Anthropic. Cloud Claude tidak dapat mengisi halaman login, sehingga request MCP-nya akan berhenti di Cloudflare. Tambahkan alamat yang digunakan cloudflared untuk mengakses Home Assistant ke Trusted proxies.
Reverse proxy pada VPS
Dengan jalur ini, Anda mengendalikan server yang menghadap ke Internet. VPS kecil (virtual private server) dengan IP publik menjalankan reverse proxy dan mengakses Home Assistant di rumah melalui koneksi privat seperti tailnet. Tidak ada layanan di rumah yang dibuka ke Internet. Anda juga dapat membatasi pihak yang dapat mengakses proxy.
Anthropic memublikasikan alamat IP yang digunakan untuk request outbound, "for example, when making MCP tool calls to external servers." Pada 15 November 2026, halaman tersebut mencantumkan dua rentang IPv4 outbound dalam format CIDR dan tidak mencantumkan rentang IPv6 outbound. Salin rentang terbaru dari halaman alamat IP Anthropic pada hari Anda menyiapkan konfigurasi ini. Halaman tersebut juga mencantumkan alamat lama yang sudah tidak digunakan, jadi ambil hanya alamat outbound yang masih berlaku.
Dengan Caddy terpasang pada VPS, /etc/caddy/Caddyfile dapat menolak setiap koneksi yang tidak berasal dari rentang tersebut:
ha.example.com {
@blocked not remote_ip <anthropic-range-1> <anthropic-range-2> 203.0.113.25
abort @blocked
reverse_proxy 100.101.102.103:8123
}Ganti <anthropic-range-1> dan <anthropic-range-2> dengan rentang IPv4 outbound dari halaman Anthropic, 203.0.113.25 dengan IP publik Anda sendiri, dan 100.101.102.103 dengan alamat Home Assistant pada tailnet Anda. IP Anda sendiri dimasukkan ke dalam daftar karena langkah Connect membuka halaman login Home Assistant di browser Anda. Request tersebut berasal dari Anda, bukan dari Anthropic. Jika Connect berhenti pada halaman yang tidak pernah dimuat, alamat Anda tidak ada dalam daftar. Caddy menetapkan header X-Forwarded-For, X-Forwarded-Proto, dan X-Forwarded-Host secara default, serta mem-proxy koneksi WebSocket. Caddy juga memperoleh sertifikat TLS (transport layer security) untuk hostname tersebut, selama record DNS hostname mengarah ke VPS dan Caddy dapat menyelesaikan challenge validasi dari certificate authority.
caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddycaddy validate seharusnya selesai tanpa error. Dari alamat yang tidak ada dalam daftar, curl -I https://ha.example.com/ seharusnya tidak menerima respons HTTP sama sekali karena abort menutup koneksi. Terakhir, tambahkan alamat tailnet VPS ke Trusted proxies di Home Assistant.
Yang tidak dilindungi: setiap pengguna Claude berbagi rentang IP Anthropic. Allowlist mencegah scanner acak mengakses server. Siapa pun yang mengetahui URL Anda dan menambahkannya sebagai connector mereka sendiri tetap dapat mengakses halaman login Anda. Karena itu, password akun dan pemblokiran IP tetap penting. Anda juga sekarang memiliki VPS yang harus selalu diperbarui keamanannya.
Jalur yang sebaiknya dipilih
Nabu Casa memiliki pengaturan paling singkat dan tidak memerlukan server milik Anda sendiri. Funnel dan Cloudflare Tunnel menghindari pembukaan port di rumah, tetapi keduanya menempatkan seluruh halaman login di Internet terbuka. Proxy VPS memerlukan pekerjaan paling banyak dan memiliki permukaan eksposur paling kecil karena hanya rentang Anthropic dan alamat Anda sendiri yang dapat membuka koneksi. Pada semua jalur, akun khusus dan switch Read-only memberikan perlindungan yang lebih besar daripada pilihan jalurnya.
Tambahkan konektor di Claude
- Di claude.ai, buka Customize > Connectors, lalu pilih + Add > Add custom connector. Di Claude Desktop, dokumentasi Home Assistant mencantumkan Settings > Connectors, lalu Add > Add custom connector.
- Beri nama
Home Assistantdan tempel URL lengkap, misalnyahttps://ha.example.com/api/mcp. Kirim URL tersebut agar Claude dapat memeriksa server dan menampilkan pengaturan autentikasinya. - Atur Authentication ke Sign in now dan OAuth client ke Use Claude's published identity, lalu pilih Add.
- Di halaman konektor baru, pilih Connect dan login ke Home Assistant menggunakan akun khusus tersebut.
Pada paket Team atau Enterprise, Owner menambahkan konektor melalui Organization settings > Connectors. Setiap anggota kemudian menemukannya melalui Customize > Connectors dan memilih Connect, sehingga setiap anggota menjalani proses login ke Home Assistant.
Anda memilih identitas yang dipublikasikan karena cara Home Assistant menangani OAuth. Home Assistant mengimplementasikan OAuth 2.0 dengan PKCE (proof key for code exchange). Home Assistant mendukung OAuth Client ID Metadata Documents, sehingga client ID dan URL callback dikonfigurasi secara otomatis. Home Assistant tidak menggunakan client secret. Home Assistant juga tidak mendukung RFC 7591 Dynamic Client Registration, dan dokumentasinya menyatakan bahwa client yang mewajibkan fitur tersebut secara ketat "cannot register automatically." Untuk MCP client lainnya, dokumentasi menyatakan bahwa Client ID harus berupa base URL aplikasi client, "never your Home Assistant instance URL."
Tambahkan Home Assistant ke Claude Code
claude mcp add --transport http home-assistant https://ha.example.com/api/mcp
claude mcp login home-assistantclaude mcp login menjalankan alur OAuth server dari shell Anda. Perintah ini juga menerima --no-browser untuk sesi SSH pada server jarak jauh. Secara default, claude mcp add menggunakan scope lokal, yang membatasi server pada project saat ini di mesin ini. Tambahkan --scope user agar server tersedia di setiap project. Di dalam Claude Code, /mcp menampilkan apakah server terhubung. Jika Claude Code berjalan di Linux dan Anda belum menyiapkannya, proses instalasi dibahas dalam menjalankan Claude di desktop Linux dan CLI.
Token berumur panjang atau OAuth: apa yang dimaksud panduan lama?
Panduan lama menginstruksikan Anda untuk membuat access token berumur panjang. Hal itu benar ketika panduan tersebut ditulis. Tidak ada satu rilis Home Assistant yang mengubah token menjadi OAuth secara langsung. Perubahan tersebut terjadi secara bertahap:
- Dokumentasi MCP Server pertama, yang ditulis untuk 2025.2, menyatakan: "Untuk saat ini, kita dapat menggunakan Long-lived access token untuk mengontrol akses ke API."
- PKCE dengan metode S256 pertama kali muncul dalam source Home Assistant pada tag 2026.10.0. Fitur tersebut belum ada dalam source pada 2026.9.0.
- Halaman MCP Server saat ini tidak menyebutkan token berumur panjang.
Panduan yang menempelkan token ke request header menjelaskan konfigurasi yang lebih lama. Gunakan langkah-langkah OAuth terbaru di atas.
Kapan server komunitas ha-mcp menjadi pilihan yang lebih baik?
ha-mcp adalah proyek terpisah dengan lisensi MIT. README pada tag v9.2.0 mencantumkan 87 alat. README pada branch default saat ini juga mencantumkan 87 alat; README v9.3.0.dev3663 sebelumnya mencantumkan 86, sehingga jumlahnya dapat berubah antarbuid. Pilih ha-mcp jika Anda menginginkan daftar alat yang lebih besar dan dirancang khusus dibandingkan set alat bawaan, serta menerima model kredensial yang berbeda.
Instalasi yang direkomendasikan pada v9.2.0 adalah integrasi HA-MCP. Integrasi ini berjalan di dalam Home Assistant dan memerlukan Home Assistant 2026.8.0 atau yang lebih baru. Pada versi 2026.8 hingga 2026.10, instal melalui HACS (Home Assistant Community Store). Mulai 2026.11, integrasi ini tersedia di Settings > Marketplace. Setelah melakukan restart, tambahkan HA-MCP Server melalui Settings > Devices & services > Add Integration. Integrasi ini berjalan dengan izin administrator, dan dokumentasinya sendiri merekomendasikan akun HA-MCP khusus. Proyek ini juga menyediakan image Docker, paket PyPI, dan aplikasi Home Assistant (add-on). README-nya menjelaskan mode stdio lokal yang hanya digunakan untuk pengujian.
Tetapkan rilis stabil
Pada 22 November 2026, rilis stabil terbaru adalah v9.2.0, yang diterbitkan pada 11 November. Build pengembangan (.devN) diterbitkan setiap kali ada push ke master. Anjuran dari proyek ini jelas: "Rilis pengembangan (.devN) dapat mengandung bug. Untuk penggunaan produksi, gunakan rilis stabil." Instal rilis v9.2.0, bukan build .devN. Tag image Docker :latest dan :stable mengikuti rilis stabil dan tidak pernah mengikuti build pengembangan. Jika Anda menjalankannya dengan uvx, perintah dalam README berakhir dengan @latest. Ganti dengan @9.2.0, karena sintaks @ milik uv memerlukan versi yang tepat. Paket PyPI memerlukan Python 3.13 atau 3.14.
URL private_ adalah kata sandi
Server bawaan mengharuskan Claude login. Dalam mode URL rahasia ha-mcp, login tidak diperlukan. Pada jaringan Anda, alamatnya tampak seperti http://<ha-ip>:9584/private_<random>. Dari jarak jauh, alamat tersebut berupa URL webhook seperti https://<your-ha-domain>/api/webhook/<webhook-id>. Dokumentasi proyek menyatakan bahwa "path adalah kredensial", dan meminta Anda untuk "Perlakukan URL seperti kata sandi: jangan membagikannya atau menempelkannya di tempat yang dapat mencatatnya." Siapa pun yang memiliki URL lengkap dapat mengakses server MCP Anda, tanpa halaman login di antaranya.
Hal ini mengubah model ancamannya. URL yang ditempelkan ke chat bersama atau tertinggal dalam log proxy memberikan akses penuh. Jika URL bocor, buat ID webhook baru untuk menggantikannya. Tambahkan /readonly di akhir endpoint untuk memperoleh koneksi yang menyembunyikan alat tulis dan memblokir panggilan tulis. Kredensial yang sama tetap berfungsi pada endpoint normal, sehingga sufiks ini tidak membatasi akses yang dimiliki seseorang yang mengetahui URL tersebut. Akses jarak jauh dapat dilakukan melalui remote UI Nabu Casa atau reverse proxy yang sudah Anda jalankan. Untuk Cloudflare Tunnel, README mengarahkan Anda ke Setup Wizard.
ha-mcp juga memiliki mode OAuth yang berlabel beta. Mode ini tetap meminta setiap pengguna menempelkan access token Home Assistant berumur panjang ke formulir persetujuan. Mekanismenya berbeda dari login server bawaan. Integrasi ini juga menyediakan ha_auth, yang menggunakan sign-in milik Home Assistant dan hanya menerima akun administrator.
Mengapa connector gagal masuk?
Halaman login tidak pernah muncul, atau Claude menyatakan bahwa server tidak dapat dijangkau. Cloud Anthropic tidak dapat menjangkau URL tersebut. Uji URL pada port 443 dari jaringan di luar rumah Anda, lalu periksa allowlist jika Anda menggunakannya.
Login gagal dengan error OAuth di balik proxy. Dokumentasi Home Assistant menyebutkan penyebabnya: header reverse proxy (X-Forwarded-Host, X-Forwarded-Proto) tidak ada atau tidak sesuai. Dokumentasi tersebut juga menyatakan bahwa "Klien OAuth yang sesuai standar menolak metadata ini." URL yang dibuat Home Assistant harus sama persis dengan hostname dan scheme yang digunakan Claude. Perbaiki header proxy dan pengaturan Trusted proxies.
Permintaan ke /register menghasilkan 404. Klien mencoba Dynamic Client Registration, yang tidak didukung Home Assistant. Di Claude, atur klien OAuth ke Use Claude's published identity.
Masalah terbuka yang sudah diketahui. Pada 15 November 2026, issue #183050 melaporkan connector claude.ai yang gagal terhubung ke /api/mcp pada Core 2026.11.0. Masalah ini masih terbuka dan ditandai sebagai memerlukan informasi lebih lanjut. Belum ada perbaikan yang dikonfirmasi. Uji connector sebelum mengandalkannya.
FAQ
Apakah Claude Desktop terhubung ke Home Assistant dari komputer saya sendiri?
Tidak untuk connector kustom. Anthropic dan Home Assistant sama-sama menyatakan bahwa Claude terhubung dari cloud Anthropic, termasuk saat digunakan melalui Claude Desktop. Karena itu, Home Assistant memerlukan alamat HTTPS publik pada port 443. Pengecualiannya adalah server lokal dalam claude_desktop_config.json dan Claude Code, yang terhubung dari komputer Anda sendiri.
Apakah Claude dapat membuka pintu garasi melalui Home Assistant MCP?
Ya, jika akun dan kumpulan tool mengizinkannya. Assist secara default mengekspos cover baru, dan cover mencakup pintu garasi serta gerbang, sehingga kumpulan tool Device control biasanya dapat mengaksesnya. Kumpulan tool Home Assistant dapat melakukan tindakan apa pun. Jika Claude tidak boleh menggerakkannya, hapus entitas tersebut dari eksposur Assist atau aktifkan Read-only untuk URL utama.
Apakah saya masih memerlukan long-lived access token untuk server Home Assistant MCP?
Tidak untuk server bawaan. Dokumentasi saat ini menggunakan OAuth 2.0 dengan PKCE dan tidak menyebutkan long-lived token. Token merupakan metode dalam dokumentasi pertama pada 2025.2. Server komunitas ha-mcp berbeda: mode beta OAuth-nya masih meminta Anda menempelkan long-lived token.
Saya tidak dapat mengakses Home Assistant setelah connector beberapa kali gagal. Apa yang terjadi?
Pemblokiran IP memblokir alamat yang gagal login. Dokumentasi Home Assistant menyatakan bahwa penyebab yang paling mungkin adalah detail OAuth yang salah, seperti client ID atau URL Home Assistant. Buka ip_bans.yaml di direktori konfigurasi Home Assistant, hapus entri untuk alamat yang diblokir, lalu restart Home Assistant. Perbaiki pengaturan connector sebelum mencoba lagi.