Lokaler MCP für Claude Code

Aktualisiert am 10. November 2026

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.