Lokale MCP voor Claude Code
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.