MCP local pour Claude Code
konsolity mcp lance un serveur MCP local sur l'entrée et la sortie standard (stdio). Un agent Claude qui tourne sur la même machine, Claude Code par exemple, s'en sert pour lister vos hôtes et y exécuter des commandes, avec exactement les mêmes règles que konsolity run. Rien ne passe par le connecteur Claude distant : l'agent parle directement à la CLI.
La machine doit être activée avec le domaine mcp (et hosts, snippets pour les outils correspondants).
Brancher Claude Code
claude mcp add konsolity -- konsolity mcp
Vérifiez que le serveur est vu :
claude mcp list
Claude Code lance konsolity mcp à chaque session et l'arrête à la fin. Chaque session MCP ouverte apparaît dans la liste des sessions CLI du compte, et peut y être terminée.
Outils
| Outil | Domaine | Rôle |
|---|---|---|
list_hosts |
hosts |
Hôtes de la portée : identifiant, libellé, adresse, utilisateur, groupe. Aucun secret. |
list_snippets |
snippets |
Snippets de la portée : identifiant, nom, groupe. |
run_command |
hosts, accès complet |
Exécute une commande sur un hôte de la portée, selon les règles de commande. |
run_snippet |
snippets + hosts, accès complet |
Lance un snippet sur un hôte de la portée. |
list_sessions |
sessions |
Sessions CLI en cours sur le compte. |
En lecture seule, seuls les outils de liste sont proposés.
Mêmes règles
- Hôte hors portée, commande qui ne correspond à aucune règle : refus, avec un message clair pour l'agent et une ligne au journal.
- Commande destructrice : confirmation dans l'app ou sur la console avant toute exécution, même avec « Toute commande ».
- Délai : borné par le délai maximal de la machine (60 s par défaut, 1 h au plus).
- Révocation ou fin de session : la commande en cours est arrêtée en moins de 5 secondes et le serveur MCP s'arrête.
Sortie limitée
Le résultat d'un outil renvoie le code retour, la durée, et la sortie standard et la sortie d'erreur, limitées à 64 Kio chacune. Au-delà, la sortie est tronquée et le résultat le signale. Pour une sortie complète, utilisez konsolity run dans un terminal, dont la sortie n'est pas limitée.
Trois façons de connecter Claude
konsolity mcp |
Connecteur Claude | konsolity serve |
|
|---|---|---|---|
| Claude utilisé | Claude Code (ou un agent) sur la même machine | claude.ai, app Claude | claude.ai, app Claude |
| Transport | stdio local | https://mcp.konsolity.com/mcp |
file du connecteur, relevée par la machine |
| Qui exécute | la CLI sur cette machine | l'app d'ordinateur ouverte | la CLI en service, sans interface |
| Validation | portée et règles de la machine | « Autoriser une fois » dans l'app | portée et règles de la machine |
| Documentation | cette page | Connecteur Claude | Service et stockage |
Dans tous les cas, les commandes destructrices venant d'une machine CLI attendent votre confirmation.