Deze pagina is automatisch vertaald. Lees het Engelse origineel. English

AI-assistent onder menselijke controle

HQbird MCP verbindt Firebird met een AI-assistent. Je schrijft in gewone woorden en de assistent kiest zelf de tools. Lezen mag vrij. Elke wijziging wacht op jouw “ja”, en een gevaarlijke wijziging wacht op goedkeuring op de server zelf.

  • 122 tools
  • 56 alleen-lezen
  • Firebird 2.5–5 Windows en Linux
  • 2 kanalen voor goedkeuring
  • auditlog met een hashketen

Voorbeeld

Een gesprek met de assistent

Gebruikers klagen dat de database traag is. De assistent leest de gegevens, vindt de oorzaak, stelt een actie voor en wacht op jouw beslissing. Namen en getallen in het voorbeeld zijn verzonnen.

Elke MCP-client werkt: Claude Desktop, Claude Code, Cursor, Codex, ZCode en andere.

    Beleid · goedkeuring

    Vier gevarenniveaus

    Elke tool heeft een niveau. De MCP-server controleert zelf het niveau en de voorwaarden voordat de aanroep wordt uitgevoerd. Een aanroep die iets wijzigt, geeft een goedkeuringsverzoek terug, geen resultaat. De assistent kan deze controle niet omzeilen.

    Kies een tool en zie welk pad de aanroep volgt.

    Aanroeppad: assistent, fbmcp-beleidscontrole, vier niveaus, auditlog
    NiveauToolsVoorbeeldenHoe het wordt goedgekeurd
    0 · Lezen51sessies, transacties, queryplan, gstat, firebird.log, agentrapportenNiet nodig. Alleen-lezen transactie.
    1 · Wijzigen31DML en DDL, back-up, testherstel, sweep, gebruikers en grants, een sessie beëindigenIn de chat: verzoeknummer en token, daarna fb_confirm.
    2 · Gevaarlijke bewerking14een database vervangen vanuit een back-up, firebird.conf bewerken, Firebird stoppen en herstartenAlleen op de server: het commando fbmcp ctl approve. Op Windows kun je ook een systeemvakvenster installeren.
    3 · Uitgeschakeld1een database verwijderenWordt nooit uitgevoerd.
    • VoorbeeldElke tool die goedkeuring nodig heeft, accepteert mode: preview. Het toont wat er gedaan wordt en doet niets.
    • Voorwaarden voor niveau 2Elke niveau 2-bewerking vereist een open onderhoudsvenster op die database. Een database vervangen vanuit een back-up, een exclusief venster en gevaarlijke SQL vereisen ook een geverifieerde back-up die niet ouder is dan 24 uur. Een weigering zegt wat er ontbreekt.
    • Alleen toegestane toolsDe client ziet in de lijst alleen wat hij mag gebruiken: geen niveau 3 en geen niveaus boven het maximum van zijn sleutel. Een directe aanroep van een verborgen tool wordt geweigerd.
    • Een verzoek leeft 15 minutenEen poging om het via het verkeerde kanaal goed te keuren, verbruikt het niet. fb_cancel verwijdert het verzoek.
    • Geen goedkeuringspaginaEn die komt er ook niet: een pagina die het model kan bereiken, zou de bescherming ondermijnen. Alleen een persoon op de server keurt goed: met het commando fbmcp ctl approve of in het systeemvakvenster, als dat is geïnstalleerd.

    Leesbewerkingen lopen in een alleen-lezen transactie: Firebird zelf blokkeert schrijfacties. Stel voor een tweede beschermingslaag een aparte alleen-lezen gebruiker in zonder schrijfrechten.

    Monitoring · back-ups · grants

    Voor DBA's

    De assistent doet wat een DBA handmatig doet: sessies en transacties controleren, logs lezen, een back-up maken en die verifiëren met een herstel, gebruikers beheren. Databases worden aangeduid met een id, niet met een bestandspad.

    TaakToolsNiveau
    Werkt allesfb_ping, fb_db_list, fb_db_health, fb_service_status0
    Sessies en langlopende transactiesfb_sessions, fb_transactions; om een sessie te beëindigen — fb_session_kill0 · 1
    Logs en statistiekenfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Back-up en verificatiefb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Oude back-upsfb_retention_run: eerst een proefrun; verwijdert alleen geverifieerde back-ups uit zijn eigen catalogus1
    Sweep en databasevalidatiefb_sweep, fb_validate (alleen bevindingen, geen herstel)1
    Gebruikers en grantsfb_user_create, fb_grant, fb_revoke; SYSDBA en de eigen accounts kunnen niet worden verwijderd1
    Tracesfb_trace_start alleen met sjablonen: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; om te bewerken — fb_config_set, Firebird wordt niet herstart0 · 2
    Service en databasevervangingfb_service_restart; fb_restore_replace, het oude bestand blijft bewaard als .pre-restore2

    Nachtelijke back-upcontrole

    Het schema wordt één keer goedgekeurd, bij het aanmaken. Daarna loopt het zonder tussenkomst van een persoon. Elke nacht krijg je een geverifieerde back-up. Die heb je bijvoorbeeld nodig om een database vanuit een back-up te vervangen.

    1. 1Schemafb_schedule_create, doel nightly_verify; één keer goedgekeurd
    2. 2Back-upgbak naar de back-upmap
    3. 3Testherstelnaar een werkkmap; de brondatabase wordt niet aangeraakt
    4. 4✓ Back-up geverifieerdeen markering in de back-upcatalogus

    Databasevervanging vanuit een back-up en niveau 3-bewerkingen kunnen niet worden ingepland.

    Kant-en-klare scenario's

    Scenario's stellen de volgorde van stappen voor aan de assistent. Het past zelf geen wijzigingen toe.

    Gezondheidscontrole Optimalisatie Beveiligingsaudit DDL-review Migratieplan Rampenparaatheid Querybouwer

    Query's · indexen · migraties

    Voor ontwikkelaars

    De assistent in Cursor of Claude Code kent je schema, controleert een query voordat die wordt uitgevoerd en toont het resultaat als een tabel direct in de chat.

    1. 1Taakwat je nodig hebt, in één zin
    2. 2Feitenfb_schema_list, fb_describe: alleen bestaande tabellen en kolommen
    3. 3Conceptéén SELECT met ORDER BY
    4. 4Controlefb_query_check: compileren zonder uitvoeren
    5. 5✓ Tabel in de chatfb_query: rijen, plan en statistieken

    Resultaat als tabel

    In clients die MCP Apps ondersteunen, wordt het resultaat van fb_query getoond als een sorteerbare tabel. Andere clients krijgen dezelfde gegevens als tekst.

    Standaard 100 rijen, maximaal 1000. De tabel blijft 30 minuten in het geheugen en alleen de persoon die erom heeft gevraagd, kan hem zien. Klik op een kolomkop om te sorteren.

    SELECT full_name, dept_no, salary
    FROM employee
    WHERE salary > 60000
    ORDER BY salary DESC
    6 rijen · PLAN SORT (EMPLOYEE NATURAL) · alleen-lezen
    fb_index_advice

    Indexadvies

    Vindt volledige tabelscans en stelt CREATE INDEX voor met een schatting van het voordeel. De index zelf wordt niet aangemaakt: dat doet fb_write, met goedkeuring. Nadat de index is aangemaakt, wordt het plan opnieuw gecontroleerd.

    fb_diff_schema · fb_diff_data

    Databasevergelijking

    Schema van twee databases, of van een database en zijn snapshot: wat aangemaakt, gewijzigd of verwijderd moet worden. Gegevens worden vergeleken op primaire sleutel; de tool vergelijkt geen grote tabel (standaard meer dan 100.000 rijen).

    fb_migration_*

    Migraties

    Het plan toont het niveau van elke statement. Alle migraties worden na één goedkeuring toegepast; als een bestand verandert, is een nieuwe aanvraag nodig. Het rollback-plan wordt opgebouwd uit wat is vastgelegd toen de migraties werden toegepast.

    fb_write bepaalt het niveau van elk statement in een script. Een script dat statements van verschillende niveaus mengt, wordt geweigerd.

    fbagent · Local API · 127.0.0.1

    fbagent-gegevens

    De fbagent-agent draait al op de HQbird-server. Via MCP krijgt de assistent alles wat de agent heeft verzameld: het health-rapport, LWM (Light-weight Monitoring), gstat, traces, deadlocks, back-upstatus. Hij voert ook agent-jobs uit en wijzigt hun instellingen, onder dezelfde niveaus en goedkeuringen.

    WatToolsNiveau
    Health-rapport van de serverfb_agent_status0
    LWM, gstat, databasemetrieken, traces, deadlocksfb_agent_artifact_get, fb_agent_perf_report0
    Instellingen voor back-up, sweep en restorefb_agent_backup_config; wachtwoorden en tokens zijn verborgen0
    Een agent-job uitvoerenfb_agent_job_run; back-up, restore en SQL-script zijn niveau 21 · 2
    Een jobinstelling wijzigenfb_agent_config_set; inloggegevens, id's en opdrachten kunnen niet worden gewijzigd2
    Firebird herstarten via de agentfb_agent_restart, fb_agent_stop, fb_agent_start2
    Licentie en updatesfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 1 · 2
    • Alleen lokaalDe agent accepteert verzoeken alleen op 127.0.0.1. Het agentadres komt uit de configuratie van de MCP-server, niet uit de chat.
    • Token blijft verborgenHet agenttoken verschijnt niet in de tool-uitvoer of in het auditlogboek.
    • Agentdetectiefb_agent_discover vindt agents op de server via Windows-services of systemd-units. Het leest geen tokens.
    • ClusterAls er een clusternode op de server is geïnstalleerd, weigeren fb_agent_restart, fb_agent_stop en fb_agent_start standaard: de node beheert herstarts. fb_service_restart controleert dit niet, dus gebruik het niet op een clusternode.

    Dubbele controle. De MCP-server keurt het verzoek goed, en de agent zelf voert de job uit volgens zijn eigen regels. Het MCP-logboek toont wie er heeft gevraagd; de agentlogboeken tonen hoe het is gedaan.

    HQbird Cluster · RCM

    Replicatiecluster via de assistent

    De assistent bouwt stap voor stap een replicatiecluster: hij schakelt RCM in, opent het koppelvenster, verbindt de hosts, neemt databases onder beheer en maakt een kopie voor de replica. Hij werkt via de agent en RCM. Je hoeft niet via SSH op de servers in te loggen.

    De regels zijn overal hetzelfde. Lezen vereist geen bevestiging. Een wijziging wordt in de chat bevestigd. Een Firebird-herstart, een databasekopie naar de replica, het verwijderen van een server uit het cluster, switchover, failover en de terugkeer van de oude master worden op de server bevestigd.

    WatToolsNiveau
    Clusterstatus op de serverfb_agent_cluster: vrij, in een cluster of RCM-eigenaar; slot en poorten0
    Clusteroverzicht in RCMfb_cluster_status: nodes, databases, opdrachten, meldingen0
    Hosts controleren vóór het koppelenfb_cluster_probe: een rij per agent, certificaatvingerafdruk0
    Master en replica vergelijkenfb_cluster_verify: rijenaantal van elke tabel0
    RCM inschakelen op de serverfb_agent_cluster_rcm1
    Koppelvensterfb_agent_cluster_pairing: status, 1–24 uur open, sluiten0 · 1
    Hosts koppelenfb_cluster_link; het verzoek toont vingerafdrukken om te vergelijken1
    Databases en publicatiefb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    RCM-wachtwoordfb_cluster_rcm_password: een nieuw willekeurig wachtwoord, niet getoond in de chat1
    Databasekopie naar de replicafb_cluster_reinit2
    De Firebird van een node herstartenfb_cluster_firebird_restart2
    Een server uit het cluster verwijderenfb_cluster_unlink2
    Services: waar de master isfb_cluster_service: master, replica's, routers, problemen, lopende bewerking0
    Een service en zijn regel beschrijvenfb_cluster_service_put, fb_cluster_service_policy: servicebeschrijving, regel voor automatische failover1
    Een bewerking hervatten en annulerenfb_cluster_resume, fb_cluster_operation_cancel; annuleren alleen vóór het point of no return1
    Switchoverfb_cluster_switchover: geplande verplaatsing van de master, wacht tot de bewerking is voltooid2
    Failoverfb_cluster_failover: alleen met expliciete instemming met gegevensverlies2
    De oude master terugbrengenfb_cluster_rejoin2
    Een service verwijderenfb_cluster_service_delete: alleen de registratie in RCM wordt verwijderd2
    • Kant-en-klaar scenario"Bouw een cluster": de assistent gaat stap voor stap en toont bij elke stap wat hij gaat doen.
    • VingerafdrukkenVóór het koppelen toont de assistent de certificaatvingerafdruk van elke server. Vergelijk die met de regel uit de installatiesamenvatting.
    • Dry runVoordat hij een map met databases onder beheer neemt, toont de assistent welke databases RCM zal vinden.
    • Switchover en failoverDe assistent start de verplaatsing van de master en volgt de stappen van de bewerking. Een persoon op de server bevestigt de start. Failover vereist ook expliciete instemming met gegevensverlies. Meer op de clusterpagina.

    HTTPS · API-sleutels · audit

    Externe modus, installatie en auditlogboek

    De assistent draait op de pc van de beheerder, en de MCP-server draait op de databaseserver. Daartussen zitten HTTPS en een API-sleutel. Elke persoon heeft zijn eigen sleutel en zijn eigen maximale niveau.

    Beheerders-pc met een MCP-client en fbmcp-bridge, HTTPS door een firewall naar de fbmcp-service; fbmcp communiceert met Firebird en fbagent; een persoon op de server keurt gevaarlijke verzoeken goed
    Externe modus. De bridge op de pc haalt de sleutel uit de OS-sleutelopslag en controleert het servercertificaat via pinning. Wachtwoorden en databasepaden bereiken de chat niet: databases worden aangeduid met een id.
    • Een sleutel per persoonfbmcp ctl apikey new <name> --max-tier 2. De waarde wordt één keer getoond. Na een sleutelwijziging werkt de oude sleutel binnen enkele seconden niet meer.
    • LimietenPer sleutel: gelijktijdige aanroepen, aanroepen per minuut, open sessies. Boven de limiet is het antwoord 429.
    • Handleiding in het PortugeesDe volledige handleiding voor installatie en gebruik is ook beschikbaar in Braziliaans Portugees.
    • Autonome agentsHet profiel autonomous: standaard alleen lezen. Een wijziging wacht op een operator op de server; fb_confirm van de agent wordt geweigerd. 10 aanroepen per minuut. Voer zulke agents uit binnen het bedrijfsnetwerk.
    • AdressenEen sleutel kan aan adressen worden gebonden (allow_from). Een ander adres krijgt 403 en een vermelding in het logboek.

    Installatie in HQbird

    De HQbird-installer installeert standaard de MCP-server. Eén server bedient alle Firebird-lijnen op de machine. Eén opdracht stelt alles in, en je kunt hem opnieuw uitvoeren.

    1. 1HQbird-installerWindows of Linux
    2. 2fbmcp ctl hqbird-installéén opdracht, geen handmatige YAML-aanpassingen
    3. 3Firebird-lijnenvindt elke lijn en zijn agent
    4. 4Databasesaliassen uit databases.conf en recent gekoppelde databases
    5. 5✓ Servicestart, check, connect.txt-bestand voor clients

    Externe modus wordt ingeschakeld wanneer aan drie voorwaarden is voldaan: er is een lijst met beheerdersadressen ingesteld (--allow-from), de firewall draait en er bestaat ten minste één API-sleutel. Je maakt de sleutel apart aan. Voer daarna opnieuw fbmcp ctl hqbird-install uit. De standaardpoort is 8650.

    audit.jsonl

    Hash-keten

    Elke beslissing (toegestaan, in afwachting, goedgekeurd, afgewezen) wordt naar het logboek geschreven. Elke vermelding is gekoppeld aan de vorige. Een ketencontrole toont of een vermelding is gewijzigd of verwijderd.

    Storing — stop

    Logboek afgebroken — server blijft offline

    Als het logboek is afgebroken of het einde ervan niet overeenkomt met de controlevermelding, start de MCP-server niet. Dit is een teken van manipulatie en je moet dit onderzoeken. Het commando fbmcp ctl verify controleert de hele keten.

    Update

    Via de agent

    fbagent werkt de MCP-server bij: stoppen, vervangen, starten, controleren, terugdraaien bij een storing. Op Linux wordt een niet-ondertekende build niet geïnstalleerd. Configuratie en sleutels veranderen niet.

    ← Terug naar het HQbird 2027-overzicht