MCP server přidáte do Hermes Agent přes hermes mcp add nebo do sekce mcp_servers v konfiguraci. Podstatná část práce ale začíná až potom: určit, jaká data smí spojení opustit, které nástroje má model vidět a podle čeho poznáte, že omezení opravdu platí. Ukážeme si to na veřejné znalostní službě Agent Wikis, bez přístupu k vašim účtům a souborům.
Rozsah ověření: Jde o rešeršně vedený praktický návod podle aktuálních primárních zdrojů. Zde se žádný nový MCP server nepřipojoval, neměnila se konfigurace Hermes a neproběhla modelová inference. Příkazy, kontrolní zadání i výsledky níže jsou dokumentovaný postup a očekávaná kritéria pro vaše vlastní prostředí, nikoli záznam úspěšného testu.
Hermes je hostitel, MCP klient zajišťuje spojení
Hermes zůstává agentní aplikací: přijímá zadání, pracuje s modelem a rozhoduje o volání nástrojů. Jeho MCP klient obstarává komunikaci se serverem. Server nabízí konkrétní schopnosti a data. V našem příkladu je to katalog veřejných wiki a čtení jejich dokumentů. Samotný protokol neověřuje pravdivost nalezeného textu ani nedává oprávnění použít libovolnou službu.
Agent Wikis je vhodný úzký příklad, protože provozovatel dokumentuje veřejný Streamable HTTP endpoint a čtecí nástroje. Neberte ho jako autoritu vyšší než dokumentaci výrobce: wiki může pomoct najít správné téma a jeho prameny, ale verzi Hermes a význam konfiguračního pole je potřeba kontrolovat u Nous Research. Obecný princip a marketingové použití rozebírá článek o MCP a AI agentech v marketingu; zde řešíme konkrétní konfiguraci Hermes.

stdio a HTTP mají jiný provozní i bezpečnostní dopad
Při připojení přes stdio spouští klient lokální proces a komunikuje s ním přes standardní vstup a výstup. Potřebujete tedy správný spustitelný soubor a jeho závislosti na stroji, kde běží Hermes. To může být jiný stroj než notebook s Desktopem. Cesta k souboru v kontejneru ani localhost na serveru neoznačují automaticky váš počítač. Lokální proces navíc není automaticky bezpečný: může mít práva účtu, pod kterým běží.
HTTP server běží u poskytovatele nebo ve vaší infrastruktuře. U Agent Wikis není třeba stahovat npm balíček ani spouštět lokální server; klient se připojuje na https://agentwikis.com/mcp. Dotaz však odchází provozovateli služby a vrácený dokument se může stát součástí vstupu pro vašeho poskytovatele modelu. Pro práci s neveřejnými podklady je to důležitější než nálepka „read-only“.
Pro čtení veřejné vrstvy Agent Wikis není podle provozovatele potřeba účet ani klíč. Placené XL podklady jsou jiný rozsah: bez příslušného přístupu nejsou prohledané a tuto mezeru nesmíte zaměnit za potvrzení, že hlubší dokumentace neexistuje. Tento návod pracuje jen s veřejnými daty. Žádný tarif ani klíč kvůli němu nepořizujte.
Přidání, seznam a test: nejdřív vědět, co vlastně ověřujete
Následující příkazy jsou pro váš terminál na hostu s Hermes, ne pro vykonání při čtení článku agentem. Zkontrolujte nejprve hermes --version a hermes mcp --help. Ukázka neobsahuje shellové proměnné ani unixové cesty, takže ji lze číst stejně v Linuxu, macOS i Windows terminálu s dostupným Hermes; skutečnou dostupnost CLI a síťových připojení ověřte ve své distribuci.
hermes --version
hermes mcp --help
hermes mcp add agentwikis --url "https://agentwikis.com/mcp"
hermes mcp list
hermes mcp test agentwikis
Při přidávání odmítněte autentizaci pro veřejnou vrstvu a zvolte jen požadované čtecí nástroje, pokud vám je daná verze nabídne k výběru. Samotné přidání konfiguraci zapisuje a test navazuje skutečné spojení, proto tyto příkazy nepatří do prostředí, ve kterém k takové změně nemáte souhlas. Než necháte agenta službu používat, zkontrolujte úplnou konfiguraci a nastavte filtr z další části. Existující záznam nepřepisujte bez porovnání s původními hodnotami.
Dokumentace u hermes mcp test uvádí návratový kód 0 pro dokončené spojení, 1 pro selhání, 3 pro nenakonfigurovaný server a 2 pro chybu použití argumentů. Nula neprokazuje správnou odpověď, správné oprávnění ani použití nástroje modelem. Znamená splněný transportní krok. Seznam nástrojů z diagnostiky porovnejte i se seznamem skutečně dostupným v nové relaci nebo po /reload-mcp.
Pozor na názvy: aktuální konfigurační reference uvádí tvar mcp__agentwikis__read_document, zatímco obecná feature stránka stále ukazuje starší jednoduchá podtržítka. Neopisujte prefix naslepo. Zobrazte si skutečné názvy ve své verzi a při ručním volání použijte přesně je. Do filtru níže patří původní serverové názvy bez jakéhokoli prefixu; tento rozpor v dokumentaci nemění jejich význam.
Povolte čtyři nástroje, vypněte zbytek rozhraní
Následující YAML je celá ukázková položka serveru. Vložte ji do konfigurace správného profilu, nikoli jako druhou kořenovou sekci vedle již existujícího mcp_servers. Výběr čtyř nástrojů je záměrný: katalog, orientace ve wiki, hledání a čtení přesného dokumentu. Agent Wikis nabízí i další čtecí funkce, ty však pro tento úkol nepotřebujeme.
mcp_servers:
agentwikis:
url: "https://agentwikis.com/mcp"
enabled: true
trust: untrusted
connect_timeout: 60
timeout: 120
tools:
include:
- list_wikis
- open_wiki
- search
- read_document
resources: false
prompts: false
sampling:
enabled: false
Nenulový seznam include je přehlednější než seznam zakázaných operací: nové serverové nástroje do něj samy nepřibudou. Podle aktuální reference má include přednost před exclude, pokud zadáte obojí. Nejde tedy o „povolím vše ze seznamu a pak něco odečtu“. Potřebujete-li nástroj odebrat, odstraňte ho z allowlistu. Obalové funkce pro resources a prompts mají vlastní přepínače; jejich vypnutí nelze nahradit pouhým zkrácením seznamu nativních nástrojů.
Vypnutý sampling brání tomu, aby server přes tuto MCP schopnost inicioval požadavek na model; neznamená, že běžná práce vašeho agenta přestala používat model nebo spotřebovávat jeho rozpočet. trust: untrusted zapíná podle dokumentace schvalování zápisových nástrojů, ale klasifikace vychází také z anotace serveru readOnlyHint. Není to izolace procesu ani oprávnění na straně účtu. Nepovolujte automatické schvalování s představou, že tato položka všechno zachrání.
U služby s přihlášením nejprve ověřte její skutečnou metodu: OAuth není totéž jako vložení bearer tokenu do hlavičky. Tajné hodnoty nedávejte do promptu, historie shellu ani článku. Omezení nástrojů doplňte co nejužším oprávněním účtu přímo u služby. Filtr brání nabídnutí nástroje tímto spojením; nebrání agentovi použít jiný již dostupný nástroj a neudělá z důvěrného dotazu veřejný.
Jedno dohledání dokumentu a jedna vědomě nepovolená operace
Pro pozitivní kontrolu zadejte: „Použijte pouze připojení agentwikis. Najděte veřejný dokument k MCP, přečtěte jeho celé relevantní znění a vraťte přesnou URL, cestu dokumentu, datum nebo údaj o aktuálnosti, konkrétní pasáž a odkaz na původní zdroj. Pokud zdroj nestačí, řekněte to.“ Očekávaný výsledek není jen hezké shrnutí: musí jít dohledat, jaký dokument byl skutečně přečten. Parametry volání nechte vycházet z aktuálního schématu, nevymýšlejte ID wiki ani cestu.
Negativní kontrola může být neškodná: ověřte, že Agent Wikis nástroj read_skill není po filtrování v nabídce, přestože ho služba dokumentuje. Nesnažte se provést destruktivní operaci jen proto, abyste dokázali, že ji systém zastaví. Zvlášť zapište, že veřejný server deklaruje čtení a nástroj na smazání wiki vůbec nenabízí; neexistující zápisová funkce není důkaz, že ji úspěšně zablokoval váš filtr. Očekávaný výsledek kontroly je nepřítomnost nepovoleného nástroje a žádné jeho vykonání.
Pokud spojení nefunguje, postupujte po vrstvách. Neznámý server znamená zkontrolovat jméno a profil. Timeout vede ke kontrole dostupnosti endpointu a přiměřeného limitu připojení, ne k vypnutí TLS. Spojení bez očekávaného nástroje vede ke kontrole původního názvu v allowlistu, reloadu a aktuálních schopností serveru. Odpověď bez zdroje je naproti tomu problém kvality dohledání, nikoli důvod rozšířit oprávnění.
Pro dočasné odpojení nastavte u této položky enabled: false a načtěte změnu přes /reload-mcp; podle reference se server nepřipojí a nástroje se nezaregistrují. Úplné odstranění konfigurace provádí hermes mcp remove agentwikis, poté opět ověřte novou nabídku nástrojů. Zrušení spojení nezruší to, co už bylo v konverzaci, u modelového poskytovatele nebo v logu vzdálené služby. Případné tokeny a jejich revokaci řešte odděleně podle skutečného typu autentizace.
Zdroje a platnost návodu
Dokumentace a zdrojové soubory byly ověřeny 19. listopadu 2026. Nejnovější stabilní GitHub release při kontrole byl Hermes Agent v0.23.2 z 16. listopadu 2026, commit ae2a81ccc00e9b7c06301523e5bb09608397149c. Živá dokumentace se může vyvíjet rychleji než instalovaný klient; údaj o vydání není zárukou dostupnosti každého nového ovládacího prvku ve starším Desktopu. Před použitím porovnejte svou verzi a nápovědu s konkrétním postupem.
- MCP v Hermes
- Konfigurační reference včetně přednosti filtrů
- Praktický MCP guide a diagnostika
- Agent Wikis: endpoint, veřejná vrstva a názvy nástrojů
- Hermes v0.23.2
Potřebujete vymezit bezpečné propojení s firemními daty?
Pomohu vám určit, který úkol má integrace řešit, jaká data smí předat a jak ověřit omezení ještě před napojením ostrých systémů. Napište mi přes kontaktní formulář.









