Lokale MCP voor Claude Code

Bijgewerkt op 10 november 2026

konsolity mcp start een lokale MCP-server op standaardinvoer en standaarduitvoer (stdio). Een Claude-agent die op dezelfde machine draait, bijvoorbeeld Claude Code, gebruikt hem om je hosts op te sommen en er opdrachten op uit te voeren, met precies dezelfde regels als konsolity run. Niets gaat via de externe Claude-connector: de agent praat rechtstreeks met de CLI.

De machine moet geactiveerd zijn met het domein mcp (en hosts, snippets voor de bijbehorende tools).

Claude Code koppelen

claude mcp add konsolity -- konsolity mcp

Controleer dat de server wordt gezien:

claude mcp list

Claude Code start konsolity mcp bij elke sessie en stopt hem aan het eind. Elke open MCP-sessie verschijnt in de lijst met CLI-sessies van het account en kan daar worden beëindigd.

Tools

Tool Domein Functie
list_hosts hosts Hosts binnen het bereik: identificatie, label, adres, gebruiker, groep. Geen geheim.
list_snippets snippets Snippets binnen het bereik: identificatie, naam, groep.
run_command hosts, volledige toegang Voert een opdracht uit op een host binnen het bereik, volgens de regels voor opdrachten.
run_snippet snippets + hosts, volledige toegang Voert een snippet uit op een host binnen het bereik.
list_sessions sessions CLI-sessies die op het account lopen.

Met alleen-lezentoegang worden alleen de lijsttools aangeboden.

Dezelfde regels

  • Host buiten het bereik, opdracht die met geen enkele regel overeenkomt: geweigerd, met een duidelijke melding voor de agent en een regel in het logboek.
  • Destructieve opdracht: bevestiging in de app of in de console voordat er iets wordt uitgevoerd, zelfs met "Elke opdracht".
  • Time-out: begrensd door de maximale time-out van de machine (standaard 60 s, maximaal 1 uur).
  • Intrekking of einde van de sessie: de lopende opdracht wordt binnen 5 seconden gestopt en de MCP-server stopt.

Beperkte uitvoer

Een toolresultaat geeft de afsluitcode, de duur, en de standaarduitvoer en de foutuitvoer terug, elk beperkt tot 64 KiB. Daarboven wordt de uitvoer afgekapt en vermeldt het resultaat dat. Gebruik voor de volledige uitvoer konsolity run in een terminal, waarvan de uitvoer niet beperkt is.

Drie manieren om Claude te koppelen

konsolity mcp Claude-connector konsolity serve
Gebruikte Claude Claude Code (of een agent) op dezelfde machine claude.ai, Claude-app claude.ai, Claude-app
Transport lokale stdio https://mcp.konsolity.com/mcp wachtrij van de connector, opgehaald door de machine
Wie voert uit de CLI op deze machine de geopende desktop-app de CLI als service, zonder interface
Goedkeuring bereik en regels van de machine "Eén keer toestaan" in de app bereik en regels van de machine
Documentatie deze pagina Claude-connector Service en opslag

In alle gevallen wachten destructieve opdrachten die van een CLI-machine komen op je bevestiging.