===== MCP: elérhető funkciók =====

Az [[evir:rendszer:ai_mcp|MCP szerver]] nem szabad adatbázis-hozzáférést ad az AI-nak, hanem egy **rögzített funkciólistát**. Az AI ezek közül választ, a többihez nem fér hozzá — szabad SQL, tömeges export és törlés nincs.

Ez az oldal azt írja le, mit tud pontosan kérdezni az AI.

==== Mitől függ, hogy egy funkció elérhető-e ====

Egy funkció akkor jelenik meg az AI-alkalmazásban, ha **mindhárom** teljesül:

  - a hozzá tartozó eVIR **modul telepítve van** ezen a példányon,
  - a felhasználónak van **menü-jogosultsága** a megfelelő menüponthoz,
  - írási funkciónál a hozzáférés **''read write'' jogosultsági körrel** lett engedélyezve.

Ezért ugyanaz az eVIR **más-más funkciólistát mutat két különböző felhasználónak** — ez nem hiba, hanem maga a működési elv. Ha valami hiányzik, a menü-jogosultságot kell megnézni, nem az MCP beállításait.

<note>Az AI-nak érdemes az ''evir_info'' funkcióval kezdenie: az megmutatja, mi érhető el egyáltalán az adott munkamenetben.</note>

==== Lekérdező funkciók ====

^ Funkció ^ Mit ad vissza ^ Ehhez a menüponthoz kell jog ^
| ''evir_info'' | A példány és a hívó felhasználó adatai: cégnév, verzió, telepített modulok, a felhasználó neve, telephelye, privilégiumai, és a ténylegesen elérhető funkciók listája. | — (mindig elérhető) |
| ''partner_kereses'' | Partnerek keresése név-, adószám- vagy településtöredékre. Alapból csak az aktívak. | Partnerlista |
| ''partner_adatok'' | Egy partner részletes adatai: törzsadatok, címek, e-mail címek, megjegyzés. | Partnerlista |
| ''cikk_kereses'' | Keresés a cikktörzsben cikkszám- vagy megnevezéstöredékre. Alapból csak az aktívak. | Terméklista |
| ''cikk_adatok'' | Egy cikk törzsadatai, érvényes árai és raktárankénti készlete. | Terméklista |
| ''keszlet_lekerdezes'' | Aktuális készlet cikkenként és raktáranként. Alapból csak a nem nulla sorok. | Raktár-cikk összesítő |
| ''raktar_lista'' | A raktárak kódja, neve, típusa. | Raktár-cikk összesítő |
| ''bizonylat_kereses'' | Kimenő számlák keresése partner, számlaszám, időszak vagy típus szerint, összegekkel. | Számlalista |
| ''bizonylat_adatok'' | Egy számla feje és összes tétele. | Számlalista |
| ''folyoszamla'' | Folyószámla-tételek: bizonylat, határidő, összeg, teljesített rész, hátralék, késedelmes napok. Alapból csak a rendezetlenek. | Folyószámla |
| ''kintlevoseg'' | Partnerenként összesített, korosított kintlévőség (0-30 / 31-60 / 61-90 / 90+ nap). | Folyószámla |
| ''dokumentum_kereses'' | Keresés a dokumentumtárban. **Csak a dokumentumok adatait adja vissza, a fájlok tartalmát nem.** A privátnak jelöltek nem jelennek meg. | Lista (dokumentumok) |
| ''tms_feladat_kereses'' | TMS feladatok keresése tárgy, státusz, intéző, munkacsoport vagy partner szerint. | Összes taszk |
| ''tms_feladat_adatok'' | Egy TMS feladat részletei és naplóbejegyzései. | Összes taszk |
| ''ajanlat_kereses'' | Ajánlatok keresése partner, ajánlatszám vagy időszak szerint. | Ajánlatlista |

==== Írási funkciók ====

Csak ''read write'' [[evir:rendszer:ai_mcp:engedelyezes|jogosultsági körrel]] érhetők el. Mind **előkészítés**: olyat hoznak létre, amit a felületen még át kell nézni.

^ Funkció ^ Mit csinál ^ Ehhez a menüponthoz kell jog ^
| ''partner_megjegyzes'' | Bejegyzést ír a partner naplójába a hívó nevében. A partner **törzsadatait nem módosítja**. | Partnerlista |
| ''tms_megjegyzes'' | Megjegyzést fűz egy meglévő TMS feladathoz. **A státuszt nem változtatja meg.** | Új taszk |
| ''tms_feladat_letrehozas'' | Új TMS feladatot hoz létre tárggyal, leírással, munkacsoporttal, opcionálisan intézővel, határidővel, partnerrel. | Új taszk |
| ''ajanlat_piszkozat'' | **Piszkozat** állapotú ajánlatot hoz létre a megadott partnerhez és tételekkel, és visszaadja az ajánlat linkjét. | Ajánlat készítés |

<note important>**Amit egyetlen funkció sem tud:** törölni (semmit, semmilyen formában), számlát kiállítani, bizonylatot véglegesíteni vagy könyvelni, e-mailt kiküldeni, törzsadatot módosítani, jogosultságot változtatni, felhasználót létrehozni, beállítást átírni. \\ Az ''ajanlat_piszkozat'' által készített ajánlat piszkozat marad: nem véglegesít, nem nyomtat, nem küld ki semmit.</note>

==== Korlátok minden hívásra ====

  * **Sorlimit.** Minden lekérdezésre kötelező limit kerül (alapértelmezés: 100 sor). A hívó kérhet kevesebbet, **többet nem** — így nem lehet a funkciókkal adatbázist másolni.
  * **Méretlimit.** A válasz mérethatár felett csonkolódik, és a csonkolás ténye ki is íródik, hogy az AI ne hiányos adatra alapozzon.
  * **Hívásszám-korlát** percenként, hozzáférésenként.
  * **Naplózás.** Minden hívás — a sikertelen is — bekerül a [[evir:rendszer:ai_mcp:audit|hívásnaplóba]].

A határértékek a [[evir:rendszer:beallitasok:ai_mcp|beállításokban]] módosíthatók.

==== A válaszokban lévő linkek ====

A funkciók a találatokhoz **eVIR-linket** is visszaadnak. Ezek a szokásos, bejelentkezést igénylő felületre mutatnak: az AI válaszából egy kattintással a rendes eVIR-képernyőn lehet folytatni. A link önmagában nem ad hozzáférést senkinek.

----

Kapcsolódó oldalak:
  * [[evir:rendszer:ai_mcp|eVIR MCP szerver (áttekintés)]]
  * [[evir:rendszer:ai_mcp:adatbiztonsag|Adatbiztonság]]
  * [[evir:rendszer:ai_mcp:audit|MCP hívásnapló]]
  * [[evir:rendszer:felhasznalok:jogosultsagi_rendszer|Jogosultsági rendszer]]