Home Assistant MCP Server

# 🚀 Guide de démarrage rapide ## Étapes pour utiliser votre serveur MCP Home Assistant ### 1. 🔑 Créer un token Home Assistant 1. **Ouvrez votre navigateur** et allez sur : http://192.168.1.22:8123 2. **Connectez-vous** avec vos identifiants Home Assistant 3. **Cliquez sur votre profil** (icône en bas à gauche) 4. **Faites défiler** jusqu'à la section "**Tokens d'accès à long terme**" 5. **Cliquez sur "Créer un token"** 6. **Donnez-lui un nom** : `MCP Server` 7. **Copiez le token** (il ressemble à : `eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...`) ### 2. 📝 Configurer le serveur Ouvrez le fichier `.env` et remplacez `your_token_here` par votre vrai token : ```env HASS_URL=http://192.168.1.22:8123 HASS_TOKEN=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.votre_token_ici... LOG_LEVEL=INFO ``` ### 3. ✅ Tester la connexion ```bash python test_connection.py ``` Si ça marche, vous verrez : ``` ✅ Connexion réussie ! Trouvé XX entités ``` ### 4. 🤖 Configurer Claude Desktop #### Windows Éditez : `%APPDATA%\Claude\claude_desktop_config.json` #### macOS Éditez : `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "homeassistant": { "command": "homeassistant-mcp-server", "env": { "HASS_URL": "http://192.168.1.22:8123", "HASS_TOKEN": "votre_vrai_token_ici" } } } } ``` ### 5. 🔄 Redémarrer Claude Desktop Fermez complètement Claude Desktop et rouvrez-le. ### 6. 🎉 Testez avec Claude ! Demandez à Claude : ``` "Peux-tu me montrer mes lumières allumées ?" ``` ``` "Éteins la lumière du salon" ``` ``` "Quelle est la température dans ma maison ?" ``` ## 🆘 En cas de problème ### ❌ "Token invalide" - Vérifiez que vous avez bien copié tout le token - Le token ne doit pas avoir expiré - Essayez de créer un nouveau token ### ❌ "Connexion impossible" - Vérifiez que Home Assistant est démarré sur le Raspberry Pi - Testez l'accès depuis votre navigateur : http://192.168.1.22:8123 ### ❌ "Claude ne voit pas le serveur" - Redémarrez Claude Desktop complètement - Vérifiez la syntaxe JSON de votre configuration - Assurez-vous que le chemin du fichier de config est correct ## 💡 Exemples d'utilisation Une fois configuré, voici ce que vous pouvez demander à Claude : ### 📋 Consultation - "Montre-moi toutes mes entités" - "Quels sont mes capteurs de température ?" - "État de tous mes commutateurs" ### 🎮 Contrôle - "Allume toutes les lumières" - "Éteins la lumière de la cuisine" - "Mets la luminosité à 50% dans le salon" ### 📊 Historique - "Température du salon aujourd'hui" - "Historique du capteur d'humidité" - "Quand la porte d'entrée a-t-elle été ouverte ?" Amusez-vous bien ! 🏠✨