Home AssistantをChatGPTに接続（MCP）

💡 インストール不要で使えます。cloud.anythingmcp.com を直接ご利用ください。 サインインして Connectors → Home Assistant をクリックし、認証情報を貼り付けて MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

Home Assistant + ChatGPT

AI に Home Assistant を読み取らせましょう。すべてのセンサー、照明、ドア、サーモスタットの現在の状態、記録された履歴、いつ何が起きたかを示すログブック、そしてカレンダーを参照できます。読み取り専用で、デバイスを制御することはありません。セルフホストの Home Assistant に対応しています。

前提条件

コネクターに組み込まれているセットアップ手順の全文をご確認ください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

ステップ 1 — 認証情報を取得する

セットアップには約 3 分かかります。AnythingMCP から到達できる Home Assistant インスタンスと、長期間有効なアクセストークンが必要です。トークンは、できれば管理者権限を持たない専用ユーザーで作成してください。

1. HOME_ASSISTANT_URL には、Home Assistant を開くときのアドレスを設定します。末尾のスラッシュと /api は付けないでください。例: https://home.example.com や http://192.168.1.10:8123(デフォルトのポートは 8123)。
2. 推奨: Settings → People → Users → Add user で、AnythingMCP 専用の Home Assistant ユーザーを作成し、Administrator をオフにします。コネクターが使用するエンドポイントに管理者権限は必要ありません。
3. そのユーザーでログインし、左下の自分の名前をクリックしてプロフィールを開きます。Security タブを開き、Long-lived access tokens の Create token をクリックします。トークンをコピーし(表示されるのは一度だけで、有効期間は 10 年です)、Bearer という語を付けずに HOME_ASSISTANT_TOKEN に貼り付けます。
4. コネクターをインストールして 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 はトークンが間違っているか、削除されたことを意味します。1 つのエンティティまたはそのカレンダーイベントで 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 — ChatGPT にコネクターを追加する

サーバー URL: AnythingMCP で MCP Servers を開き、このコネクターが属しているサーバーの URL(https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所には、その URL を使用してください。

ChatGPT では、MCP サーバーを Plugins ページからプラグインとして追加します。Web 版かつ有料プランで利用できます。開発者モードはもう必要ありません。Business ワークスペースでは、管理者とオーナーのみが追加できます。Enterprise と Edu では、管理者が Create plugins with MCPs 権限を付与できます。

1. chatgpt.com/plugins にアクセスし、Add をクリックして、Add custom MCP server を選択します。
2. 名前を入力します。例: Name: Home Assistant。
3. Connection で、Server URL に https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Authentication は OAuth のままにします。
4. I understand and want to continue を選択し、Create as a plugin をクリックします。ChatGPT から求められたら、AnythingMCP にサインインしてアクセスを許可します。
5. 作成したプラグインを個人用プラグインからインストールし、チャットで @ を入力して選択します。

利用可能なツール

FAQ

無料の ChatGPT プランでカスタム MCP サーバーは使えますか? OpenAI は、カスタム MCP サーバーを有料プラン限定としており、Free プランは対象に含まれていません。

次のステップ

• コネクターのランディングページ
• Claude に接続する