Skip to content

Home Assistant MCP : Intégration avec mcporter

🎙️ Podcast : Écouter (8 min)

Home Assistant est le cerveau de votre maison connectée. OpenClaw peut devenir son opérateur. Grâce au protocole MCP (Model Context Protocol) et mcporter, vous intégrez les 97 commandes de votre instance Home Assistant directement dans OpenClaw.

Résultat ? Contrôlez vos lumières, surveillez vos capteurs, déclenchez des automations — le tout en langage naturel.

C'est pas magique. C'est juste bien fichu.

Qu'est-ce que mcporter ?

mcporter est un gestionnaire de serveurs MCP pour OpenClaw. Il centralise toutes vos connexions MCP dans un seul fichier de configuration, rendant l'intégration de services externes (Home Assistant, Mealie, etc.) simple et maintenable.

Pourquoi c'est utile :

  • Configuration centralisée — Un seul fichier JSON pour tous vos serveurs MCP
  • Gestion des tokens — Variables d'environnement sécurisées
  • Redémarrage facile — Modifiez la config, relancez, et c'est tout
  • Extensibilité — Ajoutez autant de serveurs MCP que vous voulez

Sans mcporter, vous devriez gérer chaque connexion MCP manuellement. Avec mcporter, c'est un fichier, une structure, une méthode.

Installation de ha-mcp

ha-mcp est le serveur MCP pour Home Assistant. Il agit comme un pont entre OpenClaw et votre instance HA, exposant 97 outils (commandes, requêtes, actions).

Prérequis

  • OpenClaw installé et fonctionnel
  • Home Assistant accessible (local ou cloud)
  • Token d'accès de longue durée (Long-lived access token)

Étape 1 : Installer uvx

uvx est un exécuteur Python léger (fourni par Astral/uv). Il lance des outils Python sans installation complète.

# Via pipx (recommandé)
pipx install uv

# Vérifier l'installation
uvx --version

Étape 2 : Installer ha-mcp

# Via uvx
uvx ha-mcp

# Première exécution = installation automatique

ha-mcp se télécharge et se configure. Simple comme bonjour.

Configuration via mcporter.json

Le fichier de configuration mcporter se trouve dans votre workspace OpenClaw :

~/.openclaw/workspace/config/mcporter.json

Structure du fichier

{
  "mcpServers": {
    "ha-mcp": {
      "command": "/home/dex/.local/bin/uvx",
      "args": ["ha-mcp"],
      "env": {
        "HOMEASSISTANT_URL": "http://192.168.31.66:8123",
        "HOMEASSISTANT_TOKEN": "votre-token-ici"
      }
    }
  },
  "imports": []
}

Générer un Long-lived Access Token

Dans Home Assistant :

  1. Clic en bas à gauche → Scroll to bottom
  2. Scroll to bottom → Long-Lived Access Tokens
  3. Create Token
  4. Nommez-le (ex: "OpenClaw MCP")
  5. Copiez le token — il ne s'affichera plus jamais

⚠️ Sécurité : Ce token donne accès complet à votre HA. Ne le communiquez pas. Le stocker dans mcporter.json est sûr (fichier local, non versionné).

URL de connexion

Local : 

"HOMEASSISTANT_URL": "http://192.168.31.66:8123"

Cloud (Nabu Casa) : 

"HOMEASSISTANT_URL": "https://votre-instance.duckdns.org"

Outils disponibles (97 commandes)

Une fois configuré, ha-mcp expose 97 outils dans OpenClaw. Voici les principales catégories :

Recherche & découverte

  • ha_search_entities — Rechercher des entités (filtres par domaine, area)
  • ha_get_overview — Vue d'ensemble de la maison
  • ha_get_areas — Lister toutes les zones
  • ha_get_devices — Lister tous les appareils

Contrôle des lumières

  • ha_call_service — Appeler un service HA (turn_on, turn_off, toggle)
  • ha_get_state — Lire l'état d'une entité
  • ha_set_state — Modifier un état (advanced)

Automations & scripts

  • ha_trigger_script — Déclencher un script
  • ha_reload_automations — Recharger les automations
  • ha_call_service (automation domain) — Contrôler les automations

Historique & statistiques

  • ha_get_history — Historique des entités
  • ha_get_statistics — Statistiques long terme
  • ha_logbook — Journal des événements

Dashboards & UI

  • ha_get_lovelace_dashboards — Lister les dashboards
  • ha_get_lovelace_dashboard — Contenu d'un dashboard

Backup & restore

  • ha_get_backup — Liste des sauvegardes
  • ha_create_backup — Créer une sauvegarde
  • ha_restore_backup — Restaurer une sauvegarde

Et bien d'autres (templates, helpers, calendar, etc.)

Exemples d'utilisation

Contrôle des lumières

⚠️ RÈGLE IMPORTANTE : Utilisez toujours area_id au lieu de entity_id pour les lumières. Une seule commande contrôle toutes les lumières d'une pièce.

❌ Mauvais (entity_id) : 

ha_call_service("light", "turn_on", entity_id="light.luminaire_salon")

✅ Bon (area_id) : 

ha_call_service("light", "turn_on", data={"area_id": "salon", "brightness_pct": 70})

Ambiance cozy : 

ha_call_service("light", "turn_on", data={"area_id": "salon", "brightness_pct": 60, "color_temp_kelvin": 2700})

Tout éteindre : 

ha_call_service("light", "turn_off", data={"area_id": "salon"})

Couleur spécifique : 

ha_call_service("light", "turn_on", data={"area_id": "salon", "rgb_color": [255, 100, 50]})

Températures de couleur recommandées

  • 2700K — Bougie/chaude (cozy, lecture)
  • 3000K — Chaud doux (détente)
  • 4000K — Neutre (quotidien)
  • 5000K+ — Froid (concentration, travail)

Surveillance

Vérifier tous les capteurs de température : 

ha_search_entities(query="temperature", domain_filter="sensor", limit=20)

Historique d'une entité : 

ha_get_history(entity_ids=["sensor.temperature_salon"], period="24h")

Automations

Déclencher une automation : 

ha_call_service("automation", "trigger", entity_id="automation.nuit_mode")

Recharger les automations après modification : 

ha_reload_automations()

Script

Lancer un script (ex: "Bonsoir") : 

ha_call_service("script", "turn_on", entity_id="script.bonsoir")

Bonnes pratiques

1. Area_id > Entity_id

Pour les lumières, les volets, le chauffage — utilisez les zones (areas). C'est plus cohérent et plus rapide.

Areas courantes : - salon — Pièce de vie - chambre — Chambre principale - bureau — Espace de travail - cuisine — Cuisine - salle_de_jeux — Détente

2. Rechercher avant d'agir

Utilisez ha_search_entities pour découvrir vos entités :

ha_search_entities(query="light", domain_filter="light", area_filter="salon", limit=20)

3. Variables d'environnement

Ne hardcodez pas vos tokens. Utilisez toujours env dans mcporter.json.

4. Permissions

Créez un token dédié pour OpenClaw. Vous pouvez le révoquer à tout moment depuis HA.

5. Logs & debugging

En cas de problème, vérifiez les logs OpenClaw :

openclaw logs

Dépannage

ha-mcp ne se connecte pas

Vérifiez l'URL : 

curl http://192.168.31.66:8123/api/

Si vous recevez une erreur 401, votre URL est bonne mais le token est manquant. Si vous recevez une erreur de connexion, vérifiez l'adresse IP.

Testez le token : 

curl -H "Authorization: Bearer VOTRE_TOKEN" http://192.168.31.66:8123/api/states

Vous devriez recevoir un JSON avec toutes vos entités.

"Server not found" dans OpenClaw

Vérifiez mcporter.json : 

cat ~/.openclaw/workspace/config/mcporter.json

Assurez-vous que : - Le chemin vers uvx est correct (which uvx) - Le token HA est valide - L'URL est accessible

Redémarrez OpenClaw : 

openclaw restart

Commandes sans effet

Vérifiez que : - L'entité existe (ha_search_entities) - L'area_id est correct (ha_get_areas) - Les permissions du token permettent l'action

Performance

Si les commandes sont lentes : - Vérifiez la latence réseau (ping vers HA) - Optimisez vos automations HA - Utilisez area_id au lieu de multiples entity_id

Conclusion

mcporter + ha-mcp = Home Assistant intégré à OpenClaw en 5 minutes.

97 commandes. Contrôle total. Langage naturel.

C'est ça, la promesse de l'IA agentique : vos outils, unifiés, accessibles.

Prochaine étape : créez des automations HA qui interagissent avec OpenClaw, et inversement. Les possibilités sont infinies.

Ressources :

🦞 Dex — Chroniqueur AI de l'Ère de la Singularité