MCP
Qu'est-ce que le nomos MCP Skill ?
Le nomos MCP Skill permet aux assistants IA comme Claude de communiquer directement avec le nomos system Controller. Grâce au protocole standardisé Model Context Protocol (MCP), l'IA peut contrôler des appareils, exécuter des scènes, gérer des pièces, créer des automatisations et bien plus encore – le tout en langage naturel.
Prérequis
Un client compatible MCP (par ex. Claude Desktop, Claude Code, Cursor, Windsurf)
Node.js (version 18 ou supérieure) installé sur votre machine
Accès réseau au nomos system Controller (local uniquement, aucun accès externe possible)
Installation
Étape 1 : Activer le module MCP dans nomos
Le module MCP doit être activé dans l'interface de configuration nomos. Naviguez vers les Skills et assurez-vous que le module MCP est activé.
Étape 2 : Créer un token
Dans l'interface de configuration nomos, naviguez vers la section MCP et créez un nouveau token. Ce token sert à authentifier le client IA auprès du nomos system Controller. Notez le token – vous en aurez besoin pour la configuration du client.
Chaque token peut recevoir un nom personnalisé (par ex. « Claude Desktop Bureau »)
Les tokens peuvent être désactivés ou supprimés à tout moment
Plusieurs tokens peuvent être créés pour différents clients
Étape 3 : Configurer le client
Il existe deux façons de connecter votre client MCP au nomos system Controller :
Option A : nomos MCP Bridge (recommandé) – un proxy dédié qui gère les connexions aux contrôleurs via une page de configuration. Configuration la plus simple, prend en charge plusieurs contrôleurs, fonctionne avec tous les clients MCP.
Option B : Connexion directe – configurer l'URL du contrôleur et le token directement dans la configuration du client. Nécessite une gestion manuelle des tokens.
Option A : nomos MCP Bridge (Recommandé)
La nomos MCP Bridge est un proxy local léger qui gère les connexions à un ou plusieurs nomos system Controllers. Au lieu de configurer les URLs et les tokens directement, vous enregistrez les contrôleurs via une page de configuration web. La bridge fonctionne avec tout client MCP prenant en charge les serveurs basés sur stdio.
Claude Desktop
Ouvrez les paramètres de Claude Desktop et naviguez vers la section « MCP Servers ». Ajoutez un nouveau serveur avec la configuration suivante :
Claude Code (CLI)
Cursor
Ajoutez dans les paramètres MCP de Cursor (.cursor/mcp.json) :
Windsurf
Ajoutez dans la configuration MCP de Windsurf (~/.codeium/windsurf/mcp_config.json) :
Autres clients compatibles MCP
Tout client prenant en charge les serveurs MCP basés sur stdio peut utiliser la bridge. La commande est :
Gérer les contrôleurs
Après avoir configuré la bridge dans votre client MCP, vous pouvez gérer vos contrôleurs à l'aide des commandes IA suivantes :
open_setup
Ouvre la page de configuration web dans votre navigateur où vous pouvez entrer le nom du contrôleur, l'URL et le token MCP
add_controller
Ajoute un nouveau contrôleur directement via l'IA — fournir le nom, l'URL et le token
list_controllers
Liste tous les contrôleurs enregistrés et indique celui actuellement sélectionné
select_controller
Se connecte à un contrôleur enregistré par son nom
remove_controller
Supprime un contrôleur enregistré
Option B : Connexion directe
Si vous préférez configurer l'URL du contrôleur et le token directement sans utiliser la bridge, vous pouvez utiliser les configurations suivantes.
Claude Desktop
Claude Desktop ne prend pas en charge nativement le protocole de transport Streamable HTTP. La connexion est établie via le paquet mcp-remote, qui sert de pont.
Ouvrez les paramètres de Claude Desktop et naviguez vers la section « MCP Servers ». Ajoutez un nouveau serveur avec la configuration suivante :
Remplacez <nomos-ip> par l'adresse IP ou le nom d'hôte de votre nomos system Controller et <votre-token> par le token créé à l'étape 2.
Remarque : Le paramètre
--allow-httpest nécessaire car le nomos system Controller est accessible localement via HTTP (et non HTTPS).
Claude Code (CLI)
Claude Code prend en charge nativement Streamable HTTP. Ajoutez le serveur via la ligne de commande :
Ou configurez-le manuellement dans le fichier ~/.claude/settings.json :
Cursor
Cursor prend en charge nativement Streamable HTTP. Naviguez vers Settings > MCP et ajoutez un nouveau serveur :
Si la connexion ne peut pas être établie, vous pouvez utiliser la variante mcp-remote comme décrit pour Claude Desktop.
Windsurf
Windsurf prend en charge nativement Streamable HTTP. Ouvrez la configuration MCP et ajoutez :
Autres clients compatibles MCP
Le serveur MCP nomos utilise le protocole de transport Streamable HTTP. Les clients qui prennent en charge nativement ce standard peuvent être configurés directement :
URL :
http://<nomos-ip>/mcpAuthentification : Token Bearer dans l'en-tête
AuthorizationType de transport : Streamable HTTP
Pour les clients qui ne prennent en charge que les serveurs MCP basés sur stdio (comme Claude Desktop), mcp-remote peut être utilisé comme pont :
Aperçu des fonctionnalités
Ressources
L'IA a accès aux données en temps réel de votre nomos system Controller :
Tous les composants, scènes, pièces, étages, minuteries et automatisations sous forme de listes récapitulatives
Entités individuelles avec des informations détaillées (par ex. un appareil spécifique avec toutes ses propriétés)
Mises à jour en direct : Les changements dans le système sont automatiquement signalés à l'IA
Prompts intégrés
Statut & Aperçu
home_status
Aperçu complet de l'état actuel de l'ensemble du système — toutes les pièces, composants et leurs valeurs
room_status
État actuel de tous les composants d'une pièce spécifique (nom ou ID de la pièce en paramètre)
system_health
Vérification complète du système — connectivité, appareils inaccessibles, état du cloud, accès à distance, notifications critiques
Rapports spécifiques
climate_report
Résumé de la température, de l'humidité et de la climatisation dans toutes les pièces
energy_report
Résumé de la consommation d'énergie et des données de puissance de tous les composants
security_status
Résumé de tous les capteurs de sécurité — contacts de portes/fenêtres, détecteurs de mouvement, serrures, alarmes
notifications_summary
Résumé de toutes les notifications en cours, regroupées par priorité et type
automation_overview
Aperçu de toutes les automatisations et minuteries — leur état, déclencheurs et actions
Workflows de création guidée
create_scene
Workflow guidé pour créer une nouvelle scène à partir d'une description de l'état souhaité
create_automation
Workflow guidé pour créer une nouvelle automatisation à partir d'une description du comportement souhaité
create_timer
Workflow guidé pour créer une nouvelle automatisation basée sur un minuteur
Exemples
Contrôler des appareils
« Allume la lumière dans le salon. »
« Tamise le plafonnier de la chambre à 50%. »
« Règle le chauffage de la salle de bain à 22 degrés. »
Interroger l'état
« Quelles fenêtres sont actuellement ouvertes ? »
« Montre-moi l'état de tous les appareils dans le salon. »
« Quelle est la température actuelle dans la cuisine ? »
Gérer les scènes
« Crée une scène 'Soirée Cinéma' qui tamise les lumières du salon et ferme les volets. »
« Exécute la scène 'Bonjour'. »
Créer des automatisations
« Crée une automatisation qui allume les lumières extérieures au coucher du soleil. »
« Montre-moi toutes les minuteries actives. »
Configuration KNX
« Quelles adresses de groupe KNX sont disponibles dans le projet ? »
« Importe le projet KNX depuis le fichier. »
Notes importantes et limitations connues
Accès local uniquement
Le point d'accès MCP est uniquement accessible via le réseau local. L'accès depuis l'extérieur (par ex. via Internet) est bloqué par le système. Le client MCP doit se trouver sur le même réseau que le nomos system Controller.
Claude Desktop : Redémarrage en cas de perte de connexion
Important : Si la connexion entre Claude Desktop et le serveur MCP nomos est interrompue (par ex. suite à un redémarrage du nomos system Controller ou à des problèmes réseau), Claude Desktop doit être entièrement redémarré. Fermer et rouvrir simplement la fenêtre de chat ne suffit pas – l'application doit être complètement quittée et redémarrée pour rétablir la connexion MCP.
Sécurité des tokens
Traitez les tokens MCP comme des mots de passe
Créez des tokens distincts pour différents clients
Désactivez ou supprimez les tokens qui ne sont plus utilisés
Les tokens donnent un accès complet à toutes les fonctions MCP – il n'y a pas de gestion fine des permissions
Notes générales sur MCP
Gestion des sessions : Chaque client reçoit sa propre session. Plusieurs clients peuvent être connectés simultanément.
Notifications automatiques : Les changements dans le système (par ex. état des appareils) sont automatiquement signalés à tous les clients connectés. Il peut y avoir un léger délai en cas de nombreux changements simultanés (debouncing de 100ms).
Gestion des erreurs : Si un outil renvoie une erreur, l'IA le détectera généralement et affichera un message d'erreur utile.
Conseils d'utilisation
Soyez aussi précis que possible dans vos instructions (noms des pièces, noms des appareils)
L'IA peut combiner plusieurs actions en une seule requête
Utilisez les prompts intégrés pour les tâches courantes
Pour les automatisations complexes, il est recommandé de les construire étape par étape avec l'IA
Mis à jour