Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

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á.

    Cesta volání: asistent, kontrola zásad fbmcp, čtyři úrovně, audit log
    ÚroveňNástrojePříkladyJak se schvaluje
    0 · Čtení51relace, transakce, plán dotazu, gstat, firebird.log, zprávy agentaNení potřeba. Transakce jen pro čtení.
    1 · Změna31DML a DDL, záloha, testovací obnova, sweep, uživatelé a oprávnění, ukončení relaceV chatu: číslo žádosti a token, poté fb_confirm.
    2 · Nebezpečná operace14nahrazení databáze ze zálohy, úprava firebird.conf, zastavení a restart FirebirduPouze na serveru: příkaz fbmcp ctl approve. Ve Windows lze také nainstalovat okno v oznamovací oblasti.
    3 · Zakázáno1odstranění databázeNikdy 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 approve nebo 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.

    ÚkolNástrojeÚroveň
    Funguje všefb_ping, fb_db_list, fb_db_health, fb_service_status0
    Relace a dlouhé transakcefb_sessions, fb_transactions; ukončení relace — fb_session_kill0 · 1
    Logy a statistikyfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Záloha a ověřenífb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Staré zálohyfb_retention_run: nejprve zkušební běh; maže pouze ověřené zálohy z vlastního katalogu1
    Sweep a validace databázefb_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 smazat1
    Tracefb_trace_start pouze se šablonami: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; úprava — fb_config_set, Firebird se nerestartuje0 · 2
    Služba a nahrazení databázefb_service_restart; fb_restore_replace, původní soubor zůstane jako .pre-restore2

    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.

    1. 1Plánfb_schedule_create, cíl nightly_verify; schváleno jednou
    2. 2Zálohagbak do složky záloh
    3. 3Testovací obnovado pracovní složky; zdrojová databáze zůstane nedotčena
    4. 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í.

    Kontrola stavu Optimalizace Bezpečnostní audit Kontrola DDL Plán migrace Připravenost na havárii Tvorba dotazů

    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. 1Úkolco potřebujete, jednou větou
    2. 2Faktafb_schema_list, fb_describe: pouze existující tabulky a sloupce
    3. 3Návrhjeden SELECT s ORDER BY
    4. 4Kontrolafb_query_check: kompilace bez spuštění
    5. 5✓ Tabulka v chatufb_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
    6 řádků · PLAN SORT (EMPLOYEE NATURAL) · jen pro čtení
    fb_index_advice

    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.

    fb_diff_schema · fb_diff_data

    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ů).

    fb_migration_*

    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í.

    CoNástrojeÚroveň
    Zpráva o stavu serverufb_agent_status0
    LWM, gstat, metriky databáze, trace, deadlockyfb_agent_artifact_get, fb_agent_perf_report0
    Nastavení zálohování, sweep a obnovyfb_agent_backup_config; hesla a tokeny jsou skryté0
    Spuštění úlohy agentafb_agent_job_run; zálohování, obnova a SQL skript jsou úroveň 21 · 2
    Změna nastavení úlohyfb_agent_config_set; přihlašovací údaje, id a příkazy nelze měnit2
    Restart Firebird prostřednictvím agentafb_agent_restart, fb_agent_stop, fb_agent_start2
    Licence a aktualizacefb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 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í agentafb_agent_discover vyhledá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_stop a fb_agent_start ve výchozím nastavení odmítnou: restart řídí uzel. fb_service_restart to 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.

    CoNástrojeÚroveň
    Stav clusteru na serverufb_agent_cluster: volný, v clusteru nebo vlastník RCM; slot a porty0
    Přehled clusteru v RCMfb_cluster_status: uzly, databáze, příkazy, upozornění0
    Kontrola hostitelů před propojenímfb_cluster_probe: jeden řádek na agenta, otisk certifikátu0
    Porovnání masteru a replikyfb_cluster_verify: počet řádků každé tabulky0
    Zapnutí RCM na serverufb_agent_cluster_rcm1
    Okno párovánífb_agent_cluster_pairing: stav, otevřeno na 1–24 hodin, zavřít0 · 1
    Propojení hostitelůfb_cluster_link; požadavek zobrazuje otisky k porovnání1
    Databáze a publikacefb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    Heslo RCMfb_cluster_rcm_password: nové náhodné heslo, nezobrazuje se v chatu1
    Kopie databáze na replikufb_cluster_reinit2
    Restart Firebird uzlufb_cluster_firebird_restart2
    Odebrání serveru z clusterufb_cluster_unlink2
    Služby: kde je masterfb_cluster_service: master, repliky, routery, problémy, probíhající operace0
    Popis služby a jejího pravidlafb_cluster_service_put, fb_cluster_service_policy: popis služby, pravidlo automatického failoveru1
    Obnovení a zrušení operacefb_cluster_resume, fb_cluster_operation_cancel; zrušit lze pouze před bodem bez návratu1
    Switchoverfb_cluster_switchover: plánované přesunutí masteru, čeká na dokončení operace2
    Failoverfb_cluster_failover: pouze s výslovným souhlasem se ztrátou dat2
    Návrat starého masterufb_cluster_rejoin2
    Smazání službyfb_cluster_service_delete: smaže se pouze záznam v RCM2
    • 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ň.

    PC administrátora s klientem MCP a mostem fbmcp, HTTPS přes firewall ke službě fbmcp; fbmcp komunikuje s Firebird a fbagent; osoba na serveru schvaluje nebezpečné požadavky
    Vzdálený režim. Most na PC načte klíč z úložiště klíčů OS a ověří certifikát serveru pomocí pin. Hesla a cesty k databázím se do chatu nedostanou: databáze se označují id.
    • Klíč pro každou osobufbmcp 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_confirm od 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.

    1. 1Instalátor HQbirdWindows nebo Linux
    2. 2fbmcp ctl hqbird-installjeden příkaz, žádné ruční úpravy YAML
    3. 3Řady Firebirdnajde každou řadu a jejího agenta
    4. 4Databázealiasy databases.conf a nedávno připojené databáze
    5. 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.

    audit.jsonl

    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.

    Selhání — stop

    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.

    Aktualizace

    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í.

    ← Zpět na přehled HQbird 2027