AI-ассистент под контролем человека

HQbird MCP подключает Firebird к AI-ассистенту. Вы пишете обычными словами, ассистент сам выбирает инструменты. Читает он свободно. Каждое изменение ждёт вашего «да», а опасное — подтверждения на самом сервере.

  • 122 инструмента
  • 56 только читают
  • Firebird 2.5–5 Windows и Linux
  • 2 канала подтверждения
  • журнал с цепочкой хэшей

Пример

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

Пользователи жалуются, что база тормозит. Ассистент читает данные, находит причину, предлагает действие и ждёт вашего решения. Имена и числа в примере условные.

Подходит любой MCP-клиент: Claude Desktop, Claude Code, Cursor, Codex, ZCode и другие.

    Политика · подтверждение

    Четыре уровня опасности

    У каждого инструмента есть уровень. MCP-сервер сам проверяет уровень и условия до выполнения. Вызов изменения возвращает не результат, а запрос на подтверждение. Ассистент не может обойти эту проверку.

    Выберите инструмент и посмотрите, какой путь проходит его вызов.

    Путь вызова: ассистент, проверка политики fbmcp, четыре уровня, журнал аудита
    УровеньИнструментовПримерыКак подтверждается
    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 · Local API · 127.0.0.1

    Данные агента fbagent

    На сервере HQbird уже работает агент fbagent. Через MCP ассистент получает всё, что собрал агент: отчёт о здоровье, LWM (Light-weight Monitoring), gstat, трассы, deadlock, состояние бэкапов. Он также запускает задания агента и меняет их настройки, под теми же уровнями и подтверждениями.

    ЧтоИнструментыУровень
    Отчёт о здоровье сервераfb_agent_status0
    LWM, gstat, метрики баз, трассы, deadlockfb_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
    Обзор кластера в RCMfb_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
    Пароль RCMfb_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: описание сервиса, правило автоматического failover1
    Resume и отмена операцииfb_cluster_resume, fb_cluster_operation_cancel; отмена только до точки невозврата1
    Switchoverfb_cluster_switchover: плановый перенос мастера, ждёт конца операции2
    Failoverfb_cluster_failover: только с явным согласием на потерю данных2
    Вернуть старый мастерfb_cluster_rejoin2
    Удалить сервисfb_cluster_service_delete: удаляется только запись в RCM2
    • Готовый сценарий«Собери кластер»: ассистент идёт по шагам и на каждом показывает, что будет сделано.
    • ОтпечаткиПеред связью ассистент показывает отпечаток сертификата каждого сервера. Сравните его со строкой из итога установки.
    • Сухой запускПеред тем как взять папку с базами под управление, ассистент показывает, какие базы найдёт RCM.
    • Switchover и failoverАссистент запускает перенос мастера и следит за шагами операции. Запуск подтверждает человек на сервере. Failover требует ещё и явного согласия на потерю данных. Подробнее на странице кластера.

    HTTPS · API-ключи · аудит

    Удалённый режим, установка и журнал

    Ассистент работает на ПК администратора, а MCP-сервер — на сервере базы данных. Между ними HTTPS и API-ключ. У каждого человека свой ключ и свой максимальный уровень.

    ПК администратора с MCP-клиентом и мостом fbmcp bridge, HTTPS через файрвол к службе fbmcp на сервере; fbmcp обращается к Firebird и к агенту fbagent; опасные запросы одобряет человек на сервере
    Удалённый режим. Мост на ПК берёт ключ из хранилища ОС и проверяет сертификат сервера по pin. Пароли и пути к базам в чат не попадают: базы указываются по id.
    • Ключ для каждогоfbmcp ctl apikey new <имя> --max-tier 2. Значение показывается один раз. После смены ключа старый перестаёт работать через несколько секунд.
    • ЛимитыНа каждый ключ: одновременные вызовы, вызовы в минуту, открытые сессии. Сверх лимита — ответ 429.
    • Руководство на португальскомПолное руководство по установке и работе есть и на бразильском португальском.
    • Автономные агентыПрофиль autonomous: по умолчанию только чтение. Изменение ждёт оператора на сервере, fb_confirm от агента отклоняется. 10 вызовов в минуту. Агента запускают внутри сети компании.
    • АдресаКлюч можно привязать к адресам (allow_from). Другой адрес получает 403 и запись в журнале.

    Установка в HQbird

    Установщик HQbird ставит MCP-сервер по умолчанию. Один сервер обслуживает все линии Firebird на машине. Всё настраивает одна команда, её можно запускать повторно.

    1. 1Установщик HQbirdWindows или Linux
    2. 2fbmcp ctl hqbird-installодна команда, без ручной правки YAML
    3. 3Линии Firebirdнаходит каждую линию и её агента
    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