Ова страница је машински преведена. Прочитајте енглески оригинал. English

AI асистент под људском контролом

HQbird MCP повезује Firebird са AI асистентом. Пишете обичним речима, а асистент сам бира алате. Чита слободно. Свака измена чека ваше „да“, а опасна чека одобрење на самом серверу.

  • 122 алата
  • 56 само за читање
  • Firebird 2.5–5 Windows и Linux
  • 2 канала за одобрење
  • лог ревизије са хеш ланцем

Пример

Разговор са асистентом

Корисници се жале да је база података спора. Асистент чита податке, проналази узрок, предлаже акцију и чека вашу одлуку. Имена и бројеви у примеру су измишљени.

Ради било који MCP клијент: Claude Desktop, Claude Code, Cursor, Codex, ZCode и други.

    Политика · одобрење

    Четири нивоа опасности

    Сваки алат има ниво. MCP сервер сам проверава ниво и услове пре него што се позив изврши. Позив који нешто мења враћа захтев за одобрење, а не резултат. Асистент не може да заобиђе ову проверу.

    Изаберите алат и погледајте којим путем иде његов позив.

    Call path: assistant, fbmcp policy check, four levels, audit log
    НивоАлатиПримериКако се одобрава
    0 · Читање51сесије, трансакције, план упита, gstat, firebird.log, извештаји агентаНије потребно. Трансакција само за читање.
    1 · Измена31DML и DDL, резервна копија, тестни опоравак, sweep, корисници и дозволе, прекидање сесијеУ чету: број захтева и токен, затим fb_confirm.
    2 · Опасна операција14замена базе података из резервне копије, измена firebird.conf, заустављање и поновно покретање FirebirdСамо на серверу: команда fbmcp ctl approve. На Windows-у можете инсталирати и прозор у системској траци.
    3 · Онемогућено1брисање базе податакаНикада се не извршава.
    • ПрегледСваки алат који захтева одобрење прихвата mode: preview. Приказује шта ће бити урађено и ништа не ради.
    • Услови за ниво 2Свака операција нивоа 2 захтева отворен прозор за одржавање на тој бази података. Замена базе података из резервне копије, ексклузивни прозор и опасан SQL такође захтевају проверену резервну копију не старију од 24 сата. Одбијање наводи шта недостаје.
    • Само дозвољени алатиКлијент у листи види само оно што му је дозвољено: без нивоа 3 и без нивоа изнад максимума његовог кључа. Директан позив скривеног алата се одбија.
    • Захтев живи 15 минутаПокушај одобрења кроз погрешан канал га не троши. fb_cancel брише захтев.
    • Нема странице за одобрењеИ неће је бити: страница до које модел може да дође нарушила би заштиту. Само особа на серверу одобрава: командом fbmcp ctl approve или у прозору у системској траци, ако је инсталиран.

    Читања се извршавају у трансакцији само за читање: сам Firebird блокира уписе. За други слој заштите поставите посебног корисника само за читање без права писања.

    Надгледање · резервне копије · дозволе

    За DBA

    Асистент ради оно што DBA ради ручно: проверава сесије и трансакције, чита логове, прави резервну копију и верификује је опоравком, управља корисницима. Базе података именује по id-у, не по путањи датотеке.

    ЗадатакАлатиНиво
    Да ли све радиfb_ping, fb_db_list, fb_db_health, fb_service_status0
    Сесије и дуге трансакцијеfb_sessions, fb_transactions; за прекидање сесије — fb_session_kill0 · 1
    Логови и статистикаfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Резервна копија и верификацијаfb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Старе резервне копијеfb_retention_run: прво пробни рад; брише само проверене резервне копије из сопственог каталога1
    Sweep и валидација базе податакаfb_sweep, fb_validate (само налази, без поправке)1
    Корисници и дозволеfb_user_create, fb_grant, fb_revoke; SYSDBA и његови сопствени налози не могу се брисати1
    Траговиfb_trace_start само са шаблонима: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; за измену — fb_config_set, Firebird се не поново покреће0 · 2
    Сервис и замена базе податакаfb_service_restart; fb_restore_replace, стара датотека остаје као .pre-restore2

    Ноћна провера резервне копије

    Распоред се одобрава једном, када се креира. Након тога се извршава без људског присуства. Сваке ноћи добијате проверену резервну копију. Потребна вам је, на пример, да замените базу података из резервне копије.

    1. 1Распоредfb_schedule_create, циљ nightly_verify; одобрава се једном
    2. 2Резервна копијаgbak у фасциклу за резервне копије
    3. 3Пробни опораваку радну фасциклу; изворна база података се не дира
    4. 4✓ Резервна копија проверенаознака у каталогу резервних копија

    Замена базе података из резервне копије и операције нивоа 3 не могу се заказати.

    Готови сценарији

    Сценарији предлажу асистенту редослед корака. Он сам не примењује измене.

    Провера здравља Оптимизација Безбедносна ревизија Преглед DDL-а План миграције Спремност за катастрофе Градитељ упита

    Упити · индекси · миграције

    За програмере

    Асистент у Cursor-у или Claude Code-у познаје вашу шему, проверава упит пре него што се изврши и приказује резултат као табелу директно у чету.

    1. 1Задатакшта вам је потребно, у једној реченици
    2. 2Чињеницеfb_schema_list, fb_describe: само постојеће табеле и колоне
    3. 3Нацртједан SELECT са ORDER BY
    4. 4Провераfb_query_check: компајлирање без извршавања
    5. 5✓ Табела у четуfb_query: редови, план и статистика

    Резултат као табела

    У клијентима који подржавају MCP Apps, резултат fb_query се приказује као табела која се може сортирати. Остали клијенти добијају исте податке као текст.

    100 редова подразумевано, највише 1000. Табела остаје у меморији 30 минута, и само особа која ју је затражила може је видети. Кликните на заглавље колоне да сортирате.

    SELECT full_name, dept_no, salary
    FROM employee
    WHERE salary > 60000
    ORDER BY salary DESC
    6 редова · PLAN SORT (EMPLOYEE NATURAL) · само читање
    fb_index_advice

    Савет за индексе

    Проналази пуне скенирања табеле и предлаже CREATE INDEX са проценом користи. Сам не креира индекс: то чини fb_write, уз одобрење. Након креирања индекса, поново проверава план.

    fb_diff_schema · fb_diff_data

    Поређење база података

    Шема две базе података, или базе података и њеног снимка: шта креирати, изменити, одбацити. Подаци се пореде по примарном кључу; алат не пореди велику табелу (подразумевано, више од 100.000 редова).

    fb_migration_*

    Миграције

    План приказује ниво сваке наредбе. Све миграције се примењују након једног одобрења; ако се датотека промени, потребан је нови захтев. План враћања се гради од онога што је забележено приликом примене миграција.

    fb_write проналази ниво сваке наредбе у скрипти. Скрипта која меша наредбе различитих нивоа се одбија.

    fbagent · Локални API · 127.0.0.1

    fbagent подаци

    fbagent агент већ ради на HQbird серверу. Преко MCP-а асистент добија све што је агент прикупио: извештај о здрављу, LWM (Light-weight Monitoring), gstat, трагове, застоје, статус резервне копије. Такође извршава послове агента и мења њихова подешавања, под истим нивоима и одобрењима.

    ШтаАлатиНиво
    Извештај о здрављу сервераfb_agent_status0
    LWM, gstat, метрике базе података, трагови, застојиfb_agent_artifact_get, fb_agent_perf_report0
    Подешавања резервне копије, sweep-а и опоравкаfb_agent_backup_config; лозинке и токени су скривени0
    Покрени посао агентаfb_agent_job_run; резервна копија, опоравак и SQL скрипта су ниво 21 · 2
    Промени подешавање послаfb_agent_config_set; акредитиви, id-јеви и команде не могу се мењати2
    Поново покрени Firebird преко агентаfb_agent_restart, fb_agent_stop, fb_agent_start2
    Лиценца и ажурирањаfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 1 · 2
    • Само локалноАгент прихвата захтеве само на 127.0.0.1. Адреса агента долази из конфигурације MCP сервера, не из чета.
    • Токен остаје скривенТокен агента се не појављује у излазу алата ни у евиденцији ревизије.
    • Откривање агентаfb_agent_discover проналази агенте на серверу преко Windows сервиса или systemd јединица. Не чита токене.
    • КластерАко је на серверу инсталиран чвор кластера, fb_agent_restart, fb_agent_stop и fb_agent_start подразумевано одбијају: чвор контролише поновна покретања. fb_service_restart то не проверава, зато га не користите на чвору кластера.

    Двострука контрола. MCP сервер одобрава захтев, а агент сам извршава посао, по својим правилима. MCP дневник показује ко је тражио; дневници агента показују како је то урађено.

    HQbird Cluster · RCM

    Репликациони кластер кроз асистента

    Асистент гради репликациони кластер корак по корак: укључује RCM, отвара прозор за упаривање, повезује домаћине, узима базе података под управљање и прави копију за реплику. Ради кроз агента и RCM. Није потребно да се пријављујете на сервере преко SSH.

    Правила су иста као свуда. Читања не захтевају потврду. Промена се потврђује у чету. Поновно покретање Firebird-а, копирање базе на реплику, уклањање сервера из кластера, switchover, failover и повратак старог мастера потврђују се на серверу.

    ШтаАлатиНиво
    Стање кластера на серверуfb_agent_cluster: слободан, у кластеру или RCM власник; слот и портови0
    Преглед кластера у RCM-уfb_cluster_status: чворови, базе података, команде, упозорења0
    Провера домаћина пре повезивањаfb_cluster_probe: ред по агенту, отисак сертификата0
    Упоређивање мастера и репликеfb_cluster_verify: број редова сваке табеле0
    Укључивање RCM-а на серверуfb_agent_cluster_rcm1
    Прозор за упаривањеfb_agent_cluster_pairing: стање, отворен 1–24 сата, затварање0 · 1
    Повезивање домаћинаfb_cluster_link; захтев приказује отиске за упоређивање1
    Базе података и публикацијаfb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    RCM лозинкаfb_cluster_rcm_password: нова насумична лозинка, не приказује се у чету1
    Копија базе на репликуfb_cluster_reinit2
    Поновно покретање Firebird-а чвораfb_cluster_firebird_restart2
    Уклањање сервера из кластераfb_cluster_unlink2
    Сервиси: где је мастерfb_cluster_service: мастер, реплике, рутери, проблеми, операција у току0
    Опис сервиса и његовог правилаfb_cluster_service_put, fb_cluster_service_policy: опис сервиса, правило аутоматског failover-а1
    Наставак и отказивање операцијеfb_cluster_resume, fb_cluster_operation_cancel; отказивање само пре тачке без повратка1
    Switchoverfb_cluster_switchover: планирано премештање мастера, чека крај операције2
    Failoverfb_cluster_failover: само уз изричиту сагласност за губитак података2
    Враћање старог мастераfb_cluster_rejoin2
    Брисање сервисаfb_cluster_service_delete: брише се само запис у RCM-у2
    • Готов сценарио„Направи кластер”: асистент иде корак по корак и на сваком кораку показује шта ће урадити.
    • ОтисциПре повезивања, асистент приказује отисак сертификата сваког сервера. Упоредите га са линијом из резимеа инсталације.
    • Пробни радПре него што узме фасциклу са базама података под управљање, асистент показује које ће базе података RCM пронаћи.
    • Switchover и failoverАсистент покреће премештање мастера и прати кораке операције. Особа на серверу потврђује почетак. Failover такође захтева изричиту сагласност за губитак података. Више на страници кластера.

    HTTPS · API кључеви · ревизија

    Удаљени режим, инсталација и дневник ревизије

    Асистент ради на администраторовом рачунару, а MCP сервер ради на серверу базе података. Између њих су HTTPS и API кључ. Свака особа има свој кључ и свој максимални ниво.

    Администраторски рачунар са MCP клијентом и fbmcp мостом, HTTPS кроз заштитни зид до fbmcp сервиса; fbmcp комуницира са Firebird-ом и fbagent-ом; особа на серверу одобрава опасне захтеве
    Удаљени режим. Мост на рачунару узима кључ из OS складишта кључева и проверава сертификат сервера путем pin-а. Лозинке и путање база података не стижу у чет: базе података се именују по id-у.
    • Кључ за сваку особуfbmcp ctl apikey new <name> --max-tier 2. Вредност се приказује једном. Након промене кључа, стари кључ престаје да ради у року од неколико секунди.
    • ОграничењаПо кључу: истовремени позиви, позиви у минути, отворене сесије. Изнад ограничења, одговор је 429.
    • Водич на португалскомКомплетан водич за инсталацију и коришћење доступан је и на бразилском португалском.
    • Аутономни агентиПрофил autonomous: подразумевано само читање. Промена чека оператера на серверу; fb_confirm од агента се одбија. 10 позива у минути. Покрените такве агенте унутар компанијске мреже.
    • АдресеКључ се може везати за адресе (allow_from). Друга адреса добија 403 и запис у дневнику.

    Инсталација у HQbird-у

    HQbird инсталатер подразумевано инсталира MCP сервер. Један сервер опслужује све Firebird линије на машини. Једна команда подешава све, и можете је поново покренути.

    1. 1HQbird инсталатерWindows или Linux
    2. 2fbmcp ctl hqbird-installједна команда, без ручног уређивања YAML-а
    3. 3Firebird линијепроналази сваку линију и њен агент
    4. 4Базе податакаалијаси из databases.conf и недавно повезане базе података
    5. 5✓ Сервиспокретање, провера, датотека connect.txt за клијенте

    Удаљени режим се укључује када су испуњена три услова: подешена је листа администраторских адреса (--allow-from), заштитни зид ради и постоји најмање један API кључ. Кључ креирате одвојено. Након тога поново покрените fbmcp ctl hqbird-install. Подразумевани порт је 8650.

    audit.jsonl

    Хеш ланац

    Свака одлука (одобрено, на чекању, прихваћено, одбијено) се уписује у дневник. Сваки унос је повезан са претходним. Провера ланца показује да ли је неки унос измењен или избрисан.

    Неуспех — заустављање

    Дневник скраћен — сервер остаје искључен

    Ако је дневник скраћен или његов крај не одговара контролном уносу, MCP сервер се не покреће. То је знак неовлашћеног мешања и морате га истражити. Команда fbmcp ctl verify проверава цео ланац.

    Ажурирање

    Преко агента

    fbagent ажурира MCP сервер: заустави, замени, покрени, провери, врати на претходно стање у случају неуспеха. На Linux-у се неинсталира потписана верзија. Конфигурација и кључеви се не мењају.

    ← Назад на преглед HQbird 2027