MCP local pour Claude Code

Mis à jour le 10 novembre 2026

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.