Asystent AI HQbird MCP
Asystent AI pod kontrolą człowieka
HQbird MCP łączy Firebird z asystentem AI. Piszesz zwykłymi słowami, a asystent sam wybiera narzędzia. Czyta swobodnie. Każda zmiana czeka na Twoje „tak”, a niebezpieczna czeka na zatwierdzenie na samym serwerze.
- 122 narzędzia
- 56 tylko do odczytu
- Firebird 2.5–5 Windows i Linux
- 2 kanały zatwierdzania
- dziennik audytu z łańcuchem skrótów
Przykład
Rozmowa z asystentem
Użytkownicy skarżą się, że baza danych działa wolno. Asystent czyta dane, znajduje przyczynę, proponuje działanie i czeka na Twoją decyzję. Nazwy i liczby w przykładzie są wymyślone.
Działa dowolny klient MCP: Claude Desktop, Claude Code, Cursor, Codex, ZCode i inne.
Polityka · zatwierdzanie
Cztery poziomy zagrożenia
Każde narzędzie ma poziom. Serwer MCP sam sprawdza poziom i warunki przed wykonaniem wywołania. Wywołanie, które coś zmienia, zwraca prośbę o zatwierdzenie, a nie wynik. Asystent nie może obejść tego sprawdzenia.
Wybierz narzędzie i zobacz, jaką ścieżkę przechodzi jego wywołanie.
| Poziom | Narzędzia | Przykłady | Jak jest zatwierdzany |
|---|---|---|---|
| 0 · Odczyt | 51 | sesje, transakcje, plan zapytania, gstat, firebird.log, raporty agenta | Nie jest potrzebne. Transakcja tylko do odczytu. |
| 1 · Zmiana | 31 | DML i DDL, kopia zapasowa, testowy odtworzenie, sweep, użytkownicy i uprawnienia, zakończenie sesji | W czacie: numer żądania i token, następnie fb_confirm. |
| 2 · Niebezpieczna operacja | 14 | zastąpienie bazy danych z kopii zapasowej, edycja firebird.conf, zatrzymanie i ponowne uruchomienie Firebird | Tylko na serwerze: polecenie fbmcp ctl approve. W systemie Windows można też zainstalować okno w zasobniku. |
| 3 · Wyłączone | 1 | usunięcie bazy danych | Nigdy nie jest wykonywane. |
- PodglądKażde narzędzie wymagające zatwierdzenia przyjmuje
mode: preview. Pokazuje, co zostanie zrobione, i nic nie robi. - Warunki dla poziomu 2Każda operacja poziomu 2 wymaga otwartego okna konserwacyjnego dla tej bazy danych. Zastąpienie bazy danych z kopii zapasowej, okno wyłączne i niebezpieczny SQL wymagają też zweryfikowanej kopii zapasowej nie starszej niż 24 godziny. Odmowa mówi, czego brakuje.
- Tylko dozwolone narzędziaKlient widzi na liście tylko to, czego może używać: bez poziomu 3 i bez poziomów powyżej maksimum swojego klucza. Bezpośrednie wywołanie ukrytego narzędzia jest odrzucane.
- Żądanie żyje 15 minutPróba zatwierdzenia go przez niewłaściwy kanał nie zużywa go.
fb_cancelusuwa żądanie. - Brak strony zatwierdzaniaI nie będzie jej: strona, do której model mógłby dotrzeć, złamałaby zabezpieczenie. Zatwierdza tylko osoba na serwerze: poleceniem
fbmcp ctl approvelub w oknie w zasobniku, jeśli jest zainstalowane.
Odczyty działają w transakcji tylko do odczytu: sam Firebird blokuje zapisy. Dla drugiej warstwy ochrony ustaw osobnego użytkownika tylko do odczytu bez praw zapisu.
Monitoring · kopie zapasowe · uprawnienia
Dla DBA
Asystent robi to, co DBA robi ręcznie: sprawdza sesje i transakcje, czyta logi, tworzy kopię zapasową i weryfikuje ją odtworzeniem, zarządza użytkownikami. Bazy danych nazywa po identyfikatorze, a nie po ścieżce pliku.
| Zadanie | Narzędzia | Poziom |
|---|---|---|
| Czy wszystko działa | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Sesje i długie transakcje | fb_sessions, fb_transactions; zakończenie sesji — fb_session_kill | 0 · 1 |
| Logi i statystyki | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Kopia zapasowa i weryfikacja | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Stare kopie zapasowe | fb_retention_run: najpierw próba na sucho; usuwa tylko zweryfikowane kopie zapasowe z własnego katalogu | 1 |
| Sweep i walidacja bazy danych | fb_sweep, fb_validate (tylko ustalenia, bez naprawy) | 1 |
| Użytkownicy i uprawnienia | fb_user_create, fb_grant, fb_revoke; SYSDBA i własnych kont nie można usunąć | 1 |
| Śledzenie | fb_trace_start tylko z szablonami: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; edycja — fb_config_set, Firebird nie jest restartowany | 0 · 2 |
| Usługa i zastąpienie bazy danych | fb_service_restart; fb_restore_replace, stary plik pozostaje jako .pre-restore | 2 |
Nocne sprawdzanie kopii zapasowej
Harmonogram jest zatwierdzany raz, przy tworzeniu. Potem działa bez osoby. Każdej nocy otrzymujesz zweryfikowaną kopię zapasową. Jest potrzebna na przykład do zastąpienia bazy danych z kopii zapasowej.
- 1Harmonogram
fb_schedule_create, celnightly_verify; zatwierdzany raz - 2Kopia zapasowagbak do folderu kopii zapasowych
- 3Testowe odtworzeniedo folderu roboczego; źródłowa baza danych nie jest naruszana
- 4✓ Kopia zapasowa zweryfikowanaznacznik w katalogu kopii zapasowych
Zastąpienia bazy danych z kopii zapasowej i operacji poziomu 3 nie można zaplanować.
Gotowe scenariusze
Scenariusze podpowiadają asystentowi kolejność kroków. Nie stosuje zmian samodzielnie.
Zapytania · indeksy · migracje
Dla programistów
Asystent w Cursor lub Claude Code zna Twój schemat, sprawdza zapytanie przed uruchomieniem i pokazuje wynik jako tabelę bezpośrednio w czacie.
- 1Zadanieczego potrzebujesz, w jednym zdaniu
- 2Fakty
fb_schema_list,fb_describe: tylko istniejące tabele i kolumny - 3Szkicjeden SELECT z ORDER BY
- 4Sprawdzenie
fb_query_check: kompilacja bez uruchamiania - 5✓ Tabela w czacie
fb_query: wiersze, plan i statystyki
Wynik jako tabela
W klientach obsługujących MCP Apps wynik fb_query jest pokazywany jako sortowalna tabela. Inne klienty otrzymują te same dane jako tekst.
Domyślnie 100 wierszy, maksymalnie 1000. Tabela pozostaje w pamięci przez 30 minut i widzi ją tylko osoba, która o nią poprosiła. Kliknij nagłówek kolumny, aby sortować.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Doradztwo indeksowe
Wykrywa pełne skanowania tabel i sugeruje CREATE INDEX wraz z szacowaną korzyścią. Sam nie tworzy indeksu: robi to fb_write, po zatwierdzeniu. Po utworzeniu indeksu ponownie sprawdza plan.
Porównanie baz danych
Schemat dwóch baz danych lub bazy danych i jej migawki: co utworzyć, zmienić, usunąć. Dane są porównywane według klucza głównego; narzędzie nie porównuje dużej tabeli (domyślnie powyżej 100 000 wierszy).
Migracje
Plan pokazuje poziom każdej instrukcji. Wszystkie migracje są stosowane po jednym zatwierdzeniu; jeśli plik się zmieni, wymagane jest nowe żądanie. Plan wycofania jest budowany na podstawie tego, co zostało zapisane podczas stosowania migracji.
fb_write znajduje poziom każdej instrukcji w skrypcie. Skrypt mieszający instrukcje różnych poziomów jest odrzucany.
fbagent · Local API · 127.0.0.1
Dane fbagent
Agent fbagent działa już na serwerze HQbird. Poprzez MCP asystent otrzymuje wszystko, co zebrał agent: raport kondycji, LWM (Light-weight Monitoring), gstat, ślady, zakleszczenia, stan kopii zapasowych. Uruchamia także zadania agenta i zmienia ich ustawienia, w ramach tych samych poziomów i zatwierdzeń.
| Co | Narzędzia | Poziom |
|---|---|---|
| Raport kondycji serwera | fb_agent_status | 0 |
| LWM, gstat, metryki bazy danych, ślady, zakleszczenia | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Ustawienia kopii zapasowej, sweep i przywracania | fb_agent_backup_config; hasła i tokeny są ukryte | 0 |
| Uruchom zadanie agenta | fb_agent_job_run; kopia zapasowa, przywracanie i skrypt SQL to poziom 2 | 1 · 2 |
| Zmień ustawienie zadania | fb_agent_config_set; poświadczenia, identyfikatory i polecenia nie mogą być zmieniane | 2 |
| Restart Firebird przez agenta | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Licencja i aktualizacje | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Tylko lokalnieAgent przyjmuje żądania wyłącznie na 127.0.0.1. Adres agenta pochodzi z konfiguracji serwera MCP, a nie z czatu.
- Token pozostaje ukrytyToken agenta nie pojawia się w danych wyjściowych narzędzi ani w dzienniku audytu.
- Wykrywanie agenta
fb_agent_discoverznajduje agentów na serwerze poprzez usługi Windows lub jednostki systemd. Nie odczytuje tokenów. - KlasterJeśli na serwerze jest zainstalowany węzeł klastra,
fb_agent_restart,fb_agent_stopifb_agent_startdomyślnie odmawiają: restartami steruje węzeł.fb_service_restarttego nie sprawdza, więc nie używaj go na węźle klastra.
Podwójna kontrola. Serwer MCP zatwierdza żądanie, a sam agent wykonuje zadanie według własnych reguł. Dziennik MCP pokazuje, kto poprosił; dzienniki agenta pokazują, jak to zostało wykonane.
HQbird Cluster · RCM
Klaster replikacji przez asystenta
Asystent buduje klaster replikacji krok po kroku: włącza RCM, otwiera okno parowania, łączy hosty, przejmuje bazy danych pod zarządzanie i tworzy kopię dla repliki. Działa poprzez agenta i RCM. Nie musisz logować się do serwerów przez SSH.
Zasady są takie same jak wszędzie. Odczyty nie wymagają potwierdzenia. Zmiana jest potwierdzana w czacie. Restart Firebird, kopiowanie bazy danych do repliki, usunięcie serwera z klastra, switchover, failover i powrót starego mastera są potwierdzane na serwerze.
| Co | Narzędzia | Poziom |
|---|---|---|
| Stan klastra na serwerze | fb_agent_cluster: wolny, w klastrze lub właściciel RCM; slot i porty | 0 |
| Przegląd klastra w RCM | fb_cluster_status: węzły, bazy danych, polecenia, alerty | 0 |
| Sprawdź hosty przed połączeniem | fb_cluster_probe: wiersz na agenta, odcisk certyfikatu | 0 |
| Porównaj mastera i replikę | fb_cluster_verify: liczba wierszy każdej tabeli | 0 |
| Włącz RCM na serwerze | fb_agent_cluster_rcm | 1 |
| Okno parowania | fb_agent_cluster_pairing: stan, otwarte na 1–24 godziny, zamknij | 0 · 1 |
| Połącz hosty | fb_cluster_link; żądanie pokazuje odciski do porównania | 1 |
| Bazy danych i publikacja | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| Hasło RCM | fb_cluster_rcm_password: nowe losowe hasło, niewyświetlane w czacie | 1 |
| Kopia bazy danych do repliki | fb_cluster_reinit | 2 |
| Restart Firebird węzła | fb_cluster_firebird_restart | 2 |
| Usuń serwer z klastra | fb_cluster_unlink | 2 |
| Usługi: gdzie jest master | fb_cluster_service: master, repliki, routery, problemy, uruchomiona operacja | 0 |
| Opisz usługę i jej regułę | fb_cluster_service_put, fb_cluster_service_policy: opis usługi, reguła automatycznego failover | 1 |
| Wznów i anuluj operację | fb_cluster_resume, fb_cluster_operation_cancel; anuluj tylko przed punktem bez powrotu | 1 |
| Switchover | fb_cluster_switchover: planowane przeniesienie mastera, czeka na zakończenie operacji | 2 |
| Failover | fb_cluster_failover: tylko za wyraźną zgodą na utratę danych | 2 |
| Przywróć starego mastera | fb_cluster_rejoin | 2 |
| Usuń usługę | fb_cluster_service_delete: usuwany jest tylko rekord w RCM | 2 |
- Gotowy scenariusz„Zbuduj klaster”: asystent przechodzi krok po kroku i na każdym kroku pokazuje, co zrobi.
- Odcisk palcaPrzed połączeniem asystent pokazuje odcisk certyfikatu każdego serwera. Porównaj go z wierszem z podsumowania instalacji.
- Próba na suchoZanim przejmie folder z bazami danych pod zarządzanie, asystent pokazuje, które bazy danych znajdzie RCM.
- Switchover i failoverAsystent rozpoczyna przeniesienie mastera i śledzi kroki operacji. Osoba na serwerze potwierdza start. Failover wymaga również wyraźnej zgody na utratę danych. Więcej na stronie klastra.
HTTPS · klucze API · audyt
Tryb zdalny, instalacja i dziennik audytu
Asystent działa na komputerze administratora, a serwer MCP działa na serwerze bazy danych. Między nimi są HTTPS i klucz API. Każda osoba ma własny klucz i własny maksymalny poziom.
- Klucz dla każdej osoby
fbmcp ctl apikey new <name> --max-tier 2. Wartość jest pokazywana jednorazowo. Po zmianie klucza stary klucz przestaje działać w ciągu kilku sekund. - LimityNa klucz: równoczesne wywołania, wywołania na minutę, otwarte sesje. Po przekroczeniu limitu odpowiedź to 429.
- Przewodnik w języku portugalskimPełny przewodnik po instalacji i użytkowaniu jest dostępny również w brazylijskim portugalskim.
- Agenci autonomiczniProfil
autonomous: domyślnie tylko odczyt. Zmiana czeka na operatora na serwerze;fb_confirmod agenta jest odrzucane. 10 wywołań na minutę. Uruchamiaj takich agentów w sieci firmowej. - AdresyKlucz można powiązać z adresami (
allow_from). Inny adres otrzymuje 403 i wpis w dzienniku.
Instalacja w HQbird
Instalator HQbird domyślnie instaluje serwer MCP. Jeden serwer obsługuje wszystkie linie Firebird na maszynie. Jedno polecenie konfiguruje wszystko i można je uruchomić ponownie.
- 1Instalator HQbirdWindows lub Linux
- 2fbmcp ctl hqbird-installjedno polecenie, bez ręcznej edycji YAML
- 3Linie Firebirdznajduje każdą linię i jej agenta
- 4Bazy danychaliasy databases.conf i niedawno podłączone bazy danych
- 5✓ Usługauruchom, sprawdź, połącz plik .txt dla klientów
Tryb zdalny włącza się, gdy spełnione są trzy warunki: ustawiona jest lista adresów administratorów (--allow-from), zapora sieciowa działa i istnieje co najmniej jeden klucz API. Klucz tworzysz osobno. Następnie uruchom ponownie fbmcp ctl hqbird-install. Domyślny port to 8650.
Łańcuch skrótów
Każda decyzja (dozwolona, oczekująca, zatwierdzona, odrzucona) jest zapisywana w logu. Każdy wpis jest powiązany z poprzednim. Sprawdzenie łańcucha pokazuje, czy wpis został zmieniony lub usunięty.
Log skrócony — serwer pozostaje wyłączony
Jeśli log jest skrócony lub jego koniec nie zgadza się z wpisem kontrolnym, serwer MCP nie uruchamia się. To oznaka manipulacji, którą musisz zbadać. Polecenie fbmcp ctl verify sprawdza cały łańcuch.
Poprzez agenta
fbagent aktualizuje serwer MCP: zatrzymanie, zamiana, uruchomienie, sprawdzenie, wycofanie w razie awarii. W systemie Linux niepodpisana kompilacja nie jest instalowana. Konfiguracja i klucze nie zmieniają się.