Home Assistant (HA) で HACS を使って MCP Server for Xiaozhi をインストールし、次にインテグレーションで MCP Server for Xiaozhi を追加します（2026年4月以降に出荷された弊社のホストは本手順の設定が完了しています）。
ステップ1：小智の「MCP 接続ポイントアドレス」を取得する
小智デバイスは、あなたの HA と接続するために通信アドレスが必要です。このアドレスは小智のクラウドコンソールで取得します。
- パソコンまたはスマホのブラウザで小智の公式コンソールを開いてログインします（通常は xiaozhi.me、自前で運用している場合は自分のコンソールアドレスを開きます）。
- デバイス一覧で、現在使用している ESP 小智デバイスを見つけ、設定 (Configure) をクリックします。
- ページを下にスクロールし、「MCP 設定」 (MCP Setting) のエリアを見つけます。
- 「MCP 接続ポイントを取得」 (Get MCP Endpoint) をクリックすると、リンク（通常は wss:// で始まる）が生成されるので、このアドレスをコピーして控えておきます。
ステップ2：HA で小智 MCP インテグレーションを設定する
次に、先ほどコピーしたアドレスを HA に入力し、HA から小智サーバーへ接続させます。
- Home Assistant のパネルを開き、左側サイドバーの 設定 (Settings) をクリックします。
- デバイスとサービス (Devices & Services) をクリックします。
- 右下の インテグレーションを追加 (Add Integration) をクリックします。
- 検索ボックスに MCP または Xiaozhi と入力し、MCP Server for Xiaozhi を見つけてクリックします。
- 設定項目を入力します。
- 小智 MCP 接続ポイントアドレス：ステップ1 でコピーしたリンクを貼り付けます。
- 必要な MCP を選択（llm_hass_api のチェックボックスが表示される場合）：必ずチェックしてください。これは HA 標準の制御機能で、チェックすると HA が家のデバイスの制御権を小智に「代理」させられます。HA に他の MCP があれば一緒にチェックしても構いません。
送信 / 完了 をクリックします。
状態を確認：1 分ほど待ってから、小智コンソールの MCP 設定ページに戻り、更新をクリックして状態が「接続済み」になっているか確認します。
ステップ3：HA のデバイスを小智に「公開」する（重要！）
小智にいきなり「電気をつけて」と叫んでも、デバイスが見つからないと言われることがあります。セキュリティ上の理由から、HA はデフォルトですべてのデバイスを音声アシスタントに公開しないためです。
- HA パネルで 設定 (Settings) -> 音声アシスタント (Voice assistants) に進みます。
- 公開 (Expose) タブを見つけます。
- ここに家中のさまざまなデバイスの一覧が表示されます。小智に操作させたいデバイス（特定のライト、スイッチ、エアコン、扇風機、温湿度センサーなど）にチェックを入れます。初心者の方は、まず 1〜2 個のライトだけチェックして試し、成功してから他のデバイスにもチェックを入れることをおすすめします。
ステップ4：音声テストとデバッグ
すべての設定が完了したら、小智に指示を出し始められます！
- 操作テスト： 「小智、小智、書斎の電気をつけて。」
- 問い合わせテスト： 「小智、小智、今リビングの温度は何度？」
問題が起きたときの確認方法（失敗を避けるガイド）：
- 小智が反応しない／的外れな回答をする：小智のクラウドコンソールで「チャット履歴」を確認します。小智があなたの話を理解したか、Home Assistant のツール (Function Call) を呼び出そうとしたかを確認します。
- 指示の競合：現在、小智側で「内蔵の音楽／画面制御ロジック」が有効になっていると、HA の照明や音楽の制御と競合することがあります。照明の操作がよく失敗する場合は、指示をより具体的にしてみてください。例えば「スマートホーム経由でリビングのシーリングライトをつけて」のように言います。
- HA ログ：小智が確かに指示を出したのにデバイスが動かない場合は、HA の 設定 -> システム -> ログ で MCP プラグインにエラーが出ていないか確認します。
以上の 4 ステップで、あなたの小智 AI は立派な「家庭のスマート執事」に生まれ変わるはずです！
