MCP-Server

Der MCP-Server des Panel KVM verbindet einen KI-Assistenten mit Ihren VPS. MCP (Model Context Protocol) ist der offene Standard, über den Assistenten externe Dienste nutzen: Sie bitten in Alltagssprache um die Liste Ihrer Server, ihre Auslastung der Woche, einen Snapshot vor einem Update oder das Öffnen eines Ports, und der Assistent übernimmt für Sie die Aufrufe an das Panel KVM.

Der Server wird von LWS unter https://panelkvm.lwspanel.com/mcp/v1 betrieben: Es ist nichts zu installieren. Alles wird im Panel KVM eingestellt, auf der Seite API / MCP, Registerkarte MCP-Server: Dort wählen Sie die Berechtigungsstufe des Assistenten und die VPS, die er steuern darf, und Sie können seinen Zugang jederzeit sperren. Jede seiner Aktionen wird protokolliert.

Bevor Sie beginnen

• Das Hauptkonto. Die Seite API / MCP ist dem Kontoinhaber vorbehalten: Unterkonten können keinen Assistenten verbinden.
• Ein Assistent mit Unterstützung für „Remote“-MCP: Claude, ChatGPT, Claude Code, Cursor, VS Code, Gemini CLI, Codex CLI, Mistral, n8n oder jedes Werkzeug mit Streamable HTTP.
• Sonst nichts. Der MCP funktioniert unabhängig von der REST-API: Sie müssen weder die API aktivieren noch einen API-Schlüssel erstellen noch eine IP-Adresse hinterlegen.

MCP aktivieren

1. Öffnen Sie im Panel KVM die Seite API / MCP (linkes Menü) und dann die Registerkarte MCP-Server.
2. Aktivieren Sie den Schalter. Jede Aktivierung und Deaktivierung wird Ihnen per E-Mail bestätigt.
3. Wählen Sie die vom Assistenten steuerbaren Server: alle Ihre VPS, auch später hinzugefügte, oder eine Auswahl. Standardmäßig steuert er keinen.
4. Prüfen Sie die Berechtigungsstufe: Standardmäßig hat der Assistent nur Lesezugriff (siehe unten).

Ihren Assistenten verbinden

Je nach Assistent gibt es zwei Wege:

• Claude und ChatGPT verbinden sich per Autorisierung (OAuth): Die Serveradresse genügt, es ist kein Token zu kopieren. Sie stimmen auf einer Seite des Panel KVM zu.
• Die anderen (Claude Code, Cursor, VS Code, n8n…) verwenden das MCP-Token, das Sie in der Registerkarte MCP-Server erzeugen und das sie im Header Authorization: Bearer senden. Sein Wert wird nur einmal angezeigt: Kopieren Sie ihn beim Erzeugen. Das Panel zeigt außerdem für jedes Werkzeug die fertige Konfiguration zum Kopieren an.

Die Rechte sind in beiden Fällen dieselben: die Berechtigungsstufe und die steuerbaren Server Ihres MCP-Zugangs.

Claude (claude.ai, Desktop- oder Mobil-App)

1. Öffnen Sie in Claude Einstellungen › Konnektoren und fügen Sie einen benutzerdefinierten Konnektor hinzu.
2. Name: LWS Panel KVM. Adresse: https://panelkvm.lwspanel.com/mcp/v1. Behalten Sie die vorgeschlagene Authentifizierung bei, ohne einen Header einzugeben.
3. Claude öffnet die Autorisierungsseite des Panel KVM: Prüfen Sie die Angaben und klicken Sie auf Autorisieren. Der Konnektor steht auch in der Desktop-App und auf dem Mobilgerät zur Verfügung.

ChatGPT

1. Fügen Sie auf chatgpt.com einen benutzerdefinierten MCP-Server hinzu (je nach Version im Menü der Plugins oder Konnektoren). Die Option hängt von Ihrem Abonnement und den Einstellungen Ihres Arbeitsbereichs ab.
2. Serveradresse: https://panelkvm.lwspanel.com/mcp/v1. Authentifizierung: OAuth.
3. Klicken Sie auf Verbinden: ChatGPT öffnet die Autorisierungsseite des Panel KVM, auf der Sie auf Autorisieren klicken.

Wenn Sie nicht im Panel KVM angemeldet sind, fordert Sie die Autorisierungsseite auf, über Ihren LWS-Kundenbereich zu gehen und das Panel KVM von einem VPS aus zu öffnen (Verwalten): Sie gelangen automatisch zur Autorisierung zurück, die 10 Minuten gültig bleibt. Die Seite zeigt die Domain der Anwendung (claude.ai, chatgpt.com…): Prüfen Sie sie, bevor Sie autorisieren. Jede neue Autorisierung wird Ihnen per E-Mail gemeldet.

Claude Code

In einem Terminal, wobei Sie IHR_TOKEN durch den Wert des Tokens ersetzen:

claude mcp add --transport http lwskvm https://panelkvm.lwspanel.com/mcp/v1 --header "Authorization: Bearer IHR_TOKEN"

Cursor und andere Editoren

Fügen Sie diesen Server der MCP-Konfigurationsdatei des Editors hinzu (für Cursor: ~/.cursor/mcp.json) und starten Sie ihn neu:

{
  "mcpServers": {
    "lwskvm": {
      "url": "https://panelkvm.lwspanel.com/mcp/v1",
      "headers": { "Authorization": "Bearer IHR_TOKEN" }
    }
  }
}

VS Code, Gemini CLI und Codex CLI haben jeweils ein eigenes Dateiformat: Das Panel zeigt für jedes das richtige an.

n8n

1. Fügen Sie Ihrem KI-Agenten das Werkzeug MCP Client Tool hinzu.
2. Endpoint: https://panelkvm.lwspanel.com/mcp/v1. Transport: HTTP Streamable.
3. Authentication: Bearer Auth, mit dem Wert des Tokens.

Festlegen, was der Assistent tun darf

Ihr MCP-Zugang hat eigene Einstellungen, unabhängig von denen der API:

• die Berechtigungsstufe, eine von drei (siehe unten);
• die steuerbaren Server: Ein VPS außerhalb der Liste ist für den Assistenten unsichtbar;
• die zugelassenen IP-Adressen, optional: Lassen Sie die Liste für Claude und ChatGPT leer, die sich aus ihrer eigenen Infrastruktur verbinden.

Beginnen Sie mit Nur Lesen und erweitern Sie nur bei Bedarf. Jede Erhöhung der Stufe wird Ihnen per E-Mail gemeldet, und der Wechsel zur Stufe Vollständig muss mit einem Code bestätigt werden, der per E-Mail an den Kontoinhaber gesendet wird. Die Rückkehr zu einer niedrigeren Stufe erfordert keinen Code.

Werkzeuge der Stufe Nur Lesen ändern nichts. Die der Stufe Betrieb handeln, ohne etwas zu zerstören: einen VPS starten oder stoppen, einen Snapshot oder ein Backup erstellen, Firewall-Regeln, Reverse DNS, ISO-Images und SSH-Schlüssel verwalten. Die Werkzeuge der Stufe Vollständig sind unumkehrbar oder machen den Server angreifbar: Rückkehr zu einem Snapshot, Wiederherstellung eines Backups, Deaktivierung der Firewall, Rettungsmodus, Root-Passwort, Neuinstallation. Ein Werkzeug oberhalb der gewählten Stufe wird dem Assistenten gar nicht erst angeboten.

Die Kontrolle behalten

• Bestätigung vor jeder Aktion: Der Assistent kündigt an, was er tun wird, und wartet auf Ihre Zustimmung. Bei einer zerstörerischen Aktion (Neuinstallation, Root-Passwort, Löschen eines Snapshots…) muss er einen exakten Satz wiedergeben, zum Beispiel rebuild 107596.
• Simulation vor jeder Änderung der Firewall: hinzugefügte oder entfernte Regeln und eine Warnung, falls der SSH-Zugang unterbrochen werden könnte, ohne etwas anzuwenden.
• Aufrufverlauf: die letzten 50 Aufrufe der letzten 30 Tage (Uhrzeit, Werkzeug, Herkunft, VPS, Ergebnis, IP-Adresse), mit Filtern für Aktionen und Fehler. Die Aktionen erscheinen auch im Aktivitätsprotokoll Ihres Kontos.
• Verbundene Anwendungen: Jeder per OAuth autorisierte Assistent wird dort mit seiner Domain und seiner letzten Nutzung aufgeführt. Widerrufen entzieht ihm sofort den Zugang.
• Jederzeit können Sie das Token neu erzeugen (die Werkzeuge, die es verwenden, werden getrennt) oder den MCP-Zugang per Schalter sperren.

Gut zu wissen

• Ein Assistent kann sich irren: Prüfen Sie seine Vorschläge vor einer Neuinstallation, einer Wiederherstellung oder einer Änderung der Firewall.
• Die Zahl der Aufrufe ist pro Stunde begrenzt: 600 Lesezugriffe und 60 Aktionen pro Konto sowie 3 aufwendige Aktionen (Neuinstallation, Wiederherstellung, Rückkehr zu einem Snapshot, Rettungsmodus) pro VPS, höchstens 20 für das Konto. Darüber hinaus erfährt der Assistent, wie lange er warten muss. Zustand und Metriken eines VPS werden höchstens alle 15 Sekunden aktualisiert.
• Die Texte, die Sie im Panel eingegeben haben (Kommentare, Beschreibungen…), werden dem Assistenten als Daten gekennzeichnet, nie als Anweisungen.
• Eine OAuth-Autorisierung erneuert sich selbst; nach 30 Tagen ohne Nutzung bittet Sie der Assistent um eine neue Autorisierung.
• Was der MCP an den Assistenten zurückgibt (VPS-Liste, Metriken…), wird an dessen Anbieter übermittelt, der es nach seinen eigenen Bedingungen verarbeitet. Der Aufrufverlauf speichert dagegen nie den Inhalt Ihrer Anfragen.
• LWS wird Sie niemals nach Ihrem MCP-Token fragen.