Überblick über die Administrationsoberfläche

Die Administrationsoberfläche ist die Steuerungsebene für Betreiber von hs-sql-agent. Betreiber legen fest, welche Ressourcen ein MCP-Client erreichen darf und wie SQL kontrolliert wird; MCP-Clients verwenden anschließend den separat authentifizierten Endpunkt /mcp.

Database Management Provider-Verbindungen registrieren, die Erreichbarkeit prüfen und steuern, an welche Datenbank ein MCP-Schlüssel gebunden werden darf.

MCP Keys MCP-Zugangsdaten ausstellen, rotieren, widerrufen, einschränken und Client-Konfiguration erzeugen.

Semantic Metadata Schema-Erkennung um verständliche Namen, Beschreibungen, Synonyme, Beziehungen und Metriken ergänzen.

Custom Tools Kontrollierte SQL-Operationen als benannte MCP-Tools veröffentlichen, ohne die Runtime-Richtlinien zu umgehen.

Sicherheit Authentifizierung, Autorisierung, Tabellen-/Tool-Grenzen, fail-closed SQL-Richtlinien und Audit-Grenzen verstehen.

Betrieb Deployment, gemeinsamen Zustand, Observability, Aufbewahrung, Limits und Produktionsverhalten konfigurieren.

Identität, Governance und Betrieb

Members & Roles Admin-Benutzer anlegen, Rollen zuweisen, Sitzungen widerrufen und den Rollen-Lebenszyklus sicher verwalten.

Permissions Das von Admin-Controllern erzwungene Modell aus Berechtigungspfad und Aktion verstehen.

Audit Runtime- und Sicherheitsereignisse suchen, zusammenfassen, exportieren und Aufbewahrung anwenden.

Security Policies Query-, DML-, Schlüssel-Limits und SQL-Parallelität verwalten.

Operability Ausführungsmetriken, Datenbankzustand, Schlüsselnutzung und ausgehende Zustellungen untersuchen.

Admin HTTP API Die quellcodebasierten 2.0.2/2.0.2-Controller-Routen und Autorisierungsoberfläche der mitgelieferten UI nachschlagen.

Empfohlener Betreiberablauf

01 Datenbank registrieren

02 MCP-Schlüssel ausstellen

03 Tool-/Tabellenumfang festlegen

04 Metadaten anreichern

05 Client verbinden

06 Beobachten und auditieren

Registrieren und prüfen Sie die Datenbankverbindung, die der Agent verwenden soll.
Stellen Sie einen an diese Datenbank gebundenen MCP-Schlüssel aus und erlauben Sie nur die benötigten Tools und Tabellen.
Ergänzen Sie semantische Metadaten, wenn physische Schemanamen für eine verlässliche Agent-Erkennung nicht ausreichen.
Erzeugen Sie die Client-Konfiguration und verbinden Sie den Client über den öffentlichen Streamable-HTTP-Endpunkt /mcp.
Nutzen Sie Audit und Operability, um das Runtime-Verhalten zu prüfen und Richtlinien bei Bedarf enger zu fassen.

Lebenszyklus von MCP-Schlüsseln

Beim Ausstellen, Rotieren oder Duplizieren eines Schlüssels kann die UI direkte Streamable-HTTP-Konfiguration für unterstützte Client-Formate erzeugen. Das Klartext-Secret wird nur in diesem Lebenszyklusdialog angezeigt und nicht für eine spätere Anzeige gespeichert.

Kopieren Sie die erzeugte Konfiguration, bevor Sie den Dialog schließen.

Eingebettete UI und eingebaute Identität sind optional

Ein ASP.NET-Core-Host kann die HsSqlAgent Admin API bereitstellen, ohne die mitgelieferte Admin UI auszuliefern. Verwenden Sie im modularen Integrationspfad UseHsSqlAgentAdminApi() und lassen Sie den Host MapControllers() aufrufen; fügen Sie UseHsSqlAgentAdminUi() nur hinzu, wenn die mitgelieferte UI gewünscht ist.

Mit AddHsSqlAgentHostAuthorization(...) kann der Host außerdem sein bestehendes Login- und Berechtigungssystem beibehalten, statt HsSqlAgent-Members, Rollen, JWT, SMTP oder OIDC zu installieren. MCP wird unabhängig mit AddHsSqlAgentMcp(...) / UseHsSqlAgentMcp() ausgewählt und eingebunden.

Das vollständige 2.0.2-Kompositionsmodell finden Sie unter ASP.NET-Core-Integration.