Bu sayfa makine çevirisidir. İngilizce orijinalini okuyun. English

İnsan kontrolü altında AI asistanı

HQbird MCP, Firebird'ü bir AI asistanına bağlar. Siz sade bir dille yazarsınız, asistan araçları kendisi seçer. Serbestçe okur. Her değişiklik sizin "evet"inizi bekler, tehlikeli olan ise sunucunun kendisinde onay bekler.

  • 122 araç
  • 56 salt okunur
  • Firebird 2.5–5 Windows ve Linux
  • 2 kanal onay için
  • denetim günlüğü hash zinciriyle

Örnek

Asistanla bir konuşma

Kullanıcılar veritabanının yavaş olduğundan şikayet ediyor. Asistan verileri okur, nedeni bulur, bir eylem önerir ve sizin kararınızı bekler. Örnekteki adlar ve sayılar uydurmadır.

Herhangi bir MCP istemcisi çalışır: Claude Desktop, Claude Code, Cursor, Codex, ZCode ve diğerleri.

    Politika · onay

    Dört tehlike seviyesi

    Her aracın bir seviyesi vardır. MCP sunucusu, çağrı çalışmadan önce seviyeyi ve koşulları kendisi kontrol eder. Bir şeyi değiştiren çağrı, sonuç yerine bir onay isteği döndürür. Asistan bu kontrolü atlayamaz.

    Bir araç seçin ve çağrısının hangi yolu izlediğini görün.

    Çağrı yolu: asistan, fbmcp politika kontrolü, dört seviye, denetim günlüğü
    SeviyeAraçlarÖrneklerNasıl onaylanır
    0 · Okuma51oturumlar, işlemler, sorgu planı, gstat, firebird.log, agent raporlarıGerekmez. Salt okunur işlem.
    1 · Değişiklik31DML ve DDL, yedekleme, test geri yükleme, sweep, kullanıcılar ve yetkiler, bir oturumu sonlandırmaSohbette: istek numarası ve token, ardından fb_confirm.
    2 · Tehlikeli işlem14bir veritabanını yedekten değiştirme, firebird.conf düzenleme, Firebird'ü durdurma ve yeniden başlatmaYalnızca sunucuda: fbmcp ctl approve komutu. Windows'ta ayrıca bir tepsi penceresi kurabilirsiniz.
    3 · Devre dışı1bir veritabanını silmeAsla çalışmaz.
    • ÖnizlemeOnay gerektiren her araç mode: preview kabul eder. Ne yapılacağını gösterir ve hiçbir şey yapmaz.
    • Seviye 2 koşullarıHer seviye 2 işlemi, o veritabanında açık bir bakım penceresi gerektirir. Bir veritabanını yedekten değiştirme, özel bir pencere ve tehlikeli SQL ayrıca 24 saatten eski olmayan doğrulanmış bir yedek gerektirir. Bir ret, neyin eksik olduğunu söyler.
    • Yalnızca izin verilen araçlarİstemci listede yalnızca kullanmasına izin verilenleri görür: seviye 3 yok ve anahtarının maksimumunun üzerindeki seviyeler yok. Gizli bir araca doğrudan çağrı reddedilir.
    • Bir istek 15 dakika yaşarYanlış kanaldan onaylama girişimi onu tüketmez. fb_cancel isteği siler.
    • Onay sayfası yokVe olmayacak: modelin erişebileceği bir sayfa korumayı bozar. Yalnızca sunucudaki bir kişi onaylar: fbmcp ctl approve komutuyla veya kuruluysa tepsi penceresinde.

    Okumalar salt okunur bir işlemde çalışır: yazmaları Firebird'ün kendisi engeller. İkinci bir koruma katmanı için yazma hakkı olmayan ayrı bir salt okunur kullanıcı ayarlayın.

    İzleme · yedeklemeler · yetkiler

    DBA'lar için

    Asistan, bir DBA'nın elle yaptığını yapar: oturumları ve işlemleri kontrol eder, günlükleri okur, yedek alır ve geri yüklemeyle doğrular, kullanıcıları yönetir. Veritabanlarını dosya yoluyla değil, kimlikle adlandırır.

    GörevAraçlarSeviye
    Her şey çalışıyor mufb_ping, fb_db_list, fb_db_health, fb_service_status0
    Oturumlar ve uzun işlemlerfb_sessions, fb_transactions; bir oturumu sonlandırmak için — fb_session_kill0 · 1
    Günlükler ve istatistiklerfb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends0
    Yedekleme ve doğrulamafb_backup_start (gbak), fb_backup_nbackup, fb_restore_test1
    Eski yedeklerfb_retention_run: önce deneme çalıştırması; yalnızca kendi kataloğundaki doğrulanmış yedekleri siler1
    Sweep ve veritabanı doğrulamafb_sweep, fb_validate (yalnızca bulgular, onarım yok)1
    Kullanıcılar ve yetkilerfb_user_create, fb_grant, fb_revoke; SYSDBA ve kendi hesapları silinemez1
    İzlemelerfb_trace_start yalnızca şablonlarla: audit-lite, performance, errors1
    firebird.conffb_config_get, fb_config_diff; düzenlemek için — fb_config_set, Firebird yeniden başlatılmaz0 · 2
    Hizmet ve veritabanı değiştirmefb_service_restart; fb_restore_replace, eski dosya .pre-restore olarak kalır2

    Gece yedekleme kontrolü

    Zamanlama, oluşturulduğunda bir kez onaylanır. Bundan sonra bir kişi olmadan çalışır. Her gece doğrulanmış bir yedek alırsınız. Örneğin, bir veritabanını yedekten değiştirmek için buna ihtiyacınız olur.

    1. 1Zamanlamafb_schedule_create, hedef nightly_verify; bir kez onaylanır
    2. 2Yedeklemeyedek klasörüne gbak
    3. 3Test geri yüklemebir çalışma klasörüne; kaynak veritabanına dokunulmaz
    4. 4✓ Yedek doğrulandıyedek kataloğunda bir işaret

    Yedekten veritabanı değiştirme ve seviye 3 işlemleri zamanlanamaz.

    Hazır senaryolar

    Senaryolar asistana adımların sırasını önerir. Değişiklikleri kendisi uygulamaz.

    Sağlık kontrolü Optimizasyon Güvenlik denetimi DDL incelemesi Geçiş planı Felaket hazırlığı Sorgu oluşturucu

    Sorgular · dizinler · geçişler

    Geliştiriciler için

    Cursor veya Claude Code'daki asistan şemanızı bilir, bir sorguyu çalışmadan önce kontrol eder ve sonucu doğrudan sohbette tablo olarak gösterir.

    1. 1Görevihtiyacınız olan şey, tek bir cümleyle
    2. 2Gerçeklerfb_schema_list, fb_describe: yalnızca mevcut tablolar ve sütunlar
    3. 3TaslakORDER BY içeren tek bir SELECT
    4. 4Kontrolfb_query_check: çalıştırmadan derle
    5. 5✓ Sohbette tablofb_query: satırlar, plan ve istatistikler

    Sonuç tablo olarak

    MCP Apps destekleyen istemcilerde fb_query sonucu sıralanabilir bir tablo olarak gösterilir. Diğer istemciler aynı verileri metin olarak alır.

    Varsayılan olarak 100 satır, en fazla 1000. Tablo 30 dakika boyunca bellekte kalır ve yalnızca onu isteyen kişi görebilir. Sıralamak için bir sütun başlığına tıklayın.

    SELECT full_name, dept_no, salary
    FROM employee
    WHERE salary > 60000
    ORDER BY salary DESC
    6 satır · PLAN SORT (EMPLOYEE NATURAL) · salt okunur
    fb_index_advice

    Dizin önerisi

    Tam tablo taramalarını bulur ve CREATE INDEX önerir, sağlayacağı faydayı tahmin eder. Dizini kendisi oluşturmaz: bunu onayla birlikte fb_write yapar. Dizin oluşturulduktan sonra planı yeniden kontrol eder.

    fb_diff_schema · fb_diff_data

    Veritabanı karşılaştırma

    İki veritabanının ya da bir veritabanı ile anlık görüntüsünün şeması: neyin oluşturulacağı, değiştirileceği, kaldırılacağı. Veriler birincil anahtara göre karşılaştırılır; araç büyük bir tabloyu (varsayılan olarak 100.000 satırdan fazla) karşılaştırmaz.

    fb_migration_*

    Migration Framework

    Plan, her ifadenin seviyesini gösterir. Tüm migration'lar tek bir onaydan sonra uygulanır; bir dosya değişirse yeni bir talep gerekir. Geri alma planı, migration'lar uygulanırken kaydedilenlerden oluşturulur.

    fb_write bir betikteki her ifadenin seviyesini bulur. Farklı seviyelerdeki ifadeleri karıştıran bir betik reddedilir.

    fbagent · Yerel API · 127.0.0.1

    fbagent verileri

    fbagent aracısı HQbird sunucusunda zaten çalışıyor. Asistan MCP aracılığıyla aracının topladığı her şeye erişir: sağlık raporu, LWM (Light-weight Monitoring), gstat, trace'ler, deadlock'lar, yedekleme durumu. Ayrıca aracı işlerini çalıştırır ve ayarlarını değiştirir; aynı seviyeler ve onaylar altında.

    NeAraçlarSeviye
    Sunucu sağlık raporufb_agent_status0
    LWM, gstat, veritabanı metrikleri, trace'ler, deadlock'larfb_agent_artifact_get, fb_agent_perf_report0
    Yedekleme, sweep ve geri yükleme ayarlarıfb_agent_backup_config; parolalar ve token'lar gizlenir0
    Aracı işi çalıştırfb_agent_job_run; yedekleme, geri yükleme ve SQL betiği seviye 2'dir1 · 2
    İş ayarını değiştirfb_agent_config_set; kimlik bilgileri, id'ler ve komutlar değiştirilemez2
    Aracı üzerinden Firebird'ü yeniden başlatfb_agent_restart, fb_agent_stop, fb_agent_start2
    Lisans ve güncellemelerfb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply0 · 1 · 2
    • Yalnızca yerelAracı istekleri yalnızca 127.0.0.1 üzerinde kabul eder. Aracı adresi sohbetten değil, MCP sunucusu yapılandırmasından gelir.
    • Token gizli kalırAracı token'ı araç çıktısında veya denetim günlüğünde görünmez.
    • Aracı keşfifb_agent_discover sunucudaki aracıları Windows servisleri veya systemd birimleriyle bulur. Token'ları okumaz.
    • KümeSunucuda bir küme düğümü kuruluysa fb_agent_restart, fb_agent_stop ve fb_agent_start varsayılan olarak reddeder: yeniden başlatmaları düğüm kontrol eder. fb_service_restart bunu kontrol etmez, bu yüzden bir küme düğümünde kullanmayın.

    Çift kontrol. MCP sunucusu talebi onaylar ve aracının kendisi işi kendi kurallarına göre çalıştırır. MCP günlüğü kimin istediğini gösterir; aracı günlükleri nasıl yapıldığını gösterir.

    HQbird Cluster · RCM

    Asistan aracılığıyla replikasyon kümesi

    Asistan bir replikasyon kümesini adım adım kurar: RCM'yi açar, eşleştirme penceresini açar, ana bilgisayarları bağlar, veritabanlarını yönetim altına alır ve replika için bir kopya oluşturur. Aracı ve RCM üzerinden çalışır. Sunuculara SSH ile giriş yapmanız gerekmez.

    Kurallar her yerdekiyle aynıdır. Okumalar onay gerektirmez. Bir değişiklik sohbette onaylanır. Firebird'ün yeniden başlatılması, veritabanının replikaya kopyalanması, bir sunucunun kümeden çıkarılması, switchover, failover ve eski master'ın geri dönüşü sunucuda onaylanır.

    NeAraçlarSeviye
    Sunucudaki küme durumufb_agent_cluster: boş, bir kümede veya RCM sahibi; slot ve portlar0
    RCM'de küme genel görünümüfb_cluster_status: düğümler, veritabanları, komutlar, uyarılar0
    Bağlamadan önce ana bilgisayarları kontrol etfb_cluster_probe: aracı başına bir satır, sertifika parmak izi0
    Master ve replikayı karşılaştırfb_cluster_verify: her tablonun satır sayısı0
    Sunucuda RCM'yi açfb_agent_cluster_rcm1
    Eşleştirme penceresifb_agent_cluster_pairing: durum, 1–24 saat açık, kapat0 · 1
    Ana bilgisayarları bağlafb_cluster_link; talep karşılaştırılacak parmak izlerini gösterir1
    Veritabanları ve yayınfb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication1
    RCM parolasıfb_cluster_rcm_password: yeni rastgele parola, sohbette gösterilmez1
    Veritabanının replikaya kopyalanmasıfb_cluster_reinit2
    Bir düğümün Firebird'ünü yeniden başlatfb_cluster_firebird_restart2
    Bir sunucuyu kümeden çıkarfb_cluster_unlink2
    Servisler: master neredefb_cluster_service: master, replikalar, yönlendiriciler, sorunlar, çalışan işlem0
    Bir servisi ve kuralını tanımlafb_cluster_service_put, fb_cluster_service_policy: servis açıklaması, otomatik failover kuralı1
    Bir işlemi sürdür ve iptal etfb_cluster_resume, fb_cluster_operation_cancel; yalnızca geri dönüşü olmayan noktadan önce iptal et1
    Switchoverfb_cluster_switchover: master'ın planlı taşınması, işlemin bitmesini bekler2
    Failoverfb_cluster_failover: yalnızca veri kaybına açık rıza ile2
    Eski master'ı geri getirfb_cluster_rejoin2
    Bir servisi silfb_cluster_service_delete: yalnızca RCM'deki kayıt silinir2
    • Hazır senaryo“Küme kur”: asistan adım adım ilerler ve her adımda ne yapacağını gösterir.
    • Parmak izleriBağlamadan önce asistan her sunucunun sertifika parmak izini gösterir. Bunu kurulum özetindeki satırla karşılaştırın.
    • Deneme çalıştırmasıVeritabanları içeren bir klasörü yönetim altına almadan önce asistan RCM'nin hangi veritabanlarını bulacağını gösterir.
    • Switchover ve failoverAsistan master'ın taşınmasını başlatır ve işlemin adımlarını izler. Başlatmayı sunucudaki bir kişi onaylar. Failover ayrıca veri kaybına açık rıza gerektirir. Küme sayfasında daha fazlası.

    HTTPS · API anahtarları · denetim

    Uzak mod, kurulum ve denetim günlüğü

    Asistan yöneticinin bilgisayarında, MCP sunucusu ise veritabanı sunucusunda çalışır. Aralarında HTTPS ve bir API anahtarı vardır. Her kişinin kendi anahtarı ve kendi maksimum seviyesi vardır.

    MCP istemcisi ve fbmcp köprüsü olan yönetici bilgisayarı, güvenlik duvarı üzerinden HTTPS ile fbmcp servisine; fbmcp Firebird ve fbagent ile konuşur; sunucudaki bir kişi tehlikeli talepleri onaylar
    Uzak mod. Bilgisayardaki köprü anahtarı işletim sistemi anahtar deposundan alır ve sunucu sertifikasını pin ile doğrular. Parolalar ve veritabanı yolları sohbete ulaşmaz: veritabanları id ile adlandırılır.
    • Her kişi için bir anahtarfbmcp ctl apikey new <name> --max-tier 2. Değer bir kez gösterilir. Bir anahtar değiştikten sonra eski anahtar birkaç saniye içinde çalışmayı durdurur.
    • LimitlerAnahtar başına: eşzamanlı çağrılar, dakika başına çağrılar, açık oturumlar. Limitin üzerinde yanıt 429'dur.
    • Portekizce kılavuzKurulum ve kullanım için tam kılavuz Brezilya Portekizcesi olarak da mevcuttur.
    • Otonom aracılarautonomous profili: varsayılan olarak yalnızca okuma. Bir değişiklik sunucudaki bir operatörü bekler; aracıdan gelen fb_confirm reddedilir. Dakikada 10 çağrı. Bu tür aracıları şirket ağı içinde çalıştırın.
    • AdreslerBir anahtar adreslere bağlanabilir (allow_from). Başka bir adres 403 ve günlüğe bir kayıt alır.

    HQbird'de kurulum

    HQbird yükleyicisi MCP sunucusunu varsayılan olarak kurar. Tek bir sunucu makinedeki tüm Firebird hatlarına hizmet eder. Tek bir komut her şeyi ayarlar ve komutu yeniden çalıştırabilirsiniz.

    1. 1HQbird yükleyicisiWindows veya Linux
    2. 2fbmcp ctl hqbird-installtek komut, elle YAML düzenlemesi yok
    3. 3Firebird hatlarıher hattı ve aracısını bulur
    4. 4Veritabanlarıdatabases.conf takma adları ve son bağlanan veritabanları
    5. 5✓ Servisistemciler için start, check, connect.txt dosyası

    Uzak mod üç koşul sağlandığında etkinleşir: bir yönetici adresleri listesi ayarlanmış (--allow-from), güvenlik duvarı çalışıyor ve en az bir API anahtarı mevcut. Anahtarı ayrıca oluşturursunuz. Ardından fbmcp ctl hqbird-install komutunu tekrar çalıştırın. Varsayılan port 8650'dir.

    audit.jsonl

    Hash zinciri

    Her karar (izin verildi, beklemede, onaylandı, reddedildi) günlüğe yazılır. Her giriş bir öncekine bağlanır. Bir zincir kontrolü, bir girişin değiştirilip değiştirilmediğini veya silinip silinmediğini gösterir.

    Hata — durdur

    Günlük kesildi — sunucu kapalı kalır

    Günlük kesilmişse veya sonu kontrol girişiyle eşleşmiyorsa, MCP sunucusu başlamaz. Bu bir kurcalama işaretidir ve araştırmanız gerekir. fbmcp ctl verify komutu tüm zinciri kontrol eder.

    Güncelleme

    Aracı üzerinden

    fbagent, MCP sunucusunu günceller: durdur, değiştir, başlat, kontrol et, hata durumunda geri al. Linux'ta imzasız bir derleme kurulmaz. Yapılandırma ve anahtarlar değişmez.

    ← HQbird 2027 genel bakışına dön