MCP servery
MCP — Model Context Protocol — je otevřený standard, který umožňuje AI asistentům objevovat a volat externí nástroje. Pokud provozujete MCP-kompatibilní server (vlastní, nebo některý z mnoha komunitních), můžete ho zapojit do Hanc.AI a vaši agenti získají nástroje serveru ve chvíli, kdy hovor začíná.
Po připojení může agent tyto nástroje volat uprostřed konverzace — natahovat živá data, provádět výpočty, spouštět backendová workflow — přesně jako vestavěné integrace Calendar, HubSpot nebo API Tool.
MCP servery jsou dostupné na všech plánech včetně Free. Není žádný poplatek za server — platíte jen minuty hovorů, které váš agent spotřebuje při volání nástrojů.
Kdy použít MCP
| Scénář | Proč MCP sedí |
|---|---|
| Už provozujete interní server s nástroji | Jedno připojení, všechny vaše nástroje dostupné každému agentovi |
| Chcete sdílet nástroje napříč agenty | Připojte jednou, připojte k tolika agentům, ke kolika chcete |
| Používáte komunitní MCP servery | Zapojte populární open-source MCP servery bez psaní vlastního kódu |
| Sada nástrojů se často mění | Agent znovu objevuje nástroje při každém hovoru — přidávejte/odebírejte na straně serveru bez sahání do dashboardu |
Pokud máte jeden jednorázový endpoint, jednodušší je API Tool. Pokud máte sadu souvisejících nástrojů nebo už MCP server udržujete, je tahle integrace správná volba.
Připojení MCP serveru
1. Otevřete stránku Integrací
V postranním panelu dashboardu přejděte na Integration. Posuňte se na sekci MCP servers.
2. Klikněte na „Connect MCP server"
Otevře se modální okno. Vyplňte:
| Pole | Popis |
|---|---|
| Label | Krátký název pro toto připojení (např. "Sales Tools", "Internal CRM"). Label se zobrazuje ve výběru nástrojů agenta a předřazuje názvy nástrojů prezentovaných AI, takže ho držte krátký a smysluplný. |
| URL | HTTPS URL vašeho MCP serveru. Musí být veřejně dostupná adresa — http:// a privátní/interní adresy jsou odmítnuty. |
| Autentizace | None, pokud je váš server otevřený, nebo Bearer token, pokud očekává hlavičku Authorization: Bearer …. |
| Token | (Pouze Bearer) Váš autentizační token. Uložen šifrovaně — dešifrovat ho pro použití dokáže jen váš platformní účet. |
Klikněte na Save. Hanc.AI ověří formát URL a uloží připojení. Připojení je nyní dostupné každému agentovi ve vašem workspace.
Názvy nástrojů z každého MCP serveru jsou prefixovány labelem připojení, takže MCP server s nástrojem lookup_order připojený jako "Shop API" se agentovi zobrazí jako Shop_API_lookup_order. Tím se předchází kolizím, když připojíte více MCP serverů, které mají podobně pojmenované nástroje.
3. Upravit, deaktivovat nebo smazat
Seznam MCP serverů zobrazuje label, URL, typ autentizace a stav každého připojení, které jste přidali. Použijte akce v řádku k:
- Edit — změna labelu, URL, typu autentizace nebo tokenu
- Delete — kompletní odstranění připojení
Odstranění připojení ho deaktivuje pro každého agenta, který ho měl připojený — tito agenti při dalším hovoru jednoduše ztratí přístup k jeho nástrojům.
Připojení MCP nástrojů k agentovi
Připojení ve vašem workspace je dostupné vašim agentům — ale každý agent rozhoduje individuálně, která z vašich připojení zpřístupní. To znamená, že můžete mít samostatné prodejní a podpůrné agenty, kteří čerpají z různých MCP serverů.
1. Otevřete záložku Actions agenta
Vyberte agenta. Otevřete záložku Actions. Klikněte na Add Action.
2. Vyberte „MCP servers" ze skupiny Live-call
Rozbalovací seznam zobrazuje tři skupiny: Pre fetch, Live call, Post call. Hledejte ve skupině Live-call — tam MCP servery patří, protože agent volá MCP nástroje během konverzace, nikoli před ní nebo po ní.
3. Přepněte, která připojení povolit
Modální okno vypisuje každé MCP připojení ve vašem workspace, každé s on/off přepínačem. Zapněte ta, která by tento agent měl používat. Můžete také napsat krátkou instrukci do pole "When to use it" — to je to, co agent čte, aby rozhodl, kdy po těchto nástrojích sáhnout během konverzace.
Klikněte na Save. Agent má nyní přístup k nástrojům z každého povoleného MCP připojení.
Můžete mít jedno MCP připojení povolené na pěti agentech a další povolené jen na jednom — každý agent má vlastní nástroj MCP servers s vlastní sadou přepínačů.
Jak to funguje v době hovoru
Když hovor začne, agent se připojí ke každému ze svých povolených MCP serverů a zeptá se „jaké nástroje nabízíš?" Cokoli server vrátí, je zpřístupněno AI jako nástroj, který může během konverzace volat.
Pár věcí, co je dobré vědět:
- Nástroje se objevují při startu hovoru. Pokud na svém MCP serveru přidáte nebo odeberete nástroje, změna se projeví na úplně dalším hovoru — není potřeba nic aktualizovat v Hanc.AI.
- Názvy nástrojů jsou prefixovány labelem připojení (takže
"Shop API"+ nástrojsearch_products→Shop_API_search_products). Vestavěné nástroje agenta a další MCP nástroje se nesrazí. - Popisy nástrojů a schémata parametrů přicházejí z vašeho MCP serveru. Pište tam dobré popisy — to je to, podle čeho AI rozhoduje, kdy a jak nástroj zavolat.
- Chyby jsou reportovány zpět agentovi. Pokud volání nástroje selže, agent vidí chybovou zprávu a může se rozhodnout opakovat, omluvit se nebo zkusit jiný nástroj.
Požadavky na váš MCP server
Aby fungoval s Hanc.AI, váš server musí:
| Požadavek | Detail |
|---|---|
| HTTPS | Plain http:// není akceptováno. Použijte skutečný TLS certifikát. |
| Veřejná URL | URL musí směřovat na veřejnou adresu — Hanc.AI nemůže dosáhnout na servery v privátní síti nebo na localhostu. |
| MCP Streamable HTTP transport | Aktuální MCP HTTP transport přes jediný endpoint. Pouze-SSE a stdio transporty nejsou v této integraci podporovány. |
| Bearer auth (volitelné) | Pokud váš server vyžaduje autentizaci, musí akceptovat standardní hlavičku Authorization: Bearer <token>. |
Pokud hostujete vlastní server za firewallem, vystavte ho přes tunel nebo reverse proxy s veřejným HTTPS endpointem.
Bezpečnost a soukromí
Vaše bearer tokeny jsou uloženy šifrovaně v klidu. Dešifrovat je dokáže jen call infrastruktura Hanc.AI, a to jen ve chvíli, kdy hovor začíná a agent se potřebuje připojit k vašemu serveru.
Volání nástrojů jde agent → Hanc.AI → váš MCP server → zpět. Nelogujeme payloady volání nástrojů. Váš server loguje, cokoli si vyberete, na své straně.
Pokud token změníte nebo zrotujete, upravte připojení v dashboardu — nová hodnota se projeví na dalším hovoru.
Dostupnost v plánech
| Plán | MCP servery |
|---|---|
| Free | Dostupné |
| Starter / Pro / Business / Enterprise | Dostupné |
Není žádný poplatek za připojení — platíte jen minuty hovorů, během kterých agent nástroje volá.
Řešení problémů
„Připojení se neuloží"
- Ujistěte se, že URL začíná
https://a nehttp://. - Ujistěte se, že host je veřejně dostupný —
localhost,127.0.0.1a interní adresy jsou záměrně blokované. - Zkontrolujte bearer token, pokud jste ho nastavili — extra mezery nebo uvozovky zlomí uložení.
„Agent nevidí nástroje"
- Zkontrolujte, že záznam MCP server na záložce Actions agenta má alespoň jedno připojení zapnuté on a záznam je uložený.
- Ujistěte se, že váš MCP server odpovídá na tools/list request a nevyžaduje interaktivní auth flow.
- Podívejte se v call logu agenta na zprávy z MCP připojení hned na začátku hovoru.
„Nástroj selže uprostřed hovoru"
- Agent uvidí, jakoukoli chybu váš server vrátí. Zkontrolujte logy serveru.
- Dlouho běžící nástroje mohou vypršet — držte vykonání MCP nástroje pod několika sekundami na hovor, aby návštěvník neseděl v tichu.
„Změnil jsem nástroje na svém serveru, ale agent stále používá staré"
- Nástroje se znovu objevují na začátku každého hovoru, nikoli cachované napříč hovory. Úplně další nový hovor uvidí aktualizovanou sadu nástrojů. Probíhající hovory si drží nástroje, které dostaly při startu.
Související
- Akce a nástroje — Vestavěné nástroje a jak je záložka Actions organizována
- Integrace — Všechny dostupné integrace
- API Tool RAG — Jednodušší volba pro jediný endpoint