Wiki · Začínáme
MCP nástroje
Hotová rozhraní, ke kterým se agent připojí — a najednou umí pracovat s vašimi systémy, bez psaní kódu.
🔌
Řada služeb už má hotové rozhraní pro agenty — agent se k němu jen připojí.
Říká se tomu MCP a je to způsob, jak agentovi přidat schopnosti, které sám nemá: přístup k vašim
souborům, k projektu na GitHubu, ke svému nástroji pro automatizaci nebo k prohlížeči.
Nepíše se k tomu žádný kód.
Co to je, lidsky
Agent sám umí pracovat s terminálem, soubory a webem. Kdyby měl umět i všechno ostatní, musel by mít pro každou službu vlastní řešení — což je pomalé a křehké. MCP je společná dohoda, kterou už řada služeb nabízí. Agent se tedy připojí k hotovému rozhraní a hned umí to, co nabízí.
| Přinese vám | Příklad |
|---|---|
| Agent vidí do vašich systémů | Projde soubory v projektu, přečte si dokumentaci, podívá se do databáze |
| Ovládá nástroje, které už používáte | Založí kartu v nástroji pro automatizaci, přidá komentář k úkolu, nahraje soubor |
| Umí se podívat na web jako člověk | Otevře stránku v prohlížeči a ověří, že opravdu vypadá správně |
| Dosáhne na chyby a dokumentaci | Přečte hlášené chyby z vašeho sledování, dohledá aktuální dokumentaci knihovny |
Dva druhy napojení
| Druh | Jak funguje | Typicky pro |
|---|---|---|
| Místní | Program se spouští přímo na vašem serveru, agent s ním mluví uvnitř počítače | Přístup ke složkám, k databázi, k místnímu nástroji |
| Vzdálené | Agent se připojuje přes internet k cizí službě; některé chtějí přihlášení | GitHub, project management, sledování chyb |
Jak napojení přidat
- Z katalogu — nejjednodušší cesta. Pro vybraná napojení existuje katalog,
ze kterého se instalují jedním příkazem:
$ hermes mcp catalog $ hermes mcp installU některých napojení se při instalaci vybírá, které nástroje má agent vidět.
- Přidáním z adresy nebo příkazu. Když napojení v katalogu není:
$ hermes mcp add
- Zápisem do nastavení. Ruční cesta pro toho, kdo ví, co dělá — do souboru
~/.hermes/config.yaml:mcp_servers: filesystem: command: "npx" args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projekty"]
U napojení, která chtějí přihlášení, se použije hermes mcp login — otevře se přihlášení
v prohlížeči, stejně jako u kteréhokoli jiného účtu. Klíče se do nastavení nepíšou natvrdo:
napojení si je bere z prostředí.
Ověření: hermes mcp test řekne, jestli se napojení podařilo připojit
a jaké nástroje přineslo. Změny se projeví po novém spuštění agenta.
Bezpečnost: napojení je cizí kód
⚠️
Napojení dává agentovi nové schopnosti — a může v podstatě cokoli, co sám umí.
Berte jen zdroje, kterým věříte (oficiální katalog, ověření výrobci) a u napojení,
která to nabízejí, omezte, které nástroje agent uvidí. Napojení od neznámého zdroje je
jako spustit cizí program s přístupem k vašemu serveru.
| Pojistka | Co dělá |
|---|---|
| Oficiální katalog | Napojení v katalogu prošla kontrolou, takže je bezpečné začít tam |
| Výběr nástrojů | U napojení se dá zaškrtnout jen to, co opravdu chcete používat — zbytek agent ani nevidí |
| Klíče mimo soubor | Tajné údaje se berou z prostředí, ne z konfigurace, takže se nekopírují do záloh ani do gitu |
Když to nefunguje
| Co se děje | Příčina a co s tím |
|---|---|
| Agent nové nástroje nevidí | Změna se projeví až po novém spuštění agenta. Pak ověřte hermes mcp test |
| Napojení hlásí chybu přihlášení | Spusťte hermes mcp login a přihlaste se v prohlížeči; pozor, přihlášení má svou platnost |
| Některý nástroj chybí | Při instalaci byl vynechán z výběru — hermes mcp configure výběr upraví |
| Agent se plete mezi nástroji | Napojení přineslo příliš mnoho nástrojů. Zúžte výběr na ty, které používáte |
| Nevím, co je připojené | V rozhovoru se zeptejte; v nastavení je to v sekci mcp_servers |
Naše tipy
| Tip | Proč |
|---|---|
| Začněte katalogem | Nemusíte nic vymýšlet a víte, že napojení prošlo kontrolou |
| Přidávejte po jednom | Když jich zapnete deset naráz, nepoznáte, které zlobí, a agent se v nástrojích ztratí |
| Zúžte výběr nástrojů | Méně nástrojů znamená méně zmatků a menší riziko, že agent sáhne po něčem, co jste nechtěli |
| Co nepoužíváte, odpojte | Každé napojení je další cizí kód na vašem serveru |
Kam dál
BezpečnostCo agent smí a co musí odsouhlasit⏳ připravujeme
Pravidelné úlohyNapojení se hodí i úlohám
Oficiální dokumentaceMCP do detailu (anglicky)
Discord komunityCo si kdo připojil