Connecteur Claude (MCP)
Konsolity est un serveur MCP distant (Model Context Protocol) que vous ajoutez comme connecteur dans Claude. Claude peut alors lister vos hôtes SSH, vos sessions et vos snippets, et demander l'exécution d'une commande sur un serveur : chaque commande attend votre accord dans l'app Konsolity.
| Adresse du connecteur | https://mcp.konsolity.com/mcp |
| Transport | HTTP « streamable » (MCP) |
| Authentification | OAuth 2.1 avec PKCE (S256) et inscription dynamique du client, consentement par code validé dans l'app |
| Clients | claude.ai (web), Claude Desktop (macOS, Windows), Claude sur mobile une fois ajouté, Claude Code |
| Offre | Studio (99 € par mois ou 999 € par an) et son essai gratuit de 7 jours ; double authentification requise |
Ce que fait le connecteur
Six outils sont proposés à Claude :
| Outil | Action | Type |
|---|---|---|
list_hosts |
Hôtes du coffre : nom, groupe, étiquettes, adresse, port, utilisateur, onglet connecté ou non | Lecture |
list_sessions |
Onglets ouverts dans l'app de l'ordinateur et sessions conservées sur les hôtes (tmux, screen) | Lecture |
list_snippets |
Snippets de commandes enregistrés | Lecture |
list_devices |
Appareils du compte, et celui qui relaie pour Claude en ce moment | Lecture |
run_command |
Lance une commande shell sur un hôte, après votre accord ; renvoie le code de sortie, stdout et stderr (64 Kio chacun au plus) | Exécution |
run_snippet |
Lance un snippet enregistré sur un hôte, après votre accord | Exécution |
Exemples de demandes : « liste mes serveurs de production », « quelle est l'occupation disque de web-01 ? », « redémarre nginx sur web-02 », « lance mon snippet de déploiement sur staging ».
Installation
Dans claude.ai ou Claude Desktop
- Ouvrez Réglages › Connecteurs › Ajouter un connecteur personnalisé.
- Nom :
Konsolity; adresse :https://mcp.konsolity.com/mcp. - Claude ouvre la page de consentement de Konsolity, qui affiche un code
XXXX-XXXX. - Dans l'app Konsolity d'un ordinateur : Réglages › Intégrations › Claude › Valider un code. Le nom du client et son adresse de retour sont affichés : vérifiez-les, puis validez.
- De retour dans Claude, activez le connecteur dans la conversation (menu des outils).
Aucun mot de passe n'est demandé sur le web. Une fois ajouté sur claude.ai, le connecteur est aussi disponible dans les apps Claude du même compte.
Dans Claude Code
claude mcp add --transport http konsolity https://mcp.konsolity.com/mcp
Puis /mcp dans Claude Code pour lancer l'autorisation : le navigateur s'ouvre sur la page de consentement, validez le code dans l'app comme ci-dessus. Pour une machine sans app Konsolity (serveur, CI), préférez le MCP local de Konsolity CLI : claude mcp add konsolity -- konsolity mcp.
Sécurité
- Chaque commande, votre accord. L'app de l'ordinateur affiche « Claude demande à exécuter une commande » avec la commande exacte et l'hôte. Autoriser une fois l'exécute ; sans réponse, refus après 60 secondes.
- Le coffre n'est jamais lu par le serveur. Mots de passe et clés SSH restent chiffrés sur vos appareils. Le serveur relaie une demande chiffrée à votre ordinateur ; c'est l'app qui se connecte, avec la clé du coffre.
- Connexion dédiée et bornée. Chaque commande passe par une connexion SSH courte et non interactive, avec la clé d'hôte épinglée uniquement ; durée 30 secondes par défaut, 60 au plus ; sortie limitée.
- Aucun secret vers Claude. Les outils de lecture ne renvoient jamais de mot de passe, de clé ni de contenu du coffre.
- Jetons courts et révocables. Jeton d'accès valable 60 minutes, renouvelable 60 jours ; offre Studio vérifiée à chaque appel.
- Traces minimales. Les demandes sont chiffrées au repos et purgées après une heure ; aucun texte de commande n'est journalisé côté serveur. Chaque autorisation donnée à Claude apparaît dans l'activité du compte.
Toujours autoriser
Lors d'une autorisation, vous pouvez cocher Toujours autoriser pour Claude : les commandes de ce client s'exécutent alors sans confirmation, avec une notification dans la cloche et une ligne auto: dans le journal. Réversible à tout moment dans Réglages › Intégrations › Claude.
Révoquer
Réglages › Intégrations › Claude liste les autorisations ; chacune se révoque, ou toutes d'un coup. Depuis Claude, retirer le connecteur révoque aussi.
Sans l'app ouverte
Les commandes passent par l'app Konsolity ouverte sur un ordinateur du compte (list_devices indique lequel relaie). Pour que Claude agisse quand votre ordinateur est éteint, installez Konsolity CLI sur un serveur et lancez konsolity serve : les demandes du connecteur sont alors traitées selon la portée et les règles de la machine.
Dépannage
- « Abonnement requis » : l'intégration Claude est incluse dans l'offre Studio ; Claude reçoit le lien vers les tarifs.
- Aucune réponse à une commande : aucun ordinateur n'a l'app ouverte ; vérifiez avec
list_devices, ou utilisezkonsolity serve. - Le code est refusé : il expire après 10 minutes ; relancez l'ajout du connecteur. La double authentification doit être active sur le compte.
- Adresse refusée par Claude : utilisez exactement
https://mcp.konsolity.com/mcp(avec/mcp).
Confidentialité
Le serveur relaie des demandes chiffrées au repos, purgées après une heure ; le coffre n'est jamais lu par le serveur ; aucun texte de commande n'est journalisé côté serveur. Voir aussi la politique de confidentialité.