Lokaler MCP für Claude Code
konsolity mcp startet einen lokalen MCP-Server über Standardein- und -ausgabe (stdio). Ein Claude-Agent auf derselben Maschine, zum Beispiel Claude Code, verwendet ihn, um Ihre Hosts aufzulisten und Befehle darauf auszuführen, mit genau denselben Regeln wie konsolity run. Nichts läuft über den entfernten Claude-Connector: Der Agent spricht direkt mit der CLI.
Die Maschine muss mit der Domäne mcp aktiviert sein (und mit hosts, snippets für die entsprechenden Tools).
Claude Code anbinden
claude mcp add konsolity -- konsolity mcp
Prüfen Sie, ob der Server erkannt wird:
claude mcp list
Claude Code startet konsolity mcp für jede Sitzung und beendet es am Ende. Jede offene MCP-Sitzung erscheint in der Liste der CLI-Sitzungen des Kontos und kann dort beendet werden.
Tools
| Tool | Domäne | Funktion |
|---|---|---|
list_hosts |
hosts |
Hosts im Bereich: Kennung, Bezeichnung, Adresse, Benutzer, Gruppe. Kein Geheimnis. |
list_snippets |
snippets |
Snippets im Bereich: Kennung, Name, Gruppe. |
run_command |
hosts, voller Zugriff |
Führt einen Befehl auf einem Host im Bereich aus, gemäß den Befehlsregeln. |
run_snippet |
snippets + hosts, voller Zugriff |
Führt ein Snippet auf einem Host im Bereich aus. |
list_sessions |
sessions |
Laufende CLI-Sitzungen des Kontos. |
Bei reinem Lesezugriff werden nur die Listen-Tools angeboten.
Dieselben Regeln
- Host außerhalb des Bereichs, Befehl ohne passende Regel: abgelehnt, mit einer klaren Meldung für den Agenten und einer Zeile im Protokoll.
- Destruktiver Befehl: Bestätigung in der App oder in der Konsole, bevor etwas ausgeführt wird, selbst mit „Beliebiger Befehl“.
- Zeitlimit: begrenzt durch das maximale Zeitlimit der Maschine (standardmäßig 60 s, höchstens 1 h).
- Widerruf oder Sitzungsende: Der laufende Befehl wird in weniger als 5 Sekunden gestoppt und der MCP-Server beendet sich.
Begrenzte Ausgabe
Ein Tool-Ergebnis liefert den Exit-Code, die Dauer sowie die Standardausgabe und die Fehlerausgabe, jeweils auf 64 KiB begrenzt. Darüber hinaus wird die Ausgabe abgeschnitten, und das Ergebnis weist darauf hin. Für die vollständige Ausgabe verwenden Sie konsolity run in einem Terminal, dessen Ausgabe nicht begrenzt ist.
Drei Wege, Claude anzubinden
konsolity mcp |
Claude-Connector | konsolity serve |
|
|---|---|---|---|
| Verwendetes Claude | Claude Code (oder ein Agent) auf derselben Maschine | claude.ai, Claude-App | claude.ai, Claude-App |
| Transport | lokales stdio | https://mcp.konsolity.com/mcp |
Warteschlange des Connectors, von der Maschine abgeholt |
| Wer ausführt | die CLI auf dieser Maschine | die geöffnete Desktop-App | die CLI als Dienst, ohne Oberfläche |
| Freigabe | Bereich und Regeln der Maschine | „Einmal erlauben“ in der App | Bereich und Regeln der Maschine |
| Dokumentation | diese Seite | Claude-Connector | Dienst und Speicherung |
In allen Fällen warten destruktive Befehle von einer CLI-Maschine auf Ihre Bestätigung.