Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał angielski. English

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.

    Ścieżka wywołania: asystent, sprawdzenie polityki fbmcp, cztery poziomy, dziennik audytu
    PoziomNarzędziaPrzykładyJak jest zatwierdzany
    0 · Odczyt51sesje, transakcje, plan zapytania, gstat, firebird.log, raporty agentaNie jest potrzebne. Transakcja tylko do odczytu.
    1 · Zmiana31DML i DDL, kopia zapasowa, testowy odtworzenie, sweep, użytkownicy i uprawnienia, zakończenie sesjiW czacie: numer żądania i token, następnie fb_confirm.
    2 · Niebezpieczna operacja14zastąpienie bazy danych z kopii zapasowej, edycja firebird.conf, zatrzymanie i ponowne uruchomienie FirebirdTylko na serwerze: polecenie fbmcp ctl approve. W systemie Windows można też zainstalować okno w zasobniku.
    3 · Wyłączone1usunięcie bazy danychNigdy 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_cancel usuwa żą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 approve lub 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.

    ZadanieNarzędziaPoziom
    Czy wszystko działafb_ping, fb_db_list, fb_db_health, fb_service_status0
    Sesje i długie transakcjefb_sessions, fb_transactions; zakończenie sesji — fb_session_kill0 · 1
    Logi i statystykifb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Kopia zapasowa i weryfikacjafb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Stare kopie zapasowefb_retention_run: najpierw próba na sucho; usuwa tylko zweryfikowane kopie zapasowe z własnego katalogu1
    Sweep i walidacja bazy danychfb_sweep, fb_validate (tylko ustalenia, bez naprawy)1
    Użytkownicy i uprawnieniafb_user_create, fb_grant, fb_revoke; SYSDBA i własnych kont nie można usunąć1
    Śledzeniefb_trace_start tylko z szablonami: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; edycja — fb_config_set, Firebird nie jest restartowany0 · 2
    Usługa i zastąpienie bazy danychfb_service_restart; fb_restore_replace, stary plik pozostaje jako .pre-restore2

    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.

    1. 1Harmonogramfb_schedule_create, cel nightly_verify; zatwierdzany raz
    2. 2Kopia zapasowagbak do folderu kopii zapasowych
    3. 3Testowe odtworzeniedo folderu roboczego; źródłowa baza danych nie jest naruszana
    4. 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.

    Kontrola kondycji Optymalizacja Audyt bezpieczeństwa Przegląd DDL Plan migracji Gotowość na awarię Kreator zapytań

    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.

    1. 1Zadanieczego potrzebujesz, w jednym zdaniu
    2. 2Faktyfb_schema_list, fb_describe: tylko istniejące tabele i kolumny
    3. 3Szkicjeden SELECT z ORDER BY
    4. 4Sprawdzeniefb_query_check: kompilacja bez uruchamiania
    5. 5✓ Tabela w czaciefb_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
    6 wierszy · PLAN SORT (EMPLOYEE NATURAL) · tylko do odczytu
    fb_index_advice

    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.

    fb_diff_schema · fb_diff_data

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

    fb_migration_*

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

    CoNarzędziaPoziom
    Raport kondycji serwerafb_agent_status0
    LWM, gstat, metryki bazy danych, ślady, zakleszczeniafb_agent_artifact_get, fb_agent_perf_report0
    Ustawienia kopii zapasowej, sweep i przywracaniafb_agent_backup_config; hasła i tokeny są ukryte0
    Uruchom zadanie agentafb_agent_job_run; kopia zapasowa, przywracanie i skrypt SQL to poziom 21 · 2
    Zmień ustawienie zadaniafb_agent_config_set; poświadczenia, identyfikatory i polecenia nie mogą być zmieniane2
    Restart Firebird przez agentafb_agent_restart, fb_agent_stop, fb_agent_start2
    Licencja i aktualizacjefb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 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 agentafb_agent_discover znajduje 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_stop i fb_agent_start domyślnie odmawiają: restartami steruje węzeł. fb_service_restart tego 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.

    CoNarzędziaPoziom
    Stan klastra na serwerzefb_agent_cluster: wolny, w klastrze lub właściciel RCM; slot i porty0
    Przegląd klastra w RCMfb_cluster_status: węzły, bazy danych, polecenia, alerty0
    Sprawdź hosty przed połączeniemfb_cluster_probe: wiersz na agenta, odcisk certyfikatu0
    Porównaj mastera i replikęfb_cluster_verify: liczba wierszy każdej tabeli0
    Włącz RCM na serwerzefb_agent_cluster_rcm1
    Okno parowaniafb_agent_cluster_pairing: stan, otwarte na 1–24 godziny, zamknij0 · 1
    Połącz hostyfb_cluster_link; żądanie pokazuje odciski do porównania1
    Bazy danych i publikacjafb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    Hasło RCMfb_cluster_rcm_password: nowe losowe hasło, niewyświetlane w czacie1
    Kopia bazy danych do replikifb_cluster_reinit2
    Restart Firebird węzłafb_cluster_firebird_restart2
    Usuń serwer z klastrafb_cluster_unlink2
    Usługi: gdzie jest masterfb_cluster_service: master, repliki, routery, problemy, uruchomiona operacja0
    Opisz usługę i jej regułęfb_cluster_service_put, fb_cluster_service_policy: opis usługi, reguła automatycznego failover1
    Wznów i anuluj operacjęfb_cluster_resume, fb_cluster_operation_cancel; anuluj tylko przed punktem bez powrotu1
    Switchoverfb_cluster_switchover: planowane przeniesienie mastera, czeka na zakończenie operacji2
    Failoverfb_cluster_failover: tylko za wyraźną zgodą na utratę danych2
    Przywróć starego masterafb_cluster_rejoin2
    Usuń usługęfb_cluster_service_delete: usuwany jest tylko rekord w RCM2
    • 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.

    Komputer administratora z klientem MCP i mostkiem fbmcp, HTTPS przez zaporę do usługi fbmcp; fbmcp komunikuje się z Firebird i fbagent; osoba na serwerze zatwierdza niebezpieczne żądania
    Tryb zdalny. Mostek na komputerze pobiera klucz z magazynu kluczy systemu operacyjnego i weryfikuje certyfikat serwera przez pin. Hasła i ścieżki baz danych nie trafiają do czatu: bazy danych są nazywane przez id.
    • Klucz dla każdej osobyfbmcp 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_confirm od 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.

    1. 1Instalator HQbirdWindows lub Linux
    2. 2fbmcp ctl hqbird-installjedno polecenie, bez ręcznej edycji YAML
    3. 3Linie Firebirdznajduje każdą linię i jej agenta
    4. 4Bazy danychaliasy databases.conf i niedawno podłączone bazy danych
    5. 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.

    audit.jsonl

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

    Awaria — zatrzymanie

    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.

    Aktualizacja

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

    ← Powrót do przeglądu HQbird 2027