Assistant IA HQbird MCP
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.
| Niveau | Outils | Exemples | Mode d'approbation |
|---|---|---|---|
| 0 · Lecture | 51 | sessions, transactions, plan de requête, gstat, firebird.log, rapports de l'agent | Non requise. Transaction en lecture seule. |
| 1 · Modification | 31 | DML et DDL, sauvegarde, restauration de test, sweep, utilisateurs et droits, fin d'une session | Dans le chat : numéro de demande et jeton, puis fb_confirm. |
| 2 · Opération dangereuse | 14 | remplacer une base de données depuis une sauvegarde, modifier firebird.conf, arrêter et redémarrer Firebird | Sur 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é | 1 | supprimer une base de données | Ne 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_cancelsupprime 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 approveou 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âche | Outils | Niveau |
|---|---|---|
| Tout fonctionne-t-il | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Sessions et transactions longues | fb_sessions, fb_transactions ; pour terminer une session — fb_session_kill | 0 · 1 |
| Journaux et statistiques | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Sauvegarde et vérification | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Anciennes sauvegardes | fb_retention_run : d'abord une simulation ; ne supprime que les sauvegardes vérifiées de son propre catalogue | 1 |
| Sweep et validation de la base de données | fb_sweep, fb_validate (constats uniquement, pas de réparation) | 1 |
| Utilisateurs et droits | fb_user_create, fb_grant, fb_revoke ; SYSDBA et ses propres comptes ne peuvent pas être supprimés | 1 |
| Traces | fb_trace_start avec des modèles uniquement : audit-lite, performance, errors | 1 |
| firebird.conf | fb_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ées | fb_service_restart ; fb_restore_replace, l'ancien fichier est conservé sous .pre-restore | 2 |
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.
- 1Planification
fb_schedule_create, objectifnightly_verify; approuvée une fois - 2Sauvegardegbak vers le dossier de sauvegarde
- 3Restauration de testdans un dossier de travail ; la base de données source n'est pas touchée
- 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.
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.
- 1Tâchece dont vous avez besoin, en une phrase
- 2Faits
fb_schema_list,fb_describe: uniquement les tables et colonnes existantes - 3Ébaucheun SELECT avec ORDER BY
- 4Vérification
fb_query_check: compilation sans exécution - 5✓ Tableau dans le chat
fb_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
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.
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).
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.
| Quoi | Outils | Niveau |
|---|---|---|
| Rapport de santé du serveur | fb_agent_status | 0 |
| LWM, gstat, métriques de base de données, traces, interblocages | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Paramètres de sauvegarde, sweep et restauration | fb_agent_backup_config ; les mots de passe et jetons sont masqués | 0 |
| Exécuter une tâche de l'agent | fb_agent_job_run ; sauvegarde, restauration et script SQL sont de niveau 2 | 1 · 2 |
| Modifier un paramètre de tâche | fb_agent_config_set ; les identifiants, ids et commandes ne peuvent pas être modifiés | 2 |
| Redémarrer Firebird via l'agent | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Licence et mises à jour | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 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 agents
fb_agent_discovertrouve 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_stopetfb_agent_startrefusent par défaut : le nœud contrôle les redémarrages.fb_service_restartne 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.
| Quoi | Outils | Niveau |
|---|---|---|
| État du cluster sur le serveur | fb_agent_cluster : libre, dans un cluster ou propriétaire RCM ; slot et ports | 0 |
| Vue d'ensemble du cluster dans RCM | fb_cluster_status : nœuds, bases de données, commandes, alertes | 0 |
| Vérifier les hôtes avant la liaison | fb_cluster_probe : une ligne par agent, empreinte du certificat | 0 |
| Comparer maître et réplique | fb_cluster_verify : nombre de lignes de chaque table | 0 |
| Activer RCM sur le serveur | fb_agent_cluster_rcm | 1 |
| Fenêtre d'appairage | fb_agent_cluster_pairing : état, ouverte pendant 1 à 24 heures, fermer | 0 · 1 |
| Relier les hôtes | fb_cluster_link ; la demande affiche les empreintes à comparer | 1 |
| Bases de données et publication | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| Mot de passe RCM | fb_cluster_rcm_password : un nouveau mot de passe aléatoire, non affiché dans le chat | 1 |
| Copie de base de données vers la réplique | fb_cluster_reinit | 2 |
| Redémarrer le Firebird d'un nœud | fb_cluster_firebird_restart | 2 |
| Retirer un serveur du cluster | fb_cluster_unlink | 2 |
| Services : où se trouve le maître | fb_cluster_service : maître, répliques, routeurs, problèmes, opération en cours | 0 |
| Décrire un service et sa règle | fb_cluster_service_put, fb_cluster_service_policy : description du service, règle de bascule automatique | 1 |
| Reprendre et annuler une opération | fb_cluster_resume, fb_cluster_operation_cancel ; annuler uniquement avant le point de non-retour | 1 |
| Switchover | fb_cluster_switchover : déplacement planifié du maître, attend la fin de l'opération | 2 |
| Failover | fb_cluster_failover : uniquement avec consentement explicite à la perte de données | 2 |
| Ramener l'ancien maître | fb_cluster_rejoin | 2 |
| Supprimer un service | fb_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.
- Une clé par personne
fbmcp 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_confirmde 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.
- 1Installateur HQbirdWindows ou Linux
- 2fbmcp ctl hqbird-installune seule commande, aucune modification manuelle du YAML
- 3Lignes Firebirdtrouve chaque ligne et son agent
- 4Bases de donnéesalias de databases.conf et bases de données récemment attachées
- 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.
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.
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.
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.