Claude Code mit Ihrem Panel verbinden — Dokumentation

Mit dieser Einrichtung kann Claude Code in Ihr Panel schauen, während Sie im Terminal arbeiten: „Welches meiner Konten ist seinem Speicherlimit am nächsten?“, „Zeige die DNS-Einträge für example.com.“ Es liest nur, was Ihr Token erlaubt. Alles, was löscht oder unterbricht, wird zu einer Anfrage, die darauf wartet, dass Sie im Panel auf Genehmigen drücken. Der Assistent genehmigt seine eigene Anfrage nie.

Das ist der zweite Weg, KI mit Nimbopanel zu nutzen. Der erste, ein Chat-Fenster im Panel selbst, ist in KI-Assistent beschrieben. Sie brauchen ihn nicht, um diesen Weg zu nutzen.

Bevor Sie anfangen

Die Adresse Ihres Panels, zum Beispiel https://panel.yourdomain.com. Verwenden Sie die eigene Adresse des Panels, keine IP-Adresse.
Claude Code auf Ihrem Computer installiert (der Befehl claude funktioniert im Terminal).
Ein Konto im Panel: Administrator, Reseller, Kunde oder Teamnutzer.

1. Der Administrator schaltet die Verbindung ein (einmalig)

Öffnen Sie System → Sicherheit → KI-Assistenten-Verbindung (MCP), setzen Sie das Häkchen bei KI-Assistenten verbinden lassen, wählen Sie, welche Arten von Personen eine Verbindung herstellen dürfen, und drücken Sie Speichern. Die Karte zeigt die Adresse, die Assistenten verwenden: /mcp an der Adresse Ihres Panels.

Bei einer neuen Installation ist das ausgeschaltet. Solange es aus ist, antwortet /mcp mit 404, und nichts von dem Folgenden funktioniert.

2. Ein Token nur für den Assistenten erstellen

Melden Sie sich im Panel an und öffnen Sie API-Token: bei Administratoren und Resellern unter Sicherheit, bei Kunden unter Erweitert. Öffnen Sie Einen KI-Assistenten verbinden (Claude und andere).

Geben Sie einen Namen, den Sie wiedererkennen, etwa Claude Code auf meinem Laptop.
Wählen Sie für jeden Teil des Panels Kein Zugriff, Lesen oder Lesen und ändern. Beginnen Sie mit Lesen: Der Assistent kann dann alles ansehen, was Sie ausgewählt haben, und nichts ändern.
Lassen Sie Läuft ab nach (Tagen) bei 90 oder tragen Sie eine eigene Zahl ein.
Drücken Sie Assistenten-Token erstellen.

Das Panel zeigt das Token jetzt nur einmal. Kopieren Sie es, bevor Sie die Seite verlassen.

3. Einen Befehl einfügen

Das Panel zeigt den Befehl mit Ihrer Adresse und dem Token bereits darin. Kopieren Sie ihn und führen Sie ihn im Terminal aus. Er sieht so aus:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

Was er bedeutet: Füge einen MCP-Server namens nimbopanel hinzu, erreichbar über HTTP unter der /mcp-Adresse des Panels, und sende bei jedem Aufruf Ihr Token im Header Authorization.

Wo Claude Code es speichert. Standardmäßig wird der Server nur für das aktuelle Projekt gespeichert, und zwar in ~/.claude.json auf Ihrem Computer, nicht im Projektordner. Mit --scope user gilt er in jedem Projekt. Fügen Sie mit einem echten Token nicht --scope project hinzu: Das schreibt das Token in .mcp.json, eine Datei, die dafür gedacht ist, eingecheckt und geteilt zu werden. Teilt ein Team die Verbindung, tragen Sie in .mcp.json nur einen Verweis ein und lassen Sie jede Person ihr eigenes Token in einer Umgebungsvariablen behalten:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

Jede Person sollte ihr eigenes Token erstellen, damit bei einer Anfrage sichtbar ist, wer gefragt hat, und ein Token einzeln widerrufen werden kann.

4. Prüfen, ob es funktioniert

claude mcp list

nimbopanel sollte als verbunden angezeigt werden. In Claude Code können Sie auch /mcp eingeben. Fragen Sie dann in ganz normalen Worten:

„Liste meine Hosting-Konten auf und sag mir, welches am meisten Speicherplatz belegt.“
„Zeige die DNS-Einträge für example.com.“
„Welche meiner Datenbanken sind am größten?“
Administratoren: „Laufen alle Dienste?“, „Wächst die Mail-Warteschlange?“

Der Assistent kann Konten und ihre Auslastung, Domains, DNS-Einträge, E-Mail-Konten (nie Passwörter), Datenbanken, Backups, Serverlast und Dienste, die Mail-Warteschlange, Reseller und Support-Tickets ansehen, und zwar innerhalb der Teile, die Ihr Token nennt, und Ihrer eigenen Rolle.

Wenn Sie um eine Änderung bitten

Mit Lesen und ändern wird ein gewöhnlicher neuer Adresseintrag (A oder AAAA) oder Texteintrag (TXT) für einen neuen, alltäglichen Namen sofort hinzugefügt.
Alles andere wartet auf Sie: einen Eintrag löschen, ein Konto sperren oder wieder aktivieren, E-Mail-Einträge, die Domain selbst, CNAME-, SRV- und CAA-Einträge, Wildcards und Namen, die E-Mail-Programme abfragen. Es wird zu einer Anfrage.

Öffnen Sie API-Token → Anfragen des Assistenten. Jede Anfrage sagt in einfachen Worten, was geschehen wird. Drücken Sie Genehmigen… und dann Ja, jetzt ausführen. Eine Anfrage verfällt nach 30 Minuten. Lesen Sie die Anfrage, nicht die Nachricht des Assistenten: Die Anfrage schreibt das Panel, und sie sagt genau, was getan wird.

Weil ein Assistent die Änderung angefragt hat, bittet das Panel Sie zuerst, mit Ihrem Passwort (und Ihrem Bestätigungscode, falls Sie die Anmeldung in zwei Schritten nutzen) zu bestätigen, dass Sie es sind; danach fragt es einige Minuten lang nicht erneut.

Wenn es nicht funktioniert

Sie sehen	Das bedeutet	Was zu tun ist
`404 Not found` von `/mcp`, oder eine Seite, die sagt, dass für die Adresse keine Website eingerichtet ist	Die Verbindung ist ausgeschaltet, oder Sie haben eine Adresse verwendet, die nicht die eigene Adresse Ihres Panels ist (eine IP-Adresse oder eine andere Domain)	Schritt 1; verwenden Sie die eigene Adresse des Panels, die auf `/mcp` endet
`403 forbidden_host`	Die Adresse erreicht das Panel, ist aber keine, die es als seine eigene erkennt	Verwenden Sie die eigene Adresse des Panels, zum Beispiel `https://panel.yourdomain.com`
`401 Login required`	Das Token fehlt, ist falsch getippt, abgelaufen oder widerrufen	Erstellen Sie ein neues Token und führen Sie den Befehl erneut aus
`403 mcp_scope_required`	Das ist ein gewöhnliches API-Token, keines für Assistenten	Erstellen Sie ein Token unter Einen KI-Assistenten verbinden
`403 mcp_off_for_role`	Ihre Kontoart darf keinen Assistenten verbinden	Fragen Sie den Administrator (Schritt 1)
`429 rate_limited`	Zu viele Aufrufe in kurzer Zeit	Warten Sie eine Minute
Ein Teil des Panels fehlt	Sein Bereich steht auf Kein Zugriff	Erstellen Sie ein neues Token mit diesem Bereich auf Lesen

Zeigt claude mcp list einen Fehler, fehlt meist /mcp in der URL, oder der Header lautet nicht genau Authorization: Bearer <token>.

Wieder entfernen

claude mcp remove nimbopanel

entfernt die Verbindung von Ihrem Computer. Damit das Token überall nicht mehr funktioniert, löschen Sie es unter API-Token; jede offene Anfrage, die es hinterlassen hat, wird abgebrochen. Der Administrator kann die gesamte Verbindung in Schritt 1 ausschalten, und /mcp antwortet wieder mit 404.

Gute Gewohnheiten

Bevorzugen Sie Lesen. Nutzen Sie Lesen und ändern nur für die Bereiche, die es brauchen.
Ein Token pro Computer oder Person, mit einem Namen, der sagt, wem es gehört.
Behalten Sie die 90 Tage als Standard oder wählen Sie für einen gemeinsam genutzten Rechner einen kürzeren Zeitraum.
Fügen Sie ein Token nie in einen Chat, ein Ticket oder eine Datei ein, die Sie einchecken.

Noch nicht unterstützt: Clients, die sich nur mit einer OAuth-Anmeldung verbinden können. Dieser Endpunkt nimmt ein Token im Header entgegen.