---
title: Mit KI konfigurieren
description: Lassen Sie eine KI Ihr NexCMP einrichten: AI Chat im Admin, Ihr eigener KI-Client über MCP oder eine YAML-Datei. Funktionen und Sicherheitsregeln.
url: https://nexcmp.com/de/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Mit KI konfigurieren {#configure-with-ai}

> **Wo im Adminbereich:** AI Chat (`/agent`) und System › Settings › API & AI agents (`/agent/keys`). Alles auf diesen Seiten ist ausschließlich für Administratoren bestimmt.

## Funktion {#what-it-does}

Ab NexCMP 1.4.0 können Sie einen KI-Assistenten bitten, das Panel für Sie zu konfigurieren: Proxmox VE oder CloudStack verbinden, eine Zone anstellen, eine Tariftabelle aus Ihren Kosten erstellen, E-Mail, Zahlungen und Branding einrichten, einen Kunden finden oder die gesamte Konfiguration exportieren. Der Assistent arbeitet mit einem festen Satz von **Admin-Werkzeugen**. Er erhält niemals eine Shell, liest niemals Dateien auf dem Server und sieht niemals gespeicherte Passwörter oder API-Schlüssel.

Nutzen Sie dies, wenn Sie eine Ersteinrichtung in wenigen Minuten statt nach Klicks durch Dutzende Seiten wünschen oder wenn Sie mehrere Installationen verwalten und deren Konfiguration in einer Datei vorhalten möchten.

## Drei Anwendungsmöglichkeiten {#three-ways-to-use-it}

| Methode | Wer spricht mit der KI | Wo sie ausgeführt wird | Hier starten |
|---|---|---|---|
| **AI Chat im Adminbereich** | Sie, im NexCMP-Adminbereich | Die von Ihnen gewählte KI-Quelle: ein API-Schlüssel von OpenAI, Anthropic, Gemini oder OpenRouter, der eigene KI-Anbieter Ihres Panels oder eine offizielle KI-CLI, bei der Sie angemeldet sind | [AI Chat im Adminbereich](https://nexcmp.com/de/docs/configure-with-ai/ai-chat-in-admin/) |
| **Ihr eigener KI-Client per MCP** | Sie, in Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai oder ChatGPT | Auf Ihrem Rechner oder in der App des Anbieters, verbunden mit Ihrem Panel unter `https://cloud.example.com/mcp/admin` | [Connect an AI client](https://nexcmp.com/de/docs/configure-with-ai/mcp-admin/) |
| **Konfiguration als Code** | Sie oder ein Skript | Eine YAML-Datei und der Befehl `nexcmp config` auf dem Server (oder die Import/Export-Seite) | [Configuration as code](https://nexcmp.com/de/docs/configure-with-ai/config-as-code/) |

Alle drei rufen dieselben Tools auf und laufen durch dieselbe Sicherheitsebene, sodass Sie sie kombinieren können: Entwerfen Sie eine Konfiguration mit einem Assistenten, exportieren Sie sie als YAML, prüfen Sie diese in Ihrem Editor und wenden Sie sie später an.

## Sicherheitsmodell {#safety-model}

| Regel | Was das für Sie bedeutet |
|---|---|
| **Bereiche** | Ein Schlüssel oder eine Verbindung ist auf die von Ihnen markierten Bereiche beschränkt (`admin:read`, `catalog:write`, `infra:write`, `billing:write`, `customers:write`, `settings:write`, `ai:write`, `secrets:write`). Ohne Bereich wird der Aufruf verweigert. Siehe [Admin API keys](https://nexcmp.com/de/docs/configure-with-ai/admin-api-keys/#scopes). |
| **Expiry** | Jeder Schlüssel und jede Verbindung läuft ab: 1 bis 90 Tage für von Ihnen erstellte Schlüssel, standardmäßig 30 Tage. OAuth-Zugriffstoken sind eine Stunde gültig. |
| **IP-Beschränkung und Rate Limit** | Ein Schlüssel kann auf IP-Bereiche und eine bestimmte Anzahl von Aufrufen pro Minute (standardmäßig 120) beschränkt werden. |
| **Zweistufige Bestätigung** | Aktionen, die Geld bewegen, Daten löschen, Zahlungsdaten ändern oder die Anmeldesicherheit anpassen, liefern zuerst eine Vorschau und führen erst nach Ihrer Freigabe eine Aktion aus. Im AI Chat ist jede Änderung eine Bestätigungskarte, die Sie selbst auslösen. |
| **Dinge, die Schlüssel niemals tun können** | Administratoren erstellen, 2FA ändern, Schlüssel erstellen oder widerrufen, sich als Kunde anmelden, Backups erstellen, das Panel wiederherstellen oder aktualisieren und Ähnliches. Hierfür ist Ihre Anwesenheit im Adminbereich erforderlich. |
| **Aktivitätsprotokoll** | Jeder Aufruf, ob zugelassen oder verweigert, wird mit Schlüssel, Client, Tool, IP und Ergebnis protokolliert. Siehe System › Settings › API & AI agents › Activity. |
| **Geheimnisse werden niemals zurückgegeben** | Passwörter, API-Keys und Token können gesetzt, aber niemals ausgelesen werden. Die Antworten, die die AI sieht, zeigen diese maskiert. |
| **Demo-Installationen sind schreibgeschützt** | Auf einem Demo-Panel wird jeder Schreibzugriff mit `demo_read_only` abgelehnt. |

::: important Was die AI lesen kann
Mit `admin:read` kann ein Assistent Kundennamen, E-Mail-Adressen, Guthaben und Abrechnungsdaten einsehen. Wenn Sie eine AI-Source verwenden, die bei einem Anbieter (OpenAI, Anthropic, Google, OpenRouter) läuft, werden diese Daten zur Beantwortung Ihrer Frage an diesen Anbieter übermittelt. Geben Sie einem Assistenten nur die minimal erforderlichen Berechtigungen und wählen Sie eine Source, der Sie diese Daten anvertrauen.
:::

## Schnellstart {#quick-start}

1. Melden Sie sich im Admin-Bereich an und öffnen Sie **AI Chat**. Wenn noch keine AI-Source verbunden ist, öffnen Sie **System › Settings › AI accounts** und verbinden Sie eine (siehe [AI accounts and subscriptions](https://nexcmp.com/de/docs/configure-with-ai/ai-accounts-and-subscriptions/)).
2. Tippen Sie "Check my setup progress" ein und drücken Sie die Eingabetaste. Der Assistent liest die [Setup progress checklist](https://nexcmp.com/de/docs/configure-with-ai/setup-checklist/) aus und teilt Ihnen mit, was noch zu tun ist.
3. Bitten Sie ihn, den nächsten Schritt auszuführen. Prüfen Sie jede Bestätigungskarte und drücken Sie auf **Confirm**, um sie anzuwenden.

Einen ersten Überblick über mögliche Fragen finden Sie unter [Example prompts](https://nexcmp.com/de/docs/configure-with-ai/example-prompts/).

![AI Chat-Seite mit einer Unterhaltung, einem Tool-Ergebnis und einer Bestätigungskarte](https://nexcmp.com/de/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## Limits & Hinweise {#limits-notes}

- **Demo und schreibgeschützt.** Die Seiten sind auf einem Demo-Panel sichtbar, es können dort jedoch keine Änderungen gespeichert werden.
- **Keine Shell.** Der Assistent kann nur die Admin-Tools aufrufen, die unter [Connect an AI client](https://nexcmp.com/de/docs/configure-with-ai/mcp-admin/#tools) aufgeführt sind. Er kann keine Befehle auf dem Server ausführen.
- **Netzwerk- und Routing-Module** (BGP, XDP, Schnittstellen, NAT und ähnliches) sind für die AI schreibgeschützt, und sensible Bereiche wie Administrator-Konten, Backups und Updates sind für Keys vollständig gesperrt.
- **Preise** sind in USD angegeben: Tarife in Dollar pro Stunde, Guthaben in Cent.
- **Kosten.** AI-Antworten werden über die von Ihnen verbundene AI-Source abgerechnet (API-Nutzung oder Ihr eigenes Abonnement). Im AI Chat können Sie ein tägliches Ausgabenlimit festlegen. Informationen zum NexCMP-Lizenzmodell finden Sie unter https://nexcmp.com/pricing.

## Fehlerbehebung {#troubleshooting}

| Symptom | Ursache | Behebung |
|---|---|---|
| AI Chat meldet, dass keine AI-Source verbunden ist | Für Ihr Admin-Konto ist keine Source eingerichtet | Öffnen Sie System › Settings › AI accounts und verbinden Sie eine. |
| Ein Assistent antwortet `insufficient_scope` | Dem Key oder der Verbindung fehlt die Berechtigung für dieses Tool | Erstellen Sie einen Key mit der erforderlichen Berechtigung oder stellen Sie die Verbindung neu her und wählen Sie ihn auf dem Einwilligungsbildschirm aus. Siehe [Admin API keys](https://nexcmp.com/de/docs/configure-with-ai/admin-api-keys/#errors). |
| Jede Änderung zeigt eine Bestätigungskarte an | Erwartetes Verhalten im AI Chat | Drücken Sie auf **Confirm** zum Anwenden oder auf **Reject** zum Abbrechen. |
| Schreibzugriffe schlagen fehl mit `demo_read_only` | Das Panel befindet sich im Demo-Modus | Verwenden Sie eine Nicht-Demo-Installation. |