概要
AI に Home Assistant を読み取らせましょう。すべてのセンサー、照明、ドア、サーモスタットの現在の状態、記録された履歴、いつ何が起きたかを示すログブック、そしてカレンダーを参照できます。読み取り専用で、デバイスを操作することはありません。セルフホストの Home Assistant に対応しています。
ガイド付きセットアップ
Home Assistant を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Home Assistant を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Home Assistant のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要。cloud.anythingmcp.com をそのままお使いいただけます。 サインインし、Connectors → Home Assistant をクリックして認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要です。
Home Assistant + Microsoft Copilot
AI に Home Assistant を読み取らせましょう。すべてのセンサー、照明、ドア、サーモスタットの現在の状態、記録された履歴、いつ何が起きたかを示すログブック、そしてカレンダーを参照できます。読み取り専用で、デバイスを操作することはありません。セルフホストの Home Assistant に対応しています。
前提条件
コネクターに組み込まれているセットアップ手順の全文を参照してください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。
HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN
ステップ 1 — 認証情報を取得する
セットアップには約 3 分かかります。AnythingMCP からアクセスできる Home Assistant インスタンスと、長期アクセストークンが必要です。トークンは、できれば専用の非管理者ユーザーで発行してください。
HOME_ASSISTANT_URLには、Home Assistant を開くときのアドレスを設定します。末尾のスラッシュと/apiは付けません。例:https://home.example.comまたはhttp://192.168.1.10:8123(デフォルトのポートは 8123 です)。- 推奨: Settings → People → Users → Add user で、AnythingMCP 専用の Home Assistant ユーザーを作成し、Administrator をオフにします。コネクターが使用するエンドポイントには、管理者権限は一切必要ありません。
- そのユーザーでログインし、左下の自分の名前をクリックしてプロフィールを開きます。Security タブを開き、Long-lived access tokens の Create token をクリックします。トークンをコピーし(表示されるのは一度だけで、10 年間有効です)、Bearer という語を付けずに
HOME_ASSISTANT_TOKENに貼り付けます。 - コネクターをインストールして
home_assistant_get_configを実行します。バージョン、ロケーション名、タイムゾーンが返され、アドレスとトークンが正しく機能していることを確認できます。
読み取る内容: すべてのエンティティ(センサー、照明、climate、ドア、在宅状況)の現在の状態と属性、一定期間における値の記録された履歴、いつ何が起きたかを示すログブック(たとえばガレージのドアが最後に開いた時刻)、カレンダーとそのイベント、そしてインスタンスの設定です。エンティティ ID は sensor.living_room_temperature や binary_sensor.garage_door のような形式です。
読み取り専用: すべてのツールは GET リクエストです。コネクターはアクション(サービス)の呼び出し、オン/オフの切り替え、ドアの解錠、スクリプトの実行、状態の変更を行えません。Home Assistant 自体のアクションエンドポイントは管理者専用ではないため、この保証はトークンではなく、コネクターが読み取りのみを公開していることによるものです。
Home Assistant の稼働場所: セルフホストの AnythingMCP では、プライベートネットワーク上のインスタンス(http://192.168.x.x:8123、homeassistant.local)を利用するには、管理者が SSRF_ALLOWED_HOSTS または管理設定の許可リストでそのホストを許可する必要があります。AnythingMCP Cloud から到達できるのは、HTTPS でインターネットに公開されているインスタンスのみです。たとえばリバースプロキシ経由、または Home Assistant Cloud のリモートアクセス経由です。
プライバシー: 家庭のデータからは、誰が在宅しているかや世帯の日常的な行動パターンがわかります。このコネクターは、そのデータを閲覧してよいユーザーの MCP サーバーにのみ割り当ててください。
時刻: タイムスタンプは、UTC の ISO 8601 形式で末尾に Z を付けて指定します。例: 2026-10-01T00:00:00Z。結果を表示する際のタイムゾーンは、home_assistant_get_config が返す自宅のタイムゾーンを使用します。
よくあるエラー: 401 はトークンが間違っているか、削除されたことを意味します。特定のエンティティまたはそのカレンダーイベントでの 404 は、その ID のエンティティが存在しないことを意味します。すべての呼び出しで 404 になる場合は、HOME_ASSISTANT_URL が間違っているか、すでに /api で終わっています。カレンダーイベントでの 400 は、start または end が欠けているか、有効なタイムスタンプではないことを意味します。接続が拒否またはブロックされる場合は、ホストが SSRF 許可リストで許可されていない(セルフホスト)か、HTTPS で公開されていない(Cloud)ことを意味します。
このコネクターは、アクションやサービスの呼び出し、状態の書き込みや削除、イベントの発火、テンプレートのレンダリング、カメラ画像の表示、イベントストリーム、エラーログ、WebSocket API(エリア、デバイス、エンティティレジストリ)の読み取りを行いません。
ステップ 2 — アダプターをインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクターを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Home Assistantのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
home_assistant_get_config | Home Assistant の設定を取得します: バージョン、ロケーション名、タイムゾーン、単位系、座標、読み込み済みコンポーネント |
home_assistant_list_states | トークンで読み取れるすべてのエンティティを、entity_id、state、フレンドリー名、単位、last_changed に絞って一覧表示します |
home_assistant_get_state | 1 つのエンティティの現在の状態を、すべての属性、last_changed、last_updated とともに取得します。例: サーモスタットの目標温度など… |
home_assistant_get_history | 1 つ以上のエンティティについて、一定期間に記録された状態の変化を取得します。例: 夜間のリビングの温度 |
home_assistant_get_logbook | 開始時刻以降のログブックのエントリを取得します: ドアが開いた、照明がついた、人が帰宅したといった人間が読みやすいイベントを、… |
home_assistant_list_calendars | この Home Assistant インスタンスのカレンダーエンティティを一覧表示します(entity_id と名前。例: calendar.family) |
home_assistant_get_calendar_events | 1 つのカレンダーについて、開始から終了までのイベントを取得します: 概要、開始、終了、説明、場所 |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?