Ugrás a fő tartalomhoz
DocumentationAPI ReferenceVideo Tutorials

MCP szerverek

Az MCP — a Model Context Protocol — egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek számára, hogy felfedezzék és meghívják a külső eszközöket. Ha futtatsz egy MCP-kompatibilis szervert (sajátot vagy a közösségi szerverek egyikét), bedugaszolhatod a Hanc.AI-ba, és az ügynökeid a hívás indulásának pillanatában megkapják a szerver eszközeit.

A csatlakoztatás után az ügynök beszélgetés közben hívhatja meg ezeket az eszközöket — élő adatokat kérve le, számításokat futtatva, backend munkafolyamatokat indítva — pontosan úgy, mint a beépített Calendar, HubSpot vagy API Tool integrációknál.

Elérhető minden csomagban

Az MCP szerverek minden csomagban elérhetők, beleértve a Free-t is. Nincs szerverenkénti díj — csak azokért a hívásperceket fizetsz, amelyek alatt az ügynök az eszközöket meghívja.

Mikor használj MCP-t​

ForgatókönyvMiért illik az MCP
Már futtatsz egy belső eszközszervertEgy kapcsolat, minden eszközöd elérhető minden ügynöknek
Eszközöket akarsz megosztani ügynökök közöttCsatlakoztasd egyszer, csatold annyi ügynökhöz, amennyit szeretnél
Közösségi MCP szervereket használszCsatlakoztass népszerű open-source MCP szervereket egyedi kód nélkül
Az eszközfelületed gyakran változikAz ügynök minden híváskor újrafelfedezi az eszközöket — adj hozzá vagy távolíts el eszközöket szerveroldalon a dashboard érintése nélkül

Ha egyetlen alkalmi végpontod van, az API Tool egyszerűbb. Ha készleted van kapcsolódó eszközökből, vagy már fenntartasz egy MCP szervert, ez a megfelelő integráció.

MCP szerver csatlakoztatása​

1. Nyisd meg az Integrations oldalt​

A dashboard oldalsávjában menj az Integration menüpontra. Görgess az MCP servers szakaszhoz.

2. Kattints a „Connect MCP server" gombra​

Egy modális ablak nyílik meg. Töltsd ki:

MezőLeírás
LabelRövid név ehhez a kapcsolathoz (pl. "Sales Tools", "Internal CRM"). A címke megjelenik az ügynök eszközválasztójában, és prefixként kerül az AI-nak átadott eszköznevek elé, ezért tartsd rövidnek és értelmesnek.
URLAz MCP szervered HTTPS URL-je. Nyilvánosan elérhető címnek kell lennie — a http:// és a privát/belső címek elutasításra kerülnek.
AuthenticationNone, ha a szervered nyitott, vagy Bearer token, ha Authorization: Bearer … headert vár.
Token(Csak Bearer) Az autentikációs tokened. Titkosítva tárolva — csak a platform fiókod tudja visszafejteni a használathoz.

Kattints a Save gombra. A Hanc.AI ellenőrzi az URL formátumát, és tárolja a kapcsolatot. A kapcsolat most már elérhető a workspace-edben lévő minden ügynök számára.

A címkék számítanak

Az egyes MCP szerverekről származó eszköznevek a kapcsolat címkéjével vannak prefixálva, így egy lookup_order eszközzel rendelkező MCP szerver, amely "Shop API" néven van csatlakoztatva, az ügynök számára Shop_API_lookup_order-ként jelenik meg. Ez megakadályozza az ütközéseket, ha több MCP szervert csatlakoztatsz, amelyeknek véletlenül hasonló nevű eszközei vannak.

3. Szerkesztés, letiltás vagy törlés​

Az MCP szerverek listája mutatja a címkét, URL-t, autentikációs típust és státuszt minden hozzáadott kapcsolatnál. Használd a sorműveleteket a következőkre:

  • Edit — címke, URL, autentikációs típus vagy token megváltoztatása
  • Delete — a kapcsolat teljes eltávolítása

A kapcsolat eltávolítása minden olyan ügynök számára deaktiválja, amelyhez csatolva volt — azok az ügynökök egyszerűen elveszítik a hozzáférést az eszközeihez a következő híváson.

MCP eszközök csatolása egy ügynökhöz​

A workspace-edben lévő kapcsolat elérhető az ügynökeid számára — de minden ügynök egyénileg dönti el, hogy a kapcsolataid közül melyiket teszi elérhetővé. Ez azt jelenti, hogy lehet külön Sales és Support ügynököd, amelyek különböző MCP szerverekből húznak adatot.

1. Nyisd meg az ügynök Actions fülét​

Válaszd ki az ügynököt. Nyisd meg az Actions fület. Kattints az Add Action gombra.

2. Válaszd az „MCP servers" opciót a Live-call csoportból​

A legördülő három csoportot mutat: Pre fetch, Live call, Post call. Keresd a Live-call csoportban — itt található az MCP servers, mert az ügynök beszélgetés közben hívja meg az MCP eszközöket, nem előtte vagy utána.

3. Kapcsold be, mely kapcsolatokat engedélyezed​

A modális ablak felsorolja a workspace-edben lévő összes MCP kapcsolatot, mindegyiket be/ki kapcsolóval. Kapcsold be azokat, amelyeket ennek az ügynöknek használnia kell. Rövid utasítást is írhatsz a „When to use it" mezőbe — ezt olvassa az ügynök, hogy eldöntse, mikor nyúljon ezekhez az eszközökhöz a beszélgetés során.

Kattints a Save gombra. Az ügynök most már hozzáfér minden engedélyezett MCP kapcsolat eszközeihez.

Vegyíthető és kombinálható

Lehet egy MCP kapcsolatod öt ügynökön engedélyezve, és egy másik csak egyen — minden ügynöknek saját MCP servers eszköze van saját kapcsolókészlettel.

Hogyan működik hívásidőben​

Amikor egy hívás indul, az ügynök csatlakozik minden engedélyezett MCP szerveréhez, és megkérdezi: „milyen eszközöket kínálsz?" Amit a szerver visszaad, az kerül az AI elé eszközként, amelyet a beszélgetés során meghívhat.

Néhány dolog, amit érdemes tudni:

  • Az eszközök híváskezdéskor kerülnek felfedezésre. Ha hozzáadsz vagy eltávolítasz eszközöket az MCP szerveredről, a változás már a következő híváson megjelenik — nem kell semmit frissíteni a Hanc.AI-ban.
  • Az eszköznevek prefixáltak a kapcsolat címkéjével (így "Shop API" + search_products eszköz → Shop_API_search_products). A beépített ügynökeszközök és más MCP eszközök nem ütköznek.
  • Az eszközleírások és paramétersémák az MCP szerveredről jönnek. Írj ott jó leírásokat — ez alapján dönti el az AI, hogy mikor és hogyan hívja meg az eszközt.
  • A hibákat visszajelentjük az ügynöknek. Ha egy eszközhívás sikertelen, az ügynök látja a hibaüzenetet, és eldöntheti, hogy újrapróbál, bocsánatot kér vagy másik eszközt próbál.

Követelmények az MCP szervereddel szemben​

A Hanc.AI-jal való működéshez a szerverednek a következőkre van szüksége:

KövetelményRészlet
HTTPSA sima http:// nem elfogadott. Használj valódi TLS tanúsítványt.
Nyilvános URLAz URL-nek nyilvános címre kell feloldódnia — a Hanc.AI nem éri el a privát hálózaton vagy localhoston lévő szervereket.
MCP Streamable HTTP transportAz aktuális MCP HTTP transport egyetlen végponton. A csak SSE és stdio transportok nem támogatottak ebben az integrációban.
Bearer auth (opcionális)Ha a szervered autentikációt igényel, el kell fogadnia egy szabványos Authorization: Bearer <token> headert.

Ha tűzfal mögött tárolod a saját szervered, tedd elérhetővé tunnelen vagy reverse proxy-n keresztül nyilvános HTTPS végponttal.

Biztonság és adatvédelem​

A bearer tokenjeid titkosítva tárolódnak. Csak a Hanc.AI hívási infrastruktúrája tudja visszafejteni őket, és csak abban a pillanatban, amikor egy hívás indul, és az ügynöknek csatlakoznia kell a szervereddhez.

Az eszközhívások ügynök → Hanc.AI → MCP szerver → vissza úton áramlanak. Nem naplózzuk az eszközhívás payloadokat. A szervered annyit naplóz a végeden, amennyit te választasz.

Ha megváltoztatod vagy rotálod a tokened, szerkeszd a kapcsolatot a dashboardon — az új érték a következő híváson lép érvénybe.

Csomagok elérhetősége​

CsomagMCP szerverek
FreeElérhető
Starter / Pro / Business / EnterpriseElérhető

Nincs kapcsolatonkénti díj — csak azokért a hívásperceket fizetsz, amelyek alatt az ügynök az eszközöket meghívja.

Hibaelhárítás​

„A kapcsolat nem mentődik el"​

  • Győződj meg róla, hogy az URL https://-vel kezdődik, nem http://-vel.
  • Győződj meg róla, hogy a host nyilvánosan elérhető — a localhost, 127.0.0.1 és belső címek tervezetten blokkoltak.
  • Ha beállítottál bearer tokent, ellenőrizd újra — extra whitespace vagy idézőjelek megtörik a mentést.

„Az ügynök nem látja az eszközöket"​

  • Ellenőrizd, hogy az MCP szerver bejegyzés az ügynök Actions fülén legalább egy kapcsolatot bekapcsolva tartalmaz, és a bejegyzés el van mentve.
  • Győződj meg róla, hogy az MCP szervered válaszol a tools/list kérésre, és nem igényel interaktív autentikációs flow-t.
  • Nézz az ügynök hívásnaplójába a hívás kezdetén az MCP kapcsolat üzeneteiért.

„Az eszköz hívás közben hibázik"​

  • Az ügynök azt látja, amit a szervered hibaként visszaad. Ellenőrizd a szervernaplódat.
  • A hosszan futó eszközök timeoutolhatnak — tartsd az MCP eszközvégrehajtást hívásonként pár másodperc alatt, hogy a látogató ne üljön csendben.

„Megváltoztattam az eszközöket a szerveremen, de az ügynök még a régieket használja"​

  • Az eszközök minden hívás kezdetén újrafelfedezésre kerülnek, nem cache-elődnek a hívások között. A következő új hívás már a frissített eszközkészletet látja. A folyamatban lévő hívások megtartják a kezdetkor kapott eszközöket.

Kapcsolódó​