Ugrás a fő tartalomhoz

MCP Tool

Az MCP Toolokkal az IntraCord Voice Agentje élő beszélgetés közben meghívhatja egy távoli Model Context Protocol szerver Tooljait. Az IntraCord felderíti a távoli Tool-katalógust, LLM által hívható függvényekké alakítja a Toolokat, majd hitelesített Streamable HTTP-kapcsolaton továbbítja a hívásokat az MCP Servernek.

Mit kell beállítani?​

Az IntraCord MCP Tooljának négy fontos eleme van:

  • Név: a Server IntraCordban megjelenő neve.
  • Leírás: megmondja az LLM-nek, mikor releváns az MCP Server.
  • URL: a távoli MCP Server endpointja (http:// vagy https://).
  • Credential: az MCP-kapcsolat létrehozásakor elküldendő hitelesítés.

Tool Filtert is megadhatsz, amellyel csak bizonyos távoli MCP Toolokat teszel elérhetővé.

Hitelesítés​

A legtöbb hosztolt MCP Server ezt várja:

Authorization: Bearer <token>

Az MCP Tool létrehozása előtt hozz létre egy Credential bejegyzést az IntraCordban:

  • Credential típusa: Bearer Token
  • Token: az MCP Server által kiadott hozzáférési token.

Ezután válaszd ki ezt a Credential bejegyzést az MCP Toolnál.

Az IntraCord más hitelesítési típusokat is támogat, de külső MCP Servereknél általában a Bearer Token a megfelelő kiindulópont, hacsak a szerver dokumentációja mást nem ír elő.

Működés​

A futás lépései:

  1. Az MCP Tool mentésekor vagy frissítésekor az IntraCord rövid életű, hitelesített MCP-munkamenetet nyit, és lekéri a távoli Tool-katalógust.
  2. A katalógust a felderített Toolok között tárolja, így a felület meg tudja jeleníteni az elérhető távoli függvényeket.
  3. A hívás kezdetekor minden csatolt MCP Serverhez egy élő MCP-munkamenetet nyit, és az adott munkamenethez a kiválasztott Credential bejegyzést használja.
  4. Node-onként csak a szerver- és Node-szintű szűrés által engedélyezett MCP Toolokat teszi elérhetővé.
  5. A távoli Toolokat hagyományos LLM Function Definitions formába rendezi, így biztonságosan használhatók a HTTP API-, hívásátadó, hívásbefejező és más Toolokkal együtt.
  6. A beszélgetés során az LLM csak a Tool nevét, leírását és argumentumsémáját látja. A titkos adatot nem kapja meg.
  7. Amikor az LLM meghív egy Toolt, az IntraCord továbbítja a hívást az aktív, hitelesített MCP-munkameneten, fogadja az eredményt, majd visszaadja azt az aktuális Agent Turnnek.

Röviden: a felderítést, hitelesítést, munkamenet-kezelést, Tool-regisztrációt és az eredmények továbbítását az IntraCord végzi; az LLM csak arról dönt, mikor és milyen argumentumokkal hívja meg a Toolt.

MCP Tool létrehozása​

  1. Nyisd meg a Toolok oldalt, és hozz létre új Toolt.
  2. Válaszd az MCP Server típust.
  3. Adj meg egyértelmű nevet és olyan leírást, amelyből az LLM megtudja, mikor használja a szervert.
  4. Illeszd be az MCP Server URL-jét.
  5. Válaszd ki a Credential bejegyzést. Ez a legtöbb esetben Bearer Token típusú.
  6. Mentsd a Toolt, majd ellenőrizd, hogy az IntraCord felderítette-e a távoli Toolokat.

Ha a szerver sok Toolt biztosít, szűréssel csak azokat hagyd meg, amelyekre az ügynöknek valóban szüksége van.

Hozzárendelés Node-hoz​

Az MCP Tool létrehozása után:

  1. Nyisd meg azt a workflow Node-ot, amelyben használni szeretnéd.
  2. Add hozzá az MCP Toolt a Node Tool-listájából.
  3. Csak azokat a távoli MCP-függvényeket jelöld ki, amelyek az adott Node-on meghívhatók.
  4. A Node promptjában pontosan írd le, mikor használja az LLM ezeket a függvényeket.

Minél szűkebb a Node Tool-készlete és minél pontosabb a prompt útmutatása, annál megbízhatóbban működik az MCP Tool.

Bevált gyakorlatok​

  • Lehetőség szerint logikai integrációnként egy MCP Servert használj.
  • A Tool leírása pontosan mondja meg, mikor használja az LLM a szervert.
  • Node-onként csak a minimálisan szükséges távoli függvényeket tedd elérhetővé.
  • Ha az MCP Server nem ír elő más hitelesítést, részesítsd előnyben a Bearer Token típust.
  • Először a felderítést teszteld, majd valódi telefon- vagy webhívással ellenőrizd, hogy az LLM a megfelelő függvényt és argumentumokat használja-e.