HQbird MCP AI-assistent
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.
| Niveau | Tools | Voorbeelden | Hoe het wordt goedgekeurd |
|---|---|---|---|
| 0 · Lezen | 51 | sessies, transacties, queryplan, gstat, firebird.log, agentrapporten | Niet nodig. Alleen-lezen transactie. |
| 1 · Wijzigen | 31 | DML en DDL, back-up, testherstel, sweep, gebruikers en grants, een sessie beëindigen | In de chat: verzoeknummer en token, daarna fb_confirm. |
| 2 · Gevaarlijke bewerking | 14 | een database vervangen vanuit een back-up, firebird.conf bewerken, Firebird stoppen en herstarten | Alleen op de server: het commando fbmcp ctl approve. Op Windows kun je ook een systeemvakvenster installeren. |
| 3 · Uitgeschakeld | 1 | een database verwijderen | Wordt 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_cancelverwijdert 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 approveof 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.
| Taak | Tools | Niveau |
|---|---|---|
| Werkt alles | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Sessies en langlopende transacties | fb_sessions, fb_transactions; om een sessie te beëindigen — fb_session_kill | 0 · 1 |
| Logs en statistieken | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Back-up en verificatie | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Oude back-ups | fb_retention_run: eerst een proefrun; verwijdert alleen geverifieerde back-ups uit zijn eigen catalogus | 1 |
| Sweep en databasevalidatie | fb_sweep, fb_validate (alleen bevindingen, geen herstel) | 1 |
| Gebruikers en grants | fb_user_create, fb_grant, fb_revoke; SYSDBA en de eigen accounts kunnen niet worden verwijderd | 1 |
| Traces | fb_trace_start alleen met sjablonen: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; om te bewerken — fb_config_set, Firebird wordt niet herstart | 0 · 2 |
| Service en databasevervanging | fb_service_restart; fb_restore_replace, het oude bestand blijft bewaard als .pre-restore | 2 |
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.
- 1Schema
fb_schedule_create, doelnightly_verify; één keer goedgekeurd - 2Back-upgbak naar de back-upmap
- 3Testherstelnaar een werkkmap; de brondatabase wordt niet aangeraakt
- 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.
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.
- 1Taakwat je nodig hebt, in één zin
- 2Feiten
fb_schema_list,fb_describe: alleen bestaande tabellen en kolommen - 3Conceptéén SELECT met ORDER BY
- 4Controle
fb_query_check: compileren zonder uitvoeren - 5✓ Tabel in de chat
fb_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
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.
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).
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.
| Wat | Tools | Niveau |
|---|---|---|
| Health-rapport van de server | fb_agent_status | 0 |
| LWM, gstat, databasemetrieken, traces, deadlocks | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Instellingen voor back-up, sweep en restore | fb_agent_backup_config; wachtwoorden en tokens zijn verborgen | 0 |
| Een agent-job uitvoeren | fb_agent_job_run; back-up, restore en SQL-script zijn niveau 2 | 1 · 2 |
| Een jobinstelling wijzigen | fb_agent_config_set; inloggegevens, id's en opdrachten kunnen niet worden gewijzigd | 2 |
| Firebird herstarten via de agent | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Licentie en updates | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 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.
- Agentdetectie
fb_agent_discovervindt 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_stopenfb_agent_startstandaard: de node beheert herstarts.fb_service_restartcontroleert 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.
| Wat | Tools | Niveau |
|---|---|---|
| Clusterstatus op de server | fb_agent_cluster: vrij, in een cluster of RCM-eigenaar; slot en poorten | 0 |
| Clusteroverzicht in RCM | fb_cluster_status: nodes, databases, opdrachten, meldingen | 0 |
| Hosts controleren vóór het koppelen | fb_cluster_probe: een rij per agent, certificaatvingerafdruk | 0 |
| Master en replica vergelijken | fb_cluster_verify: rijenaantal van elke tabel | 0 |
| RCM inschakelen op de server | fb_agent_cluster_rcm | 1 |
| Koppelvenster | fb_agent_cluster_pairing: status, 1–24 uur open, sluiten | 0 · 1 |
| Hosts koppelen | fb_cluster_link; het verzoek toont vingerafdrukken om te vergelijken | 1 |
| Databases en publicatie | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| RCM-wachtwoord | fb_cluster_rcm_password: een nieuw willekeurig wachtwoord, niet getoond in de chat | 1 |
| Databasekopie naar de replica | fb_cluster_reinit | 2 |
| De Firebird van een node herstarten | fb_cluster_firebird_restart | 2 |
| Een server uit het cluster verwijderen | fb_cluster_unlink | 2 |
| Services: waar de master is | fb_cluster_service: master, replica's, routers, problemen, lopende bewerking | 0 |
| Een service en zijn regel beschrijven | fb_cluster_service_put, fb_cluster_service_policy: servicebeschrijving, regel voor automatische failover | 1 |
| Een bewerking hervatten en annuleren | fb_cluster_resume, fb_cluster_operation_cancel; annuleren alleen vóór het point of no return | 1 |
| Switchover | fb_cluster_switchover: geplande verplaatsing van de master, wacht tot de bewerking is voltooid | 2 |
| Failover | fb_cluster_failover: alleen met expliciete instemming met gegevensverlies | 2 |
| De oude master terugbrengen | fb_cluster_rejoin | 2 |
| Een service verwijderen | fb_cluster_service_delete: alleen de registratie in RCM wordt verwijderd | 2 |
- 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.
- Een sleutel per persoon
fbmcp 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_confirmvan 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.
- 1HQbird-installerWindows of Linux
- 2fbmcp ctl hqbird-installéén opdracht, geen handmatige YAML-aanpassingen
- 3Firebird-lijnenvindt elke lijn en zijn agent
- 4Databasesaliassen uit databases.conf en recent gekoppelde databases
- 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.
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.
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.
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.