Cette page a été traduite automatiquement. Lisez l'original en anglais. English

Assistant IA sous contrôle humain

HQbird MCP connecte Firebird à un assistant IA. Vous écrivez en langage naturel, et l'assistant choisit lui-même les outils. Il lit librement. Chaque modification attend votre « oui », et une modification dangereuse attend une approbation sur le serveur lui-même.

  • 122 outils
  • 56 en lecture seule
  • Firebird 2.5–5 Windows et Linux
  • 2 canaux d'approbation
  • journal d'audit avec chaîne de hachage

Exemple

Une conversation avec l'assistant

Les utilisateurs se plaignent que la base de données est lente. L'assistant lit les données, trouve la cause, propose une action et attend votre décision. Les noms et les chiffres de l'exemple sont fictifs.

Tout client MCP fonctionne : Claude Desktop, Claude Code, Cursor, Codex, ZCode et autres.

    Politique · approbation

    Quatre niveaux de danger

    Chaque outil a un niveau. Le serveur MCP vérifie lui-même le niveau et les conditions avant l'exécution de l'appel. Un appel qui modifie quelque chose renvoie une demande d'approbation, pas un résultat. L'assistant ne peut pas contourner cette vérification.

    Choisissez un outil et voyez quel chemin prend son appel.

    Call path: assistant, fbmcp policy check, four levels, audit log
    NiveauOutilsExemplesMode d'approbation
    0 · Lecture51sessions, transactions, plan de requête, gstat, firebird.log, rapports de l'agentNon requise. Transaction en lecture seule.
    1 · Modification31DML et DDL, sauvegarde, restauration de test, sweep, utilisateurs et droits, fin d'une sessionDans le chat : numéro de demande et jeton, puis fb_confirm.
    2 · Opération dangereuse14remplacer une base de données depuis une sauvegarde, modifier firebird.conf, arrêter et redémarrer FirebirdSur le serveur uniquement : la commande fbmcp ctl approve. Sous Windows, vous pouvez aussi installer une fenêtre dans la zone de notification.
    3 · Désactivé1supprimer une base de donnéesNe s'exécute jamais.
    • AperçuChaque outil nécessitant une approbation accepte mode: preview. Il montre ce qui sera fait et ne fait rien.
    • Conditions du niveau 2Chaque opération de niveau 2 nécessite une fenêtre de maintenance ouverte sur cette base de données. Remplacer une base de données depuis une sauvegarde, une fenêtre exclusive et du SQL dangereux nécessitent aussi une sauvegarde vérifiée de moins de 24 heures. Un refus indique ce qui manque.
    • Uniquement les outils autorisésLe client ne voit dans la liste que ce qu'il est autorisé à utiliser : pas de niveau 3 et pas de niveaux supérieurs au maximum de sa clé. Un appel direct à un outil masqué est refusé.
    • Une demande vit 15 minutesUne tentative d'approbation via le mauvais canal ne la consomme pas. fb_cancel supprime la demande.
    • Pas de page d'approbationEt il n'y en aura pas : une page accessible au modèle briserait la protection. Seule une personne sur le serveur approuve : avec la commande fbmcp ctl approve ou dans la fenêtre de la zone de notification, si elle est installée.

    Les lectures s'exécutent dans une transaction en lecture seule : Firebird lui-même bloque les écritures. Pour une seconde couche de protection, définissez un utilisateur distinct en lecture seule sans droits d'écriture.

    Surveillance · sauvegardes · droits

    Pour les DBA

    L'assistant fait ce qu'un DBA fait à la main : vérifie les sessions et les transactions, lit les journaux, effectue une sauvegarde et la vérifie par une restauration, gère les utilisateurs. Il désigne les bases de données par identifiant, pas par chemin de fichier.

    TâcheOutilsNiveau
    Tout fonctionne-t-ilfb_ping, fb_db_list, fb_db_health, fb_service_status0
    Sessions et transactions longuesfb_sessions, fb_transactions ; pour terminer une session — fb_session_kill0 · 1
    Journaux et statistiquesfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Sauvegarde et vérificationfb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Anciennes sauvegardesfb_retention_run : d'abord une simulation ; ne supprime que les sauvegardes vérifiées de son propre catalogue1
    Sweep et validation de la base de donnéesfb_sweep, fb_validate (constats uniquement, pas de réparation)1
    Utilisateurs et droitsfb_user_create, fb_grant, fb_revoke ; SYSDBA et ses propres comptes ne peuvent pas être supprimés1
    Tracesfb_trace_start avec des modèles uniquement : audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff ; pour modifier — fb_config_set, Firebird n'est pas redémarré0 · 2
    Service et remplacement de base de donnéesfb_service_restart ; fb_restore_replace, l'ancien fichier est conservé sous .pre-restore2

    Vérification nocturne des sauvegardes

    La planification est approuvée une fois, lors de sa création. Ensuite, elle s'exécute sans intervention humaine. Chaque nuit, vous obtenez une sauvegarde vérifiée. Elle est nécessaire, par exemple, pour remplacer une base de données depuis une sauvegarde.

    1. 1Planificationfb_schedule_create, objectif nightly_verify ; approuvée une fois
    2. 2Sauvegardegbak vers le dossier de sauvegarde
    3. 3Restauration de testdans un dossier de travail ; la base de données source n'est pas touchée
    4. 4✓ Sauvegarde vérifiéeune marque dans le catalogue des sauvegardes

    Le remplacement d'une base de données depuis une sauvegarde et les opérations de niveau 3 ne peuvent pas être planifiés.

    Scénarios prêts à l'emploi

    Les scénarios suggèrent l'ordre des étapes à l'assistant. Il n'applique pas les modifications de lui-même.

    Contrôle de santé Optimisation Audit de sécurité Revue DDL Plan de migration Préparation aux sinistres Générateur de requêtes

    Requêtes · index · migrations

    Pour les développeurs

    L'assistant dans Cursor ou Claude Code connaît votre schéma, vérifie une requête avant son exécution et affiche le résultat sous forme de tableau directement dans le chat.

    1. 1Tâchece dont vous avez besoin, en une phrase
    2. 2Faitsfb_schema_list, fb_describe : uniquement les tables et colonnes existantes
    3. 3Ébaucheun SELECT avec ORDER BY
    4. 4Vérificationfb_query_check : compilation sans exécution
    5. 5✓ Tableau dans le chatfb_query : lignes, plan et statistiques

    Résultat sous forme de tableau

    Dans les clients qui prennent en charge MCP Apps, le résultat de fb_query est affiché sous forme de tableau triable. Les autres clients reçoivent les mêmes données sous forme de texte.

    100 lignes par défaut, 1000 au maximum. Le tableau reste en mémoire pendant 30 minutes, et seule la personne qui l'a demandé peut le voir. Cliquez sur l'en-tête d'une colonne pour trier.

    SELECT full_name, dept_no, salary
    FROM employee
    WHERE salary > 60000
    ORDER BY salary DESC
    6 lignes · PLAN SORT (EMPLOYEE NATURAL) · lecture seule
    fb_index_advice

    Conseils d'index

    Détecte les analyses complètes de table et suggère CREATE INDEX avec une estimation du gain. Il ne crée pas l'index lui-même : fb_write s'en charge, avec approbation. Une fois l'index créé, il vérifie à nouveau le plan.

    fb_diff_schema · fb_diff_data

    Comparaison de bases de données

    Schéma de deux bases de données, ou d'une base de données et de son instantané : quoi créer, modifier, supprimer. Les données sont comparées par clé primaire ; l'outil ne compare pas une grande table (par défaut, plus de 100 000 lignes).

    fb_migration_*

    Migrations

    Le plan indique le niveau de chaque instruction. Toutes les migrations sont appliquées après une seule approbation ; si un fichier change, une nouvelle demande est nécessaire. Le plan de rollback est construit à partir de ce qui a été enregistré lors de l'application des migrations.

    fb_write détermine le niveau de chaque instruction d'un script. Un script qui mélange des instructions de niveaux différents est rejeté.

    fbagent · API locale · 127.0.0.1

    Données fbagent

    L'agent fbagent s'exécute déjà sur le serveur HQbird. Via MCP, l'assistant obtient tout ce que l'agent a collecté : le rapport de santé, LWM (Light-weight Monitoring), gstat, les traces, les interblocages, l'état des sauvegardes. Il exécute aussi les tâches de l'agent et modifie leurs paramètres, selon les mêmes niveaux et approbations.

    QuoiOutilsNiveau
    Rapport de santé du serveurfb_agent_status0
    LWM, gstat, métriques de base de données, traces, interblocagesfb_agent_artifact_get, fb_agent_perf_report0
    Paramètres de sauvegarde, sweep et restaurationfb_agent_backup_config ; les mots de passe et jetons sont masqués0
    Exécuter une tâche de l'agentfb_agent_job_run ; sauvegarde, restauration et script SQL sont de niveau 21 · 2
    Modifier un paramètre de tâchefb_agent_config_set ; les identifiants, ids et commandes ne peuvent pas être modifiés2
    Redémarrer Firebird via l'agentfb_agent_restart, fb_agent_stop, fb_agent_start2
    Licence et mises à jourfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 1 · 2
    • Local uniquementL'agent n'accepte les requêtes que sur 127.0.0.1. L'adresse de l'agent provient de la configuration du serveur MCP, pas du chat.
    • Le jeton reste masquéLe jeton de l'agent n'apparaît ni dans la sortie des outils ni dans le journal d'audit.
    • Découverte des agentsfb_agent_discover trouve les agents sur le serveur via les services Windows ou les unités systemd. Il ne lit pas les jetons.
    • ClusterSi un nœud de cluster est installé sur le serveur, fb_agent_restart, fb_agent_stop et fb_agent_start refusent par défaut : le nœud contrôle les redémarrages. fb_service_restart ne vérifie pas cela, donc ne l'utilisez pas sur un nœud de cluster.

    Double contrôle. Le serveur MCP approuve la requête, et l'agent lui-même exécute la tâche, selon ses propres règles. Le journal MCP indique qui a demandé ; les journaux de l'agent indiquent comment cela a été fait.

    HQbird Cluster · RCM

    Cluster de réplication via l'assistant

    L'assistant construit un cluster de réplication étape par étape : il active RCM, ouvre la fenêtre d'appairage, relie les hôtes, prend des bases de données sous gestion et fait une copie pour la réplique. Il fonctionne via l'agent et RCM. Vous n'avez pas besoin de vous connecter aux serveurs en SSH.

    Les règles sont les mêmes que partout. Les lectures ne nécessitent aucune confirmation. Un changement est confirmé dans le chat. Un redémarrage de Firebird, une copie de base de données vers la réplique, la suppression d'un serveur du cluster, le switchover, le failover et le retour de l'ancien maître sont confirmés sur le serveur.

    QuoiOutilsNiveau
    État du cluster sur le serveurfb_agent_cluster : libre, dans un cluster ou propriétaire RCM ; slot et ports0
    Vue d'ensemble du cluster dans RCMfb_cluster_status : nœuds, bases de données, commandes, alertes0
    Vérifier les hôtes avant la liaisonfb_cluster_probe : une ligne par agent, empreinte du certificat0
    Comparer maître et répliquefb_cluster_verify : nombre de lignes de chaque table0
    Activer RCM sur le serveurfb_agent_cluster_rcm1
    Fenêtre d'appairagefb_agent_cluster_pairing : état, ouverte pendant 1 à 24 heures, fermer0 · 1
    Relier les hôtesfb_cluster_link ; la demande affiche les empreintes à comparer1
    Bases de données et publicationfb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    Mot de passe RCMfb_cluster_rcm_password : un nouveau mot de passe aléatoire, non affiché dans le chat1
    Copie de base de données vers la répliquefb_cluster_reinit2
    Redémarrer le Firebird d'un nœudfb_cluster_firebird_restart2
    Retirer un serveur du clusterfb_cluster_unlink2
    Services : où se trouve le maîtrefb_cluster_service : maître, répliques, routeurs, problèmes, opération en cours0
    Décrire un service et sa règlefb_cluster_service_put, fb_cluster_service_policy : description du service, règle de bascule automatique1
    Reprendre et annuler une opérationfb_cluster_resume, fb_cluster_operation_cancel ; annuler uniquement avant le point de non-retour1
    Switchoverfb_cluster_switchover : déplacement planifié du maître, attend la fin de l'opération2
    Failoverfb_cluster_failover : uniquement avec consentement explicite à la perte de données2
    Ramener l'ancien maîtrefb_cluster_rejoin2
    Supprimer un servicefb_cluster_service_delete : seul l'enregistrement dans RCM est supprimé2
    • Scénario prêt à l'emploi« Construire un cluster » : l'assistant avance étape par étape et montre à chaque étape ce qu'il va faire.
    • EmpreintesAvant la liaison, l'assistant affiche l'empreinte du certificat de chaque serveur. Comparez-la avec la ligne du résumé d'installation.
    • Exécution à blancAvant de prendre un dossier avec des bases de données sous gestion, l'assistant montre quelles bases de données RCM trouvera.
    • Switchover et failoverL'assistant lance le déplacement du maître et suit les étapes de l'opération. Une personne sur le serveur confirme le démarrage. Le failover nécessite également un consentement explicite à la perte de données. Plus d'informations sur la page du cluster.

    HTTPS · clés API · audit

    Mode distant, installation et journal d'audit

    L'assistant s'exécute sur le PC de l'administrateur, et le serveur MCP s'exécute sur le serveur de base de données. Entre eux, HTTPS et une clé API. Chaque personne dispose de sa propre clé et de son propre niveau maximal.

    PC administrateur avec un client MCP et le pont fbmcp, HTTPS à travers un pare-feu vers le service fbmcp ; fbmcp communique avec Firebird et fbagent ; une personne sur le serveur approuve les requêtes dangereuses
    Mode distant. Le pont sur le PC récupère la clé depuis le magasin de clés du système d'exploitation et vérifie le certificat du serveur par épinglage. Les mots de passe et les chemins des bases de données n'atteignent pas le chat : les bases de données sont désignées par id.
    • Une clé par personnefbmcp ctl apikey new <name> --max-tier 2. La valeur n'est affichée qu'une fois. Après un changement de clé, l'ancienne clé cesse de fonctionner en quelques secondes.
    • LimitesPar clé : appels simultanés, appels par minute, sessions ouvertes. Au-delà de la limite, la réponse est 429.
    • Guide en portugaisLe guide complet d'installation et d'utilisation est également disponible en portugais brésilien.
    • Agents autonomesLe profil autonomous : lecture seule par défaut. Un changement attend un opérateur sur le serveur ; fb_confirm de l'agent est rejeté. 10 appels par minute. Exécutez ces agents à l'intérieur du réseau de l'entreprise.
    • AdressesUne clé peut être liée à des adresses (allow_from). Une autre adresse reçoit 403 et une entrée dans le journal.

    Installation dans HQbird

    L'installateur HQbird installe le serveur MCP par défaut. Un seul serveur dessert toutes les lignes Firebird de la machine. Une seule commande configure tout, et vous pouvez la relancer.

    1. 1Installateur HQbirdWindows ou Linux
    2. 2fbmcp ctl hqbird-installune seule commande, aucune modification manuelle du YAML
    3. 3Lignes Firebirdtrouve chaque ligne et son agent
    4. 4Bases de donnéesalias de databases.conf et bases de données récemment attachées
    5. 5✓ Servicedémarrer, vérifier, se connecter au fichier .txt pour les clients

    Le mode distant s'active lorsque trois conditions sont réunies : une liste d'adresses d'administrateurs est définie (--allow-from), le pare-feu est en cours d'exécution et au moins une clé API existe. Vous créez la clé séparément. Ensuite, exécutez à nouveau fbmcp ctl hqbird-install. Le port par défaut est 8650.

    audit.jsonl

    Chaîne de hachage

    Chaque décision (autorisée, en attente, approuvée, rejetée) est écrite dans le journal. Chaque entrée est liée à la précédente. Une vérification de la chaîne indique si une entrée a été modifiée ou supprimée.

    Échec — arrêt

    Journal tronqué — le serveur reste arrêté

    Si le journal est tronqué ou si sa fin ne correspond pas à l'entrée de contrôle, le serveur MCP ne démarre pas. C'est le signe d'une altération, et vous devez enquêter. La commande fbmcp ctl verify vérifie toute la chaîne.

    Mise à jour

    Via l'agent

    fbagent met à jour le serveur MCP : arrêt, remplacement, démarrage, vérification, retour arrière en cas d'échec. Sous Linux, une compilation non signée n'est pas installée. La configuration et les clés ne changent pas.

    ← Retour à la présentation de HQbird 2027