Přeskočit obsah

Server MCP

BombVault má vestavěný server pro Model Context Protocol (MCP), protokol, kterým AI asistenti jako Claude Code a Claude Desktop sahají po vnějších nástrojích. Přes něj může asistent číst, jak jsou na tom tvoje zálohy, a pokud to povolíš, spustit zálohu nebo zrušit tu, kterou sám spustil. Je vypnutý, dokud nevytvoříš klíč nebo nezapneš přihlášení přes OAuth: do té doby koncový bod /mcp odpovídá na všechno 404.

Co asistent smí a co ne

Nástroj Co dělá Druh
get_health Verze, název instance, zda běží záloha a co tento klíč smí čtení
get_status Stav ochrany podle sekcí: poslední úspěšná záloha, očekávaný interval, ověření a kontroly off-site, další naplánované běhy, zálohy čekající na klid aplikace, u kontejnerů nejnovější test spuštění čtení
get_coverage Co BombVault chrání a co ne, u každé položky s důvodem čtení
list_items Každý chráněný kontejner, VM a sada složek, flash disk a konfigurace aplikace, s plánem, tím, co záloha zastaví, poslední zálohou a její délkou. Databázové kontejnery uvádějí i poslední dump. Uvádí i datasety ZFS s výsledkem jejich poslední kontroly. Každá položka nese svou poslední kontrolu obnovy, kontejner navíc svůj poslední test spuštění nebo důvod, proč ho nelze otestovat. Kontejner znovu vytvořený s jiným nastavením od poslední zálohy uvádí, co se změnilo čtení
list_runs Historie běhů od nejnovějších, filtrovatelná podle sekce, položky, stavu, druhu a času. Pomalá záloha, kterou brzdila jedna věc, ji jmenuje čtení
list_restore_points Body obnovy jedné položky z jejího primárního repozitáře a u kontejneru i jeho databázové dumpy. Dataset ZFS má jeden bod obnovy na zálohu se snapshotem každého datasetu pod ním čtení
get_activity Co právě běží, s fází a procenty čtení
get_storage_stats Historie velikosti primárního repozitáře sekce a její týdenní růst, k tomu obsazené, volné a celkové místo na disku nebo vzdáleném úložišti každého jejího repozitáře čtení
get_size_breakdown Které složky a soubory zabírají místo v nejnovější záloze kontejneru, VM nebo sady složek a kolik z nich přidala poslední záloha čtení
search_files Hledá soubory a složky podle názvu v zálohách všech položek, jedné sekce nebo jedné položky (VM se neprohledávají) a ke každému nálezu vypíše všechny zálohy, které ho obsahují čtení
list_anomalies Anomálie, kterých si BombVault všiml v zálohách, lze filtrovat podle stavu, závažnosti a sekce, se souhrnem toho, co je otevřené čtení
get_anomaly Jedno z těchto zjištění s poznámkou, která zůstala při jeho potvrzení čtení
start_backup Hned zazálohuje jednu položku spuštění
start_domain_backup Zazálohuje každou chráněnou položku jedné sekce spuštění
start_backup_everything Spustí Zálohu všeho spuštění
cancel_backup Zruší běžící zálohu, kterou spustil tento klíč zrušení

Ve webovém rozhraní zůstává: obnova jakéhokoli druhu (včetně stažení, uložení nebo importu databázového dumpu), mazání záloh, prune, unlock, kontroly a cvičení, replikace off-site, nastavení, přihlašovací údaje a klíče MCP a také zrušení zálohy, kterou spustil plán, webové rozhraní nebo jiný klíč. Totéž platí pro potvrzení anomálie nebo její označení jako očekávané, což se dělá na stránce Anomálie. Důvod: odpovědi nástrojů obsahují názvy a chybové zprávy z tvého serveru a kterákoli z nich může nést text napsaný tak, aby asistenta ovládl. Asistent, který na takový text naletí, může nanejvýš spustit zálohu v mezích uvedených níže nebo zrušit zálohu, kterou sám spustil.

Pokud je primární repozitář položky vzdálený (S3, REST, SFTP, rclone), list_restore_points se k němu připojí a volání může chvíli trvat. Kopie off-site přes MCP vypsat nelze. search_files čte vzdálené repozitáře, mezi nimi i kopie off-site, jen když o to asistent požádá, protože to trvá déle a někteří poskytovatelé si účtují stažená data. Hledání může trvat i minuty, proto ho první volání spustí na pozadí a výsledek si vyzvedne pozdější volání. Na co se kontroly anomálií dívají, popisuje stránka Anomálie, a jak položka ZFS drží jeden snímek pro každou datovou sadu, stránka Datové sady ZFS.

Co spuštěná záloha dělá

Záloha spuštěná asistentem je stejná záloha, jakou spouští webové rozhraní. Běžící kontejner se zastaví, dokud jeho záloha neskončí, spolu s kontejnery nastavenými k zastavení s ním. VM s metodou "graceful" se vypne a znovu spustí. Dataset ZFS zastaví kontejnery, které jsou pro něj nastavené, po dobu pořizování svého snapshotu. Sady složek, flash disk a konfigurace běží dál. Poté BombVault použije zásady uchovávání a případně zkopíruje data do repozitáře off-site. list_items asistentovi řekne, co položka zastaví a jak dlouho trvala její poslední záloha, a popisy nástrojů ho žádají, aby ti to řekl dřív, než cokoli spustí.

Protože záloha zastavuje služby a vytlačuje staré body obnovy, jsou spuštění přes MCP omezená:

  • 12 spuštěných záloh za hodinu na klíč.
  • 15 minut mezi dvěma spuštěními přes MCP u téže položky, téže sekce nebo Zálohy všeho.
  • Nejvýše 4 spuštění téže položky přes MCP za 24 hodin.
  • Ochrana uchovávání. Když sekce uchovává pevný počet bodů obnovy (jen "ponechat posledních N", bez denního, týdenního či měsíčního pravidla, lokálně nebo v cíli off-site), každá nová záloha vytlačí tu nejstarší. BombVault pak odmítne spuštění položky přes MCP, pokud jejích nejnovějších N-1 úspěšných záloh spustilo MCP. V uchovávané sadě tak vždy zůstane alespoň jeden bod obnovy, který vytvořil plán nebo ty. Při nastavení "ponechat poslední 1" nemůže asistent tuto položku zálohovat vůbec. Další naplánovaná záloha zase udělá místo. Samotné roční pravidlo se počítá jako "ponechat poslední 1", protože pro aktuální rok ponechá jen jeden bod obnovení.

Spuštění sekce nebo Zálohy všeho vynechá položky, které nějaký limit zadrží, a vyjmenuje je v odpovědi. Webové rozhraní ani plán se žádného z těchto limitů netýkají. Hodinový rozpočet je jen v paměti, takže restart BombVaultu ho vynuluje.

Spuštění přes API a z Home Assistant se u limitů na položku i u ochrany uchovávání počítají spolu se spuštěními přes MCP.

Zapnutí

  1. Otevři Nastavení, Integrace, Server MCP, klikni na Vybrat klienta a v okně vyber svého. Vyhledávání vpravo nahoře ho najde podle názvu. Klient, který v seznamu není, se připojí přes Jiný klient.
  2. V části Klíč nech Nový klíč a navržený název, tedy název klienta, nebo napiš takový, který říká, kde se klíč používá, například „Claude Code na notebooku“. Jeden klíč na klienta ti dovolí jeden odvolat, aniž bys sahal na ostatní. Existující klíč dá klientovi klíč, který jsi vytvořil dřív.
  3. Zapni Povolit spouštění záloh u klíče, který má moci spouštět zálohy. Bez toho může jen číst. Později to můžeš změnit v Podrobnostech klíče a změna platí od dalšího požadavku asistenta, bez nového připojení.
  4. Klikni na Vytvořit klíč. Klíč se zobrazí jen jednou. BombVault si nechává jen jeho otisk a znovu ho ukázat nedokáže, takže si ho hned zkopíruj. Když zavřeš okno dřív, než klient klíč použije, karta ho dál ukazuje, dokud nepotvrdíš, že sis ho zkopíroval.

Bez přihlašovacího hesla je samotné webové rozhraní otevřené všem ve tvé síti a kdo ho otevře, může také vytvořit klíč. Karta na to upozorňuje. Pokud BombVault otevři pod názvem, který vypadá veřejně (například bombvault.example.com za reverzní proxy), a přihlašovací heslo nastavené není, nelze z této adresy klíče vytvářet ani nahrazovat, aby žádná webová stránka na internetu nemohla přimět tvůj prohlížeč, aby nějaký vytvořil. Nastav přihlašovací heslo, nebo otevři BombVault přes jeho IP adresu či místní název jako tower nebo tower.local.

Tvoje klíče a jejich protokol

Každý klíč má vlastní řádek pod Klíče a přihlášení klienti. Ukazuje název klíče, zda smí spouštět zálohy, nebo jen čte, poslední čtyři znaky klíče, kdy byl vytvořen nebo naposledy nahrazen a kdy ho klient naposledy použil. Podrobnosti otevřou okno, ve kterém klíč přejmenuješ, změníš jeho oprávnění, nahradíš ho nebo zneplatníš a které ukazuje, kolik volání dnes udělal. Zneplatněný klíč se přesune do seznamu zneplatněných klíčů, kde ho můžeš natrvalo smazat, jakmile ho už žádný běh v historii neuvádí.

Vedle názvu ukazuje řádek logo klienta, pro kterého byl klíč vytvořen. Klíč vytvořený přes Jiný klient, nebo dřív, než karta klienty vypisovala, ukazuje místo toho klíč.

Protokol v podrobnostech klíče ukazuje, co tento klíč dělal, a zneplatněný klíč si nechává vlastní tlačítko Protokol. Nahoře jsou zálohy, které spustil, každá se svým stavem a odkazem na daný běh v protokolu aktivit na přehledu. Pod nimi jsou jeho volání, od nejnovějšího, s nástrojem a výsledkem. Odmítnutí uvádí důvod: klíč smí jen číst, ochrana uchovávání zálohu zadržela, už běžela jiná záloha, zálohování položky bylo před několika minutami spuštěno mimo webové rozhraní, nebo klíč poslal příliš mnoho požadavků. Zrušení odkazuje na běh, o který šlo.

BombVault uchovává záznamy každého klíče nejvýše 30 dní: nejnovějších 500 úspěšných spuštění a zrušení a vedle nich nejnovějších 200 ostatních volání (čtení, odmítnutí a chyby), takže asistent, který se opakovaně ptá na běžící zálohu nebo znovu zkouší odmítnuté volání, nemůže z protokolu vytlačit její spuštění. U každého volání ukládá nástroj, výsledek a u zrušení daný běh. Nikdy neukládá, co asistent poslal, ani klíč či jeho otisk. Diagnostický balíček záznamy jen počítá a export nastavení je vynechává.

Připojení klienta

Vybrat klienta otevře okno s každým klientem jako dlaždicí, ve skupině Na tomto počítači nebo V cloudu, a s vyhledáváním vpravo nahoře. Dlaždice otevře nastavení klienta ve stejném okně ve třech krocích: klíč, konfigurace pro daného klienta s adresou, na které jsi kartu otevřel, tlačítkem pro kopírování, místem, kde konfigurace leží, a u vlastního certifikátu BombVaultu i tím, co klient potřebuje, aby mu důvěřoval. A čekání na první volání klienta. Okno sleduje poslední použití klíče a zezelená, jakmile to volání přijde.

Nastavení drží klíč mimo každý příkazový řádek. Kde klient umí klíč číst z proměnné prostředí (BOMBVAULT_MCP_KEY), ze skrytého dotazu nebo z vlastního souboru, konfigurace ho jen jmenuje. Kde klient takovou možnost nemá, leží klíč v jeho konfiguračním souboru nebo nastavení a nastavení to řekne. Kde dokumentace klienta neříká, jak zachází s neznámým certifikátem, popíše nastavení tento krok jako to, co udělat, když klient certifikát BombVaultu odmítne.

Klient Nastavení Odkud klíč pochází
AnythingLLM konfigurační soubor konfigurační soubor
Antigravity konfigurační soubor proměnná prostředí
Claude Code příkaz soubor s klíčem
Claude Desktop konfigurační soubor soubor s klíčem
Cline konfigurační soubor konfigurační soubor
Codex CLI konfigurační soubor proměnná prostředí
Continue konfigurační soubor ~/.continue/.env
Copilot CLI konfigurační soubor konfigurační soubor
Cursor konfigurační soubor proměnná prostředí
Gemini CLI konfigurační soubor proměnná prostředí
GitHub Copilot (VS Code) konfigurační soubor skrytý dotaz
Goose konfigurační soubor proměnná prostředí
Jan formulář v aplikaci nastavení aplikace
JetBrains (AI Assistant, Junie) konfigurační soubor konfigurační soubor
Kimi Code konfigurační soubor konfigurační soubor
LM Studio konfigurační soubor konfigurační soubor
Mistral Vibe konfigurační soubor proměnná prostředí
Msty formulář v aplikaci nastavení aplikace
n8n formulář v aplikaci přihlašovací údaje v n8n
Open WebUI formulář v aplikaci nastavení aplikace
opencode konfigurační soubor proměnná prostředí
Perplexity (Mac) formulář v aplikaci soubor s klíčem
Qwen Code konfigurační soubor proměnná prostředí
Roo Code konfigurační soubor proměnná prostředí
Visual Studio konfigurační soubor konfigurační soubor
Warp konfigurační soubor konfigurační soubor
Windsurf konfigurační soubor proměnná prostředí
Zed konfigurační soubor konfigurační soubor
Grok formulář, v cloudu servery poskytovatele
Le Chat formulář, v cloudu servery poskytovatele
ChatGPT přihlášení přes OAuth, v cloudu přístupový token, viz níže
Claude (claude.ai) přihlášení přes OAuth, v cloudu přístupový token, viz níže

Oddíly níže podrobněji vysvětlují nastavení Claude Code a Claude Desktop a uvádějí, co potřebuje každý jiný klient.

Claude Code

Claude Code se k BombVaultu dostane přes mcp-remote, který na daném počítači potřebuje Node.js. Nejdřív ulož klíč do samostatného textového souboru, na jeden řádek:

X-API-Key: <your key>

Pak příkaz z karty jednou spusť v terminálu, s doplněnou cestou k tomuto souboru. Za certifikátem, kterému tvůj počítač důvěřuje, vypadá takto:

claude mcp add bombvault --scope user -- npx -y mcp-remote@latest https://bombvault.example.com/mcp --header-file "<path of the file with your key>"

S vlastním certifikátem BombVaultu (viz TLS a certifikáty) příkaz navíc nasměruje Node.js na stažený certifikát:

claude mcp add bombvault --scope user -e "NODE_EXTRA_CA_CERTS=<path of the downloaded bombvault-cert.pem>" -- npx -y mcp-remote@latest https://192.168.1.10:3443/mcp --header-file "<path of the file with your key>"

Připojení ověříš příkazem /mcp v Claude Code. --scope user zpřístupní BombVault ve všech tvých projektech. Claude Code si pamatuje jen cestu k souboru s klíčem, takže se klíč neobjeví v příkazu ani v historii shellu, ani v seznamu procesů. Soubor měj tam, kde ho můžeš číst jen ty, a mimo každou složku, kterou commituješ. Díky @latest si npx stáhne aktuální mcp-remote. Jinak by se použil starší, globálně nainstalovaný, který --header-file nezná.

Nepiš ${BOMBVAULT_MCP_KEY} do argumentů mcp-remote pro Claude Code. Claude Code takový odkaz dosadí ze svého vlastního prostředí ještě před spuštěním mcp-remote, takže klíč skončí v příkazovém řádku tohoto procesu, kde ho mohou číst jiné programy a uživatelé počítače.

Bez Node.js se Claude Code umí připojit sám, ale jen za certifikátem, kterému tvůj počítač důvěřuje. Do složky projektu dej soubor .mcp.json:

{
  "mcpServers": {
    "bombvault": {
      "type": "http",
      "url": "https://bombvault.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BOMBVAULT_MCP_KEY}"
      }
    }
  }
}

Proměnnou BOMBVAULT_MCP_KEY nastav tam, kde se Claude Code spouští, například pod "env" v ~/.claude/settings.json nebo v profilu shellu, a to v textovém editoru, ne napsáním do příkazového řádku. Tady je odkaz bezpečný, protože Claude Code nespouští žádný druhý proces, který by ho nesl. S vlastním certifikátem BombVaultu to takto nefunguje: připojení, které Claude Code navazuje sám, ho odmítne i s nastavenou NODE_EXTRA_CA_CERTS. Nikdy necommituj .mcp.json, ve kterém je klíč vypsaný.

Claude Desktop

Claude Desktop se k BombVaultu dostane přes mcp-remote, který na daném počítači potřebuje Node.js. Nejdřív ulož klíč do samostatného textového souboru jako jediný řádek, jak je popsáno u Claude Code. Konfigurační soubor otevři v Claude Desktop přes Settings, Developer, Edit Config. Ve Windows je v %APPDATA%\Claude\claude_desktop_config.json, v macOS v ~/Library/Application Support/Claude/claude_desktop_config.json. Položku z karty přidej do "mcpServers" vedle serverů, které tam už jsou, a Claude Desktop restartuj:

{
  "mcpServers": {
    "bombvault": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://192.168.1.10:3443/mcp", "--header-file", "<path of the file with your key>"],
      "env": {
        "NODE_EXTRA_CA_CERTS": "<path of the downloaded bombvault-cert.pem>"
      }
    }
  }
}
  • NODE_EXTRA_CA_CERTS je tam jen kvůli vlastnímu certifikátu BombVaultu. Za certifikátem, kterému tvůj počítač už důvěřuje, ho vynech.
  • --allow-http se přidává jen u prosté adresy http://.
  • Ve Windows piš cesty s obyčejnými lomítky, například C:/Users/sam/bombvault-key.txt, protože samotné zpětné lomítko není platný JSON. Cesta k souboru s klíčem nesmí obsahovat mezery: Claude Desktop ve Windows předá cestu s mezerou programu npx ve dvou kusech.
  • Konfigurace uvádí jen soubor s klíčem, takže se klíč neobjeví ani v ní, ani v seznamu procesů. Soubor měj tam, kde ho můžeš číst jen ty.

Klienti v cloudu

ChatGPT, Claude na claude.ai, Grok a Le Chat volají BombVault ze serverů svého poskytovatele, takže BombVault musí být dostupný z internetu s veřejně důvěryhodným certifikátem, například za reverzní proxy. Le Chat odmítá certifikáty podepsané sebou samým. Přihlášení na proxy smí chránit webové rozhraní, ale /mcp musí k BombVault projít bez něj: tyto služby se k proxy přihlásit neumějí a BombVault kontroluje jejich klíč nebo token sám. Grok a Le Chat posílají pevný klíč a jejich tlačítka je nastaví jako ostatní. ChatGPT a ve většině organizací i Claude na claude.ai se připojují jen přihlášením přes OAuth, popsaným dál.

Přihlášení přes OAuth

Pro klienta, který neumí převzít klíč, je BombVault jeho vlastním autorizačním serverem OAuth. Klient se sám zaregistruje, pošle tě na stránku BombVault a tam se přihlásíš svým přihlašovacím heslem (a druhým faktorem, pokud ho máš nastavený) a povolíš ho. Klient pak dostane token, který platí jen pro koncový bod MCP tohoto BombVault, a sám si ho obnovuje.

  1. Nastav přihlašovací heslo v Nastavení, Zabezpečení. Bez něj BombVault žádné přihlášení nenabízí, protože by nebylo koho požádat o souhlas.
  2. Zpřístupni BombVault z internetu přes https s certifikátem, kterému prohlížeče věří, obvykle přes reverzní proxy. Klient volá /mcp, /oauth/ a /.well-known/ ze svých vlastních serverů, takže proxy s vlastním přihlášením musí tyto tři cesty pustit až k BombVault. Stránka se souhlasem na /oauth/authorize se otevírá ve tvém vlastním prohlížeči a smí zůstat za přihlášením proxy. Uveď proxy také v TRUSTED_PROXY (viz Konfigurace). BombVault omezuje registrace klientů podle adresy a bez toho se zdá, že každý klient přichází z proxy.
  3. Na kartě MCP zapni Přihlášení přes OAuth a zadej Veřejná adresa: adresu https bez cesty, například https://backup.example.com. Každý token je na tuto adresu vázaný, takže po změně se musí každý klient přihlásit znovu.
  4. Vyber ChatGPT nebo Claude pod Vybrat klienta. Okno ukáže URL konektoru, tedy veřejnou adresu s /mcp na konci, a kam v daném klientovi patří. V ChatGPT zapneš vývojářský režim v Nastavení, Aplikace a konektory, Pokročilé nastavení, zvolíš Vytvořit, vložíš URL konektoru jako URL MCP serveru a jako ověřování zvolíš OAuth. Na claude.ai otevřeš Nastavení, Konektory, Přidat vlastní konektor, vložíš URL konektoru, ID klienta a tajný klíč OAuth necháš prázdné a zvolíš Připojit.
  5. Klient otevře stránku se souhlasem. Ukazuje, kdo žádá, kam tě tvoje odpověď vrátí, a přepínač Povolit spouštění záloh, který je na začátku vypnutý. Zvol Povolit nebo Odmítnout.

Každý přihlášený klient dostane vlastní řádek ve stejném seznamu, se svou značkou. Jeho Podrobnosti drží jeho protokol, Zneplatnit a Povolit spouštění záloh a platí pro něj stejné limity jako pro klíč. Zneplatnění platí okamžitě. Když se stejný klient přihlásí znovu, jeho nové povolení nahradí to staré, a povolení, které 30 dní nikdo nepoužil, vyprší. Najednou může být přihlášeno až 10 klientů, navíc k 10 klíčům.

Stránka se souhlasem přijme požadavek jen od registrovaného klienta, který uvede přesně jednu ze svých registrovaných návratových adres: https, nebo adresu loopback s libovolným portem pro klienta na tvém vlastním počítači. Přijímá se jen tok autorizačního kódu s PKCE (S256) a tvoje odpověď je vázaná na tvou relaci, takže žádný jiný web ji za tebe odeslat nemůže. Přístupové tokeny platí hodinu. Obnovovací token se při každém použití nahradí, a pokud se některý potom objeví znovu, BombVault povolení zruší, protože kopii má někdo jiný. Klient, který do 30 sekund zopakuje svou poslední obnovu, protože k němu odpověď nedorazila, dostane místo toho nové tokeny. BombVault nestahuje metadata klientů z internetu, takže se klienti registrují přes dynamickou registraci klientů.

Ostatní klienti

Funguje každý klient, který umí Streamable HTTP:

  • URL: adresa webového rozhraní plus /mcp, například https://192.168.1.10:3443/mcp.
  • Klíč v Authorization: Bearer <key> nebo v X-API-Key: <key>. Pokud přijdou obě hlavičky, musí nést stejný klíč.
  • POST s Content-Type: application/json a Accept: application/json, text/event-stream.
  • Jedna zpráva JSON-RPC na požadavek. Dávky (batch) se odmítají.
  • Verze protokolu 2026-07-28, 2025-11-25, 2025-06-18 a 2025-03-26.

TLS a certifikáty

BombVault poskytuje HTTPS s certifikátem, který si vydal sám, a ten zpočátku uvádí jen localhost, 127.0.0.1 a ::1. Claude Code a mcp-remote ho na adrese v místní síti odmítnou. Cesty kolem toho, v pořadí, které vyhovuje většině instalací Unraid:

  1. Přidat adresu v kartě MCP. Když kartu otevři přes HTTPS na adrese, kterou certifikát neuvádí, karta to řekne a nabídne Přidat tuto adresu do certifikátu. BombVault pak certifikát vydá znovu i s touto adresou (prohlížeč jednou znovu varuje, stejně jako poprvé). Potom klikni na Stáhnout certifikát. Úryvky nastaví NODE_EXTRA_CA_CERTS na stažený soubor, takže klient důvěřuje právě tomuto certifikátu. Znamená to také, že každý klient nastavený s dříve staženým souborem se přestane připojovat, jakmile je certifikát vydán znovu, na tomto počítači i na všech ostatních, dokud nedostane nový soubor.
  2. Reverzní proxy s důvěryhodným certifikátem (Nginx Proxy Manager, SWAG, Caddy, Traefik). Klient pak vidí certifikát proxy a nic dalšího nepotřebuje a karta na certifikát BombVaultu neupozorňuje.
  3. Tailscale. tailscale serve před kontejnerem nebo integrace Tailscale v Unraidu ti dá název ts.net s důvěryhodným certifikátem.
  4. HTTP_ONLY=true, jen za proxy, která ukončuje TLS, nebo v síti, které plně důvěřuješ. Přepne celé webové rozhraní na prosté HTTP, vyžaduje změnu nastavení kontejneru a posílá klíč nešifrovaně.

Nikdy nenastavuj NODE_TLS_REJECT_UNAUTHORIZED=0. Vypne to kontrolu certifikátů pro všechno, s čím daný proces Node.js komunikuje.

Reverzní proxy musí hlavičku Authorization (nebo X-API-Key) předat dál, což proxy dělají, pokud jim neřekneš jinak, a nesmí /mcp bufferovat ani přepisovat. Blok location pro Nginx nebo Nginx Proxy Manager, který zároveň ověřuje certifikát BombVaultu:

location /mcp {
    proxy_pass https://192.168.1.10:3443;
    proxy_ssl_verify on;
    proxy_ssl_trusted_certificate /data/bombvault-cert.pem;
    proxy_ssl_name localhost;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_set_header Host $host;
}

Za proxy nese každý požadavek adresu proxy. Pět špatných klíčů od jediného špatně nastaveného klienta pak na minutu zablokuje všechny klienty MCP za touto proxy. Uveď proxy v TRUSTED_PROXY (viz Konfigurace), aby se počítalo po klientech.

Bezpečnostní model

  • Bez aktivního klíče a s vypnutým přihlášením přes OAuth odpovídá /mcp 404.
  • Přihlášení přes OAuth se nabízí jen, dokud je nastavené přihlašovací heslo. Tokeny, kódy a tajné klíče klientů se ukládají jen jako otisk a token platí jen pro adresu, pro kterou byl vydán.
  • Klient se z jedné adresy může zaregistrovat nejvýš 10krát za hodinu a BombVault drží nejvýš 100 registrovaných klientů, se kterými se nikdo nepřihlásil, každého jeden den. Špatné kódy a obnovovací tokeny se počítají do stejného blokování jako špatné klíče.
  • Povolení se při obnovení autozálohy nebo změně APP_KEY chovají jako klíče: po obnovení se musí každý klient přihlásit znovu.
  • Žádná adresa nemá výjimku. Požadavky z localhost, z hostitele Unraid, z reverzní proxy nebo z tailscale serve potřebují klíč jako všechny ostatní, i když webové rozhraní nemá přihlašovací heslo.
  • Klíče se ukládají jen jako otisky, zobrazí se jednou a lze je přejmenovat, nahradit a odvolat. Až 10 aktivních klíčů, každý s vlastním přepínačem Povolit spouštění záloh.
  • Každé vytvoření, nahrazení, změna oprávnění a odvolání odešle oznámení tvými kanály oznámení i s adresou, odkud přišlo, pokud oznámení nemáš vypnutá.
  • 5 špatných klíčů za minutu na adresu, pak 429. 120 požadavků za minutu a 12 spuštěných záloh za hodinu na klíč, k tomu výše popsaná čekací doba a ochrana uchovávání.
  • Požadavky ze stránky prohlížeče s jiným originem se odmítají.
  • Dokud není nastavené přihlašovací heslo, nelze vytvářet klíče z názvu hostitele, který vypadá veřejně.
  • Každá záloha, kterou spustí asistent, a z ní plynoucí běhy prune a off-site jsou označené "přes MCP" s názvem klíče v protokolu aktivit, v panelu chyb a v oznámení o záloze.
  • Každé volání nástroje se zapíše do logu kontejneru s id klíče a jeho posledními čtyřmi znaky (nikdy s názvem) a započítá se v /metrics (bombvault_mcp_requests_total, bombvault_mcp_tool_calls_total, bombvault_mcp_active_keys).
  • Obnova autozálohy odvolá všechny klíče, protože obnovená databáze může obsahovat klíče, které jsi odvolal až po jejím uložení. Potom vytvoř nové.
  • Klíč přestane fungovat, když se změní APP_KEY (reinstalace nebo obnova do jiného kontejneru). Karta to pozná a klíč označí a Nahradit klíč mu dá znovu platné tajemství.
  • Zacházej s klíčem jako s heslem. Klient, který neumí číst klíč z proměnné prostředí, z dotazu ani ze souboru s klíčem, ho má jako prostý text v konfiguraci nebo nastavení a jeho nastavení to řekne. Na počítači, kterému věříš méně, použij raději klíč jen pro čtení.

Co opouští stroj

Vše, co asistent přečte, odchází k poskytovateli umělé inteligence za ním: názvy položek, plány, historie běhů s chybovými zprávami, id a časy bodů obnovy, názvy databázových strojů a velikosti dumpů, probíhající činnost, údaje o úložišti, pokrytí a stav. Hledání souborů navíc posílá nalezené soubory: jejich názvy, velikosti a cesty uvnitř zálohy. BombVault odstraní cesty hostitele, umístění repozitářů, názvy hostitelů, přihlašovací údaje, příkazy hooků a klíče dřív, než cokoli odejde.

Řešení potíží

Co vidíš Co to znamená
404 Žádný aktivní klíč a přihlášení přes OAuth je vypnuté, nebo špatná cesta jako /api/mcp. Koncový bod je /mcp.
401 Klíč chybí, je překlepnutý, odvolaný nebo nahrazený. Možná proxy zahazuje hlavičku Authorization (zkus X-API-Key). Pokud karta označí klíč jako už neplatný, změnil se APP_KEY: klíč nahraď.
403 Požadavek přišel ze stránky prohlížeče s jiným originem. Použij desktopového klienta nebo klienta pro příkazový řádek.
405 u GET Normální. Koncový bod přijímá jen POST.
400 "Accept must contain both 'application/json' and 'text/event-stream'" Klient je na Streamable HTTP příliš starý. Aktualizuj ho.
400 "batch requests are not accepted" Klient posílá dávky JSON-RPC. Posílej jednu zprávu na požadavek.
429 Příliš mnoho špatných klíčů z této adresy, nebo víc než 120 požadavků za minutu s jedním klíčem. Minutu počkej a zkontroluj, zda asistent neuvízl ve smyčce.
Chyby s "certificate", "self-signed" nebo "unable to verify" Klient nedůvěřuje certifikátu BombVaultu. Viz TLS a certifikáty.
busy Sekci zabírá jiná záloha nebo úloha údržby. Zkus to znovu, až skončí.
cooldown Tato položka, tato sekce nebo Záloha všeho byla spuštěna mimo webové rozhraní před méně než 15 minutami.
retention_guard Další záloha přes MCP by v okně "ponechat posledních N" nechala jen body obnovy z MCP, nebo položka už za posledních 24 hodin dostala 4 zálohy přes MCP, včetně neúspěšných a zrušených. V prvním případě udělá místo další naplánovaná záloha, ve druhém je položka znovu volná 24 hodin po nejstarší z těchto záloh. Ve webovém rozhraní ji můžeš spustit kdykoli.
rate_limited Klíč vyčerpal svých 12 spuštění pro tuto hodinu.
not_permitted při spuštění Klíč smí jen číst. Zapni v kartě Povolit spouštění záloh. Nové připojení není potřeba. U zrušení to znamená, že běh nespustil tento klíč.
domain_off Tato sekce je vypnutá v Nastavení, Obecné.
not_found BombVault tuto položku nechrání. Nejdřív ji přidej ve webovém rozhraní. MCP nikdy nevytváří konfiguraci.
Klient nenajde autorizační server Přihlášení přes OAuth je vypnuté, není nastavené přihlašovací heslo, nebo proxy nepouští /.well-known/ k BombVault.
Stránka se souhlasem hlásí neregistrovanou návratovou adresu Klient poslal návratovou adresu, kterou nezaregistroval. Odeber konektor v klientovi a přidej ho znovu.
Přihlášený klient dostává 401 Jeho povolení bylo zneplatněno, vypršelo po 30 dnech bez použití, nebo se změnila veřejná adresa. Klient se přihlásí znovu.

Nenastavuj na kontejneru proměnnou prostředí MCPGODEBUG. Mění chování knihovny MCP a chybná hodnota zastaví BombVault při startu dřív, než zapíše jediný řádek logu.