HQbird MCP AI asistent
AI asistent pod lidskou kontrolou
HQbird MCP propojuje Firebird s AI asistentem. Píšete běžnými slovy a asistent si sám vybírá nástroje. Čte volně. Každá změna čeká na vaše „ano“ a ta nebezpečná čeká na schválení přímo na serveru.
- 122 nástrojů
- 56 jen pro čtení
- Firebird 2.5–5 Windows a Linux
- 2 kanály pro schválení
- audit log s hashovým řetězcem
Příklad
Konverzace s asistentem
Uživatelé si stěžují, že je databáze pomalá. Asistent přečte data, najde příčinu, navrhne akci a čeká na vaše rozhodnutí. Jména a čísla v příkladu jsou smyšlená.
Funguje jakýkoli MCP klient: Claude Desktop, Claude Code, Cursor, Codex, ZCode a další.
Zásady · schvalování
Čtyři úrovně nebezpečnosti
Každý nástroj má svou úroveň. Server MCP sám zkontroluje úroveň a podmínky ještě před spuštěním volání. Volání, které něco mění, vrací žádost o schválení, nikoli výsledek. Asistent toto ověření nemůže obejít.
Vyberte nástroj a podívejte se, jakou cestou se jeho volání vydá.
| Úroveň | Nástroje | Příklady | Jak se schvaluje |
|---|---|---|---|
| 0 · Čtení | 51 | relace, transakce, plán dotazu, gstat, firebird.log, zprávy agenta | Není potřeba. Transakce jen pro čtení. |
| 1 · Změna | 31 | DML a DDL, záloha, testovací obnova, sweep, uživatelé a oprávnění, ukončení relace | V chatu: číslo žádosti a token, poté fb_confirm. |
| 2 · Nebezpečná operace | 14 | nahrazení databáze ze zálohy, úprava firebird.conf, zastavení a restart Firebirdu | Pouze na serveru: příkaz fbmcp ctl approve. Ve Windows lze také nainstalovat okno v oznamovací oblasti. |
| 3 · Zakázáno | 1 | odstranění databáze | Nikdy se nespustí. |
- NáhledKaždý nástroj, který vyžaduje schválení, přijímá
mode: preview. Ukáže, co se provede, a nic neudělá. - Podmínky pro úroveň 2Každá operace úrovně 2 vyžaduje otevřené okno údržby pro danou databázi. Nahrazení databáze ze zálohy, exkluzivní okno a nebezpečný SQL navíc vyžadují ověřenou zálohu ne starší než 24 hodin. Odmítnutí uvede, co chybí.
- Pouze povolené nástrojeKlient v seznamu vidí jen to, co smí použít: žádnou úroveň 3 ani úrovně nad maximem svého klíče. Přímé volání skrytého nástroje je odmítnuto.
- Žádost platí 15 minutPokus o schválení přes nesprávný kanál ji nespotřebuje.
fb_cancelžádost smaže. - Žádná schvalovací stránkaA ani nebude: stránka, ke které by se model dostal, by ochranu narušila. Schvaluje pouze člověk na serveru: příkazem
fbmcp ctl approvenebo v okně v oznamovací oblasti, pokud je nainstalováno.
Čtení probíhá v transakci jen pro čtení: zápisy blokuje sám Firebird. Pro druhou vrstvu ochrany nastavte samostatného uživatele jen pro čtení bez práv zápisu.
Monitoring · zálohy · oprávnění
Pro DBA
Asistent dělá to, co DBA dělá ručně: kontroluje relace a transakce, čte logy, vytváří zálohu a ověřuje ji obnovou, spravuje uživatele. Databáze označuje podle id, nikoli podle cesty k souboru.
| Úkol | Nástroje | Úroveň |
|---|---|---|
| Funguje vše | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Relace a dlouhé transakce | fb_sessions, fb_transactions; ukončení relace — fb_session_kill | 0 · 1 |
| Logy a statistiky | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Záloha a ověření | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Staré zálohy | fb_retention_run: nejprve zkušební běh; maže pouze ověřené zálohy z vlastního katalogu | 1 |
| Sweep a validace databáze | fb_sweep, fb_validate (pouze nálezy, žádná oprava) | 1 |
| Uživatelé a oprávnění | fb_user_create, fb_grant, fb_revoke; SYSDBA a jeho vlastní účty nelze smazat | 1 |
| Trace | fb_trace_start pouze se šablonami: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; úprava — fb_config_set, Firebird se nerestartuje | 0 · 2 |
| Služba a nahrazení databáze | fb_service_restart; fb_restore_replace, původní soubor zůstane jako .pre-restore | 2 |
Noční kontrola zálohy
Plán se schvaluje jednou, při vytvoření. Poté běží bez člověka. Každou noc získáte ověřenou zálohu. Tu potřebujete například k nahrazení databáze ze zálohy.
- 1Plán
fb_schedule_create, cílnightly_verify; schváleno jednou - 2Zálohagbak do složky záloh
- 3Testovací obnovado pracovní složky; zdrojová databáze zůstane nedotčena
- 4✓ Záloha ověřenaznačka v katalogu záloh
Nahrazení databáze ze zálohy a operace úrovně 3 nelze naplánovat.
Hotové scénáře
Scénáře asistentovi navrhují pořadí kroků. Sám žádné změny neprovádí.
Dotazy · indexy · migrace
Pro vývojáře
Asistent v Cursoru nebo Claude Code zná vaše schéma, zkontroluje dotaz před spuštěním a zobrazí výsledek jako tabulku přímo v chatu.
- 1Úkolco potřebujete, jednou větou
- 2Fakta
fb_schema_list,fb_describe: pouze existující tabulky a sloupce - 3Návrhjeden SELECT s ORDER BY
- 4Kontrola
fb_query_check: kompilace bez spuštění - 5✓ Tabulka v chatu
fb_query: řádky, plán a statistiky
Výsledek jako tabulka
V klientech, které podporují MCP Apps, se výsledek fb_query zobrazí jako tabulka s možností řazení. Ostatní klienti dostanou stejná data jako text.
Ve výchozím nastavení 100 řádků, nejvýše 1000. Tabulka zůstává v paměti 30 minut a vidí ji pouze ten, kdo o ni požádal. Řazení spustíte kliknutím na záhlaví sloupce.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Doporučení indexů
Vyhledává úplné procházení tabulek a navrhuje CREATE INDEX s odhadem přínosu. Index sám nevytváří: to dělá fb_write, a to po schválení. Po vytvoření indexu znovu zkontroluje plán.
Porovnání databází
Schéma dvou databází, nebo databáze a jejího snímku: co vytvořit, změnit, zrušit. Data se porovnávají podle primárního klíče; nástroj neporovnává velkou tabulku (ve výchozím nastavení více než 100 000 řádků).
Migrace
Plán ukazuje úroveň každého příkazu. Všechny migrace se aplikují po jednom schválení; pokud se soubor změní, je potřeba nový požadavek. Plán rollbacku se sestavuje z toho, co bylo zaznamenáno při aplikaci migrací.
fb_write zjišťuje úroveň každého příkazu ve skriptu. Skript, který míchá příkazy různých úrovní, je odmítnut.
fbagent · Local API · 127.0.0.1
Data fbagent
Agent fbagent již běží na serveru HQbird. Prostřednictvím MCP asistent získá vše, co agent shromáždil: zprávu o stavu, LWM (Light-weight Monitoring), gstat, trace, deadlocky, stav záloh. Také spouští úlohy agenta a mění jejich nastavení, a to podle stejných úrovní a schválení.
| Co | Nástroje | Úroveň |
|---|---|---|
| Zpráva o stavu serveru | fb_agent_status | 0 |
| LWM, gstat, metriky databáze, trace, deadlocky | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Nastavení zálohování, sweep a obnovy | fb_agent_backup_config; hesla a tokeny jsou skryté | 0 |
| Spuštění úlohy agenta | fb_agent_job_run; zálohování, obnova a SQL skript jsou úroveň 2 | 1 · 2 |
| Změna nastavení úlohy | fb_agent_config_set; přihlašovací údaje, id a příkazy nelze měnit | 2 |
| Restart Firebird prostřednictvím agenta | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Licence a aktualizace | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Pouze lokálněAgent přijímá požadavky pouze na 127.0.0.1. Adresa agenta pochází z konfigurace serveru MCP, nikoli z chatu.
- Token zůstává skrytýToken agenta se neobjevuje ve výstupu nástrojů ani v auditním protokolu.
- Vyhledání agenta
fb_agent_discovervyhledává agenty na serveru podle služeb Windows nebo jednotek systemd. Nečte tokeny. - ClusterPokud je na serveru nainstalován uzel clusteru,
fb_agent_restart,fb_agent_stopafb_agent_startve výchozím nastavení odmítnou: restart řídí uzel.fb_service_restartto nekontroluje, proto jej na uzlu clusteru nepoužívejte.
Dvojitá kontrola. Server MCP schválí požadavek a agent sám spustí úlohu podle svých vlastních pravidel. Protokol MCP ukazuje, kdo o to požádal; protokoly agenta ukazují, jak se to provedlo.
HQbird Cluster · RCM
Replikační cluster prostřednictvím asistenta
Asistent sestaví replikační cluster krok za krokem: zapne RCM, otevře okno párování, propojí hostitele, převezme databáze pod správu a vytvoří kopii pro repliku. Pracuje prostřednictvím agenta a RCM. Nemusíte se přihlašovat k serverům přes SSH.
Pravidla jsou stejná jako všude. Čtení nevyžaduje potvrzení. Změna se potvrzuje v chatu. Restart Firebird, kopie databáze na repliku, odebrání serveru z clusteru, switchover, failover a návrat starého masteru se potvrzují na serveru.
| Co | Nástroje | Úroveň |
|---|---|---|
| Stav clusteru na serveru | fb_agent_cluster: volný, v clusteru nebo vlastník RCM; slot a porty | 0 |
| Přehled clusteru v RCM | fb_cluster_status: uzly, databáze, příkazy, upozornění | 0 |
| Kontrola hostitelů před propojením | fb_cluster_probe: jeden řádek na agenta, otisk certifikátu | 0 |
| Porovnání masteru a repliky | fb_cluster_verify: počet řádků každé tabulky | 0 |
| Zapnutí RCM na serveru | fb_agent_cluster_rcm | 1 |
| Okno párování | fb_agent_cluster_pairing: stav, otevřeno na 1–24 hodin, zavřít | 0 · 1 |
| Propojení hostitelů | fb_cluster_link; požadavek zobrazuje otisky k porovnání | 1 |
| Databáze a publikace | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| Heslo RCM | fb_cluster_rcm_password: nové náhodné heslo, nezobrazuje se v chatu | 1 |
| Kopie databáze na repliku | fb_cluster_reinit | 2 |
| Restart Firebird uzlu | fb_cluster_firebird_restart | 2 |
| Odebrání serveru z clusteru | fb_cluster_unlink | 2 |
| Služby: kde je master | fb_cluster_service: master, repliky, routery, problémy, probíhající operace | 0 |
| Popis služby a jejího pravidla | fb_cluster_service_put, fb_cluster_service_policy: popis služby, pravidlo automatického failoveru | 1 |
| Obnovení a zrušení operace | fb_cluster_resume, fb_cluster_operation_cancel; zrušit lze pouze před bodem bez návratu | 1 |
| Switchover | fb_cluster_switchover: plánované přesunutí masteru, čeká na dokončení operace | 2 |
| Failover | fb_cluster_failover: pouze s výslovným souhlasem se ztrátou dat | 2 |
| Návrat starého masteru | fb_cluster_rejoin | 2 |
| Smazání služby | fb_cluster_service_delete: smaže se pouze záznam v RCM | 2 |
- Hotový scénář„Sestavit cluster“: asistent postupuje krok za krokem a u každého kroku ukáže, co bude dělat.
- OtiskyPřed propojením asistent zobrazí otisk certifikátu každého serveru. Porovnejte jej s řádkem ze souhrnu instalace.
- Zkušební běhNež převezme složku s databázemi pod správu, asistent ukáže, které databáze RCM najde.
- Switchover a failoverAsistent zahájí přesun masteru a sleduje kroky operace. Spuštění potvrzuje osoba na serveru. Failover navíc vyžaduje výslovný souhlas se ztrátou dat. Více na stránce clusteru.
HTTPS · API klíče · audit
Vzdálený režim, instalace a auditní protokol
Asistent běží na PC administrátora a server MCP běží na databázovém serveru. Mezi nimi je HTTPS a API klíč. Každá osoba má svůj vlastní klíč a svou vlastní maximální úroveň.
- Klíč pro každou osobu
fbmcp ctl apikey new <name> --max-tier 2. Hodnota se zobrazí jednou. Po změně klíče přestane starý klíč během několika sekund fungovat. - LimityNa klíč: souběžná volání, volání za minutu, otevřené relace. Nad limitem je odpověď 429.
- Průvodce v portugalštiněÚplný průvodce instalací a používáním je k dispozici také v brazilské portugalštině.
- Autonomní agentiProfil
autonomous: ve výchozím nastavení pouze čtení. Změna čeká na operátora na serveru;fb_confirmod agenta je odmítnut. 10 volání za minutu. Takové agenty spouštějte v podnikové síti. - AdresyKlíč lze svázat s adresami (
allow_from). Jiná adresa obdrží 403 a záznam v protokolu.
Instalace v HQbird
Instalátor HQbird instaluje server MCP ve výchozím nastavení. Jeden server obsluhuje všechny řady Firebird na stroji. Vše nastaví jediný příkaz a můžete jej spustit znovu.
- 1Instalátor HQbirdWindows nebo Linux
- 2fbmcp ctl hqbird-installjeden příkaz, žádné ruční úpravy YAML
- 3Řady Firebirdnajde každou řadu a jejího agenta
- 4Databázealiasy databases.conf a nedávno připojené databáze
- 5✓ Službasoubor start, check, connect.txt pro klienty
Vzdálený režim se zapne, když jsou splněny tři podmínky: je nastaven seznam adres administrátorů (--allow-from), běží firewall a existuje alespoň jeden API klíč. Klíč vytvoříte samostatně. Poté znovu spusťte fbmcp ctl hqbird-install. Výchozí port je 8650.
Hashový řetězec
Každé rozhodnutí (povoleno, čeká, schváleno, zamítnuto) se zapisuje do logu. Každý záznam je propojen s předchozím. Kontrola řetězce ukáže, zda byl záznam změněn nebo smazán.
Log zkrácen — server zůstává vypnutý
Pokud je log zkrácen nebo jeho konec neodpovídá kontrolnímu záznamu, MCP server se nespustí. Je to známka manipulace a musíte to prošetřit. Příkaz fbmcp ctl verify zkontroluje celý řetězec.
Prostřednictvím agenta
fbagent aktualizuje MCP server: zastaví, nahradí, spustí, zkontroluje, při selhání vrátí zpět. Na Linuxu se nepodepsaný build neinstaluje. Konfigurace a klíče se nemění.