Diese Seite wurde maschinell übersetzt. Lesen Sie das englische Original. English

KI-Assistent unter menschlicher Kontrolle

HQbird MCP verbindet Firebird mit einem KI-Assistenten. Sie schreiben in einfachen Worten, und der Assistent wählt die Werkzeuge selbst. Er liest frei. Jede Änderung wartet auf Ihr „Ja“, und eine gefährliche wartet auf die Freigabe auf dem Server selbst.

  • 122 Werkzeuge
  • 56 nur lesend
  • Firebird 2.5–5 Windows und Linux
  • 2 Kanäle für die Freigabe
  • Audit-Log mit Hash-Kette

Beispiel

Ein Gespräch mit dem Assistenten

Benutzer beschweren sich, dass die Datenbank langsam ist. Der Assistent liest die Daten, findet die Ursache, schlägt eine Aktion vor und wartet auf Ihre Entscheidung. Namen und Zahlen im Beispiel sind erfunden.

Jeder MCP-Client funktioniert: Claude Desktop, Claude Code, Cursor, Codex, ZCode und andere.

    Richtlinie · Freigabe

    Vier Gefahrenstufen

    Jedes Werkzeug hat eine Stufe. Der MCP-Server prüft die Stufe und die Bedingungen selbst, bevor der Aufruf ausgeführt wird. Ein Aufruf, der etwas ändert, liefert eine Freigabeanfrage statt eines Ergebnisses. Der Assistent kann diese Prüfung nicht umgehen.

    Wählen Sie ein Werkzeug und sehen Sie, welchen Weg sein Aufruf nimmt.

    Call path: assistant, fbmcp policy check, four levels, audit log
    StufeWerkzeugeBeispieleWie sie freigegeben wird
    0 · Lesen51Sitzungen, Transaktionen, Abfrageplan, gstat, firebird.log, Agent-BerichteNicht erforderlich. Nur-Lese-Transaktion.
    1 · Änderung31DML und DDL, Backup, Test-Restore, Sweep, Benutzer und Rechte, Beenden einer SitzungIm Chat: Anfragenummer und Token, dann fb_confirm.
    2 · Gefährliche Operation14Datenbank aus einem Backup ersetzen, firebird.conf bearbeiten, Firebird stoppen und neu startenNur auf dem Server: der Befehl fbmcp ctl approve. Unter Windows können Sie auch ein Tray-Fenster installieren.
    3 · Deaktiviert1Datenbank löschenWird nie ausgeführt.
    • VorschauJedes Werkzeug, das eine Freigabe benötigt, akzeptiert mode: preview. Es zeigt, was getan wird, und tut nichts.
    • Bedingungen für Stufe 2Jede Operation der Stufe 2 benötigt ein offenes Wartungsfenster für diese Datenbank. Das Ersetzen einer Datenbank aus einem Backup, ein exklusives Fenster und gefährliches SQL benötigen außerdem ein verifiziertes Backup, das nicht älter als 24 Stunden ist. Eine Ablehnung sagt, was fehlt.
    • Nur erlaubte WerkzeugeDer Client sieht in der Liste nur, was er verwenden darf: keine Stufe 3 und keine Stufen über dem Maximum seines Schlüssels. Ein direkter Aufruf eines verborgenen Werkzeugs wird abgelehnt.
    • Eine Anfrage lebt 15 MinutenEin Versuch, sie über den falschen Kanal freizugeben, verbraucht sie nicht. fb_cancel löscht die Anfrage.
    • Keine FreigabeseiteUnd es wird keine geben: Eine Seite, die das Modell erreichen kann, würde den Schutz aushebeln. Nur ein Mensch auf dem Server gibt frei: mit dem Befehl fbmcp ctl approve oder im Tray-Fenster, falls es installiert ist.

    Lesevorgänge laufen in einer Nur-Lese-Transaktion: Firebird selbst blockiert Schreibvorgänge. Für eine zweite Schutzschicht legen Sie einen separaten Nur-Lese-Benutzer ohne Schreibrechte an.

    Monitoring · Backups · Rechte

    Für DBAs

    Der Assistent erledigt, was ein DBA von Hand tut: prüft Sitzungen und Transaktionen, liest Logs, erstellt ein Backup und verifiziert es mit einem Restore, verwaltet Benutzer. Datenbanken werden über ihre id benannt, nicht über den Dateipfad.

    AufgabeWerkzeugeStufe
    Läuft allesfb_ping, fb_db_list, fb_db_health, fb_service_status0
    Sitzungen und lange Transaktionenfb_sessions, fb_transactions; zum Beenden einer Sitzung — fb_session_kill0 · 1
    Logs und Statistikenfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Backup und Verifikationfb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Alte Backupsfb_retention_run: zuerst ein Dry Run; löscht nur verifizierte Backups aus dem eigenen Katalog1
    Sweep und Datenbankvalidierungfb_sweep, fb_validate (nur Befunde, keine Reparatur)1
    Benutzer und Rechtefb_user_create, fb_grant, fb_revoke; SYSDBA und die eigenen Konten können nicht gelöscht werden1
    Tracesfb_trace_start nur mit Vorlagen: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; zum Bearbeiten — fb_config_set, Firebird wird nicht neu gestartet0 · 2
    Dienst und Datenbankersetzungfb_service_restart; fb_restore_replace, die alte Datei bleibt als .pre-restore2

    Nächtliche Backup-Prüfung

    Der Zeitplan wird einmal bei der Erstellung freigegeben. Danach läuft er ohne einen Menschen. Jede Nacht erhalten Sie ein verifiziertes Backup. Sie brauchen eines zum Beispiel, um eine Datenbank aus einem Backup zu ersetzen.

    1. 1Zeitplanfb_schedule_create, Ziel nightly_verify; einmal freigegeben
    2. 2Backupgbak in den Backup-Ordner
    3. 3Test-Restorein einen Arbeitsordner; die Quelldatenbank wird nicht berührt
    4. 4✓ Backup verifizierteine Markierung im Backup-Katalog

    Das Ersetzen einer Datenbank aus einem Backup und Operationen der Stufe 3 können nicht geplant werden.

    Fertige Szenarien

    Szenarien schlagen dem Assistenten die Reihenfolge der Schritte vor. Er wendet Änderungen nicht von selbst an.

    Health Check Optimierung Sicherheitsaudit DDL-Review Migrationsplan Katastrophenbereitschaft Query Builder

    Abfragen · Indizes · Migrationen

    Für Entwickler

    Der Assistent in Cursor oder Claude Code kennt Ihr Schema, prüft eine Abfrage, bevor sie ausgeführt wird, und zeigt das Ergebnis als Tabelle direkt im Chat.

    1. 1Aufgabewas Sie brauchen, in einem Satz
    2. 2Faktenfb_schema_list, fb_describe: nur vorhandene Tabellen und Spalten
    3. 3Entwurfein SELECT mit ORDER BY
    4. 4Prüfungfb_query_check: kompilieren ohne Ausführen
    5. 5✓ Tabelle im Chatfb_query: Zeilen, Plan und Statistiken

    Ergebnis als Tabelle

    In Clients, die MCP Apps unterstützen, wird das Ergebnis von fb_query als sortierbare Tabelle angezeigt. Andere Clients erhalten dieselben Daten als Text.

    Standardmäßig 100 Zeilen, höchstens 1000. Die Tabelle bleibt 30 Minuten im Speicher, und nur die Person, die sie angefordert hat, kann sie sehen. Klicken Sie auf einen Spaltenkopf, um zu sortieren.

    SELECT full_name, dept_no, salary
    FROM employee
    WHERE salary > 60000
    ORDER BY salary DESC
    6 Zeilen · PLAN SORT (EMPLOYEE NATURAL) · nur lesend
    fb_index_advice

    Index-Empfehlung

    Findet vollständige Tabellenscans und schlägt CREATE INDEX mit einer Schätzung des Nutzens vor. Der Index selbst wird nicht angelegt: Das erledigt fb_write, mit Genehmigung. Nachdem der Index angelegt wurde, wird der Plan erneut geprüft.

    fb_diff_schema · fb_diff_data

    Datenbankvergleich

    Schema zweier Datenbanken oder einer Datenbank und ihres Snapshots: was anzulegen, zu ändern, zu löschen ist. Daten werden über den Primärschlüssel verglichen; eine große Tabelle wird vom Tool nicht verglichen (standardmäßig mehr als 100.000 Zeilen).

    fb_migration_*

    Migrationen

    Der Plan zeigt die Stufe jeder Anweisung. Alle Migrationen werden nach einer Genehmigung angewendet; ändert sich eine Datei, ist eine neue Anfrage erforderlich. Der Rollback-Plan wird aus dem aufgebaut, was beim Anwenden der Migrationen aufgezeichnet wurde.

    fb_write ermittelt die Stufe jeder Anweisung in einem Skript. Ein Skript, das Anweisungen unterschiedlicher Stufen mischt, wird abgelehnt.

    fbagent · Lokale API · 127.0.0.1

    fbagent-Daten

    Der fbagent-Agent läuft bereits auf dem HQbird-Server. Über MCP erhält der Assistent alles, was der Agent gesammelt hat: den Health-Report, LWM (Light-weight Monitoring), gstat, Traces, Deadlocks, Backup-Status. Er führt außerdem Agent-Jobs aus und ändert deren Einstellungen, unter denselben Stufen und Genehmigungen.

    WasToolsStufe
    Server-Health-Reportfb_agent_status0
    LWM, gstat, Datenbankmetriken, Traces, Deadlocksfb_agent_artifact_get, fb_agent_perf_report0
    Backup-, Sweep- und Restore-Einstellungenfb_agent_backup_config; Passwörter und Tokens sind ausgeblendet0
    Einen Agent-Job ausführenfb_agent_job_run; Backup, Restore und SQL-Skript sind Stufe 21 · 2
    Eine Job-Einstellung ändernfb_agent_config_set; Anmeldedaten, IDs und Befehle können nicht geändert werden2
    Firebird über den Agenten neu startenfb_agent_restart, fb_agent_stop, fb_agent_start2
    Lizenz und Updatesfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 1 · 2
    • Nur lokalDer Agent akzeptiert Anfragen nur auf 127.0.0.1. Die Agent-Adresse stammt aus der Konfiguration des MCP-Servers, nicht aus dem Chat.
    • Token bleibt verborgenDas Agent-Token erscheint weder in der Tool-Ausgabe noch im Audit-Log.
    • Agent-Erkennungfb_agent_discover findet Agenten auf dem Server über Windows-Dienste oder systemd-Units. Tokens werden nicht gelesen.
    • ClusterWenn auf dem Server ein Cluster-Knoten installiert ist, verweigern fb_agent_restart, fb_agent_stop und fb_agent_start standardmäßig: Der Knoten steuert Neustarts. fb_service_restart prüft dies nicht, daher nicht auf einem Cluster-Knoten verwenden.

    Doppelte Kontrolle. Der MCP-Server genehmigt die Anfrage, und der Agent selbst führt den Job nach seinen eigenen Regeln aus. Das MCP-Log zeigt, wer gefragt hat; die Agent-Logs zeigen, wie es gemacht wurde.

    HQbird Cluster · RCM

    Replikationscluster über den Assistenten

    Der Assistent baut Schritt für Schritt einen Replikationscluster auf: Er aktiviert RCM, öffnet das Pairing-Fenster, verbindet die Hosts, nimmt Datenbanken unter Verwaltung und erstellt eine Kopie für die Replik. Er arbeitet über den Agenten und RCM. Sie müssen sich nicht per SSH auf den Servern anmelden.

    Die Regeln sind überall dieselben. Lesezugriffe erfordern keine Bestätigung. Eine Änderung wird im Chat bestätigt. Ein Firebird-Neustart, eine Datenbankkopie auf die Replik, das Entfernen eines Servers aus dem Cluster, Switchover, Failover und die Rückkehr des alten Masters werden auf dem Server bestätigt.

    WasToolsStufe
    Cluster-Status auf dem Serverfb_agent_cluster: frei, in einem Cluster oder RCM-Owner; Slot und Ports0
    Cluster-Übersicht in RCMfb_cluster_status: Knoten, Datenbanken, Befehle, Alerts0
    Hosts vor dem Verbinden prüfenfb_cluster_probe: eine Zeile pro Agent, Zertifikat-Fingerprint0
    Master und Replik vergleichenfb_cluster_verify: Zeilenanzahl jeder Tabelle0
    RCM auf dem Server aktivierenfb_agent_cluster_rcm1
    Pairing-Fensterfb_agent_cluster_pairing: Status, 1–24 Stunden geöffnet, schließen0 · 1
    Hosts verbindenfb_cluster_link; die Anfrage zeigt Fingerprints zum Vergleichen1
    Datenbanken und Publikationfb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    RCM-Passwortfb_cluster_rcm_password: ein neues Zufallspasswort, nicht im Chat angezeigt1
    Datenbankkopie auf die Replikfb_cluster_reinit2
    Firebird eines Knotens neu startenfb_cluster_firebird_restart2
    Einen Server aus dem Cluster entfernenfb_cluster_unlink2
    Services: wo der Master istfb_cluster_service: Master, Repliken, Router, Probleme, laufende Operation0
    Einen Service und seine Regel beschreibenfb_cluster_service_put, fb_cluster_service_policy: Service-Beschreibung, Regel für automatisches Failover1
    Eine Operation fortsetzen und abbrechenfb_cluster_resume, fb_cluster_operation_cancel; Abbruch nur vor dem Point of no Return1
    Switchoverfb_cluster_switchover: geplanter Umzug des Masters, wartet auf das Ende der Operation2
    Failoverfb_cluster_failover: nur mit ausdrücklicher Zustimmung zu Datenverlust2
    Den alten Master zurückholenfb_cluster_rejoin2
    Einen Service löschenfb_cluster_service_delete: nur der Eintrag in RCM wird gelöscht2
    • Fertiges Szenario„Cluster aufbauen“: Der Assistent geht Schritt für Schritt vor und zeigt bei jedem Schritt, was er tun wird.
    • FingerprintsVor dem Verbinden zeigt der Assistent den Zertifikat-Fingerprint jedes Servers. Vergleichen Sie ihn mit der Zeile aus der Installationszusammenfassung.
    • ProbelaufBevor er einen Ordner mit Datenbanken unter Verwaltung nimmt, zeigt der Assistent, welche Datenbanken RCM finden wird.
    • Switchover und FailoverDer Assistent startet den Umzug des Masters und verfolgt die Schritte der Operation. Eine Person auf dem Server bestätigt den Start. Failover erfordert außerdem eine ausdrückliche Zustimmung zu Datenverlust. Mehr auf der Cluster-Seite.

    HTTPS · API-Schlüssel · Audit

    Remote-Modus, Installation und Audit-Log

    Der Assistent läuft auf dem PC des Administrators, und der MCP-Server läuft auf dem Datenbankserver. Dazwischen liegen HTTPS und ein API-Schlüssel. Jede Person hat ihren eigenen Schlüssel und ihre eigene maximale Stufe.

    Admin-PC mit einem MCP-Client und fbmcp-Bridge, HTTPS durch eine Firewall zum fbmcp-Dienst; fbmcp kommuniziert mit Firebird und fbagent; eine Person auf dem Server genehmigt gefährliche Anfragen
    Remote-Modus. Die Bridge auf dem PC holt den Schlüssel aus dem Schlüsselspeicher des Betriebssystems und prüft das Serverzertifikat per Pin. Passwörter und Datenbankpfade gelangen nicht in den Chat: Datenbanken werden über ihre ID benannt.
    • Ein Schlüssel für jede Personfbmcp ctl apikey new <name> --max-tier 2. Der Wert wird einmal angezeigt. Nach einer Schlüsseländerung funktioniert der alte Schlüssel innerhalb weniger Sekunden nicht mehr.
    • LimitsPro Schlüssel: gleichzeitige Aufrufe, Aufrufe pro Minute, offene Sitzungen. Über dem Limit lautet die Antwort 429.
    • Anleitung auf PortugiesischDie vollständige Anleitung zu Installation und Nutzung ist auch in brasilianischem Portugiesisch verfügbar.
    • Autonome AgentenDas Profil autonomous: standardmäßig nur Lesen. Eine Änderung wartet auf einen Operator auf dem Server; fb_confirm vom Agenten wird abgelehnt. 10 Aufrufe pro Minute. Führen Sie solche Agenten innerhalb des Firmennetzwerks aus.
    • AdressenEin Schlüssel kann an Adressen gebunden werden (allow_from). Eine andere Adresse erhält 403 und einen Eintrag im Log.

    Installation in HQbird

    Der HQbird-Installer installiert den MCP-Server standardmäßig. Ein Server bedient alle Firebird-Linien auf der Maschine. Ein Befehl richtet alles ein, und Sie können ihn erneut ausführen.

    1. 1HQbird-InstallerWindows oder Linux
    2. 2fbmcp ctl hqbird-installein Befehl, keine manuellen YAML-Änderungen
    3. 3Firebird-Linienfindet jede Linie und ihren Agenten
    4. 4Datenbankendatabases.conf-Aliase und kürzlich verbundene Datenbanken
    5. 5✓ Dienststart, check, connect.txt-Datei für Clients

    Der Remote-Modus wird aktiviert, wenn drei Bedingungen erfüllt sind: Eine Liste der Administratoradressen ist festgelegt (--allow-from), die Firewall läuft und mindestens ein API-Schlüssel existiert. Den Schlüssel erstellen Sie separat. Führen Sie danach erneut fbmcp ctl hqbird-install aus. Der Standardport ist 8650.

    audit.jsonl

    Hash-Kette

    Jede Entscheidung (erlaubt, ausstehend, genehmigt, abgelehnt) wird ins Protokoll geschrieben. Jeder Eintrag ist mit dem vorherigen verknüpft. Eine Kettenprüfung zeigt, ob ein Eintrag geändert oder gelöscht wurde.

    Fehler — Stopp

    Protokoll abgeschnitten — Server bleibt unten

    Wenn das Protokoll abgeschnitten ist oder sein Ende nicht mit dem Kontrolleintrag übereinstimmt, startet der MCP-Server nicht. Das ist ein Hinweis auf Manipulation, und Sie müssen dies untersuchen. Der Befehl fbmcp ctl verify prüft die gesamte Kette.

    Update

    Über den Agenten

    fbagent aktualisiert den MCP-Server: stoppen, ersetzen, starten, prüfen, bei Fehler zurückrollen. Unter Linux wird ein unsignierter Build nicht installiert. Konfiguration und Schlüssel ändern sich nicht.

    ← Zurück zur Übersicht von HQbird 2027