AI-kapcsolat (MCP)

Az OkosMunkalap összeköthető a saját AI-alkalmazásoddal (Claude vagy ChatGPT), és onnan természetes nyelven kérdezheted le vagy módosíthatod a munkalapjaidat és az ügyfeleidet. Nem kell kódot írni hozzá: kimásolsz egy címet, beilleszted az AI-alkalmazás beállításába, belépsz és engedélyezed a hozzáférést.

A kapcsolat a Model Context Protocol (MCP) szabvány szerint működik, ezért minden olyan alkalmazással kompatibilis, amely támogatja az egyéni connectorokat.

Mire jó

Néhány tipikus kérés, amit az összekötés után feltehetsz az AI-alkalmazásodnak:

• „Keresd meg Kovács János adatait, és mondd meg, mikor volt nála utoljára szerelés.“
• „Vegyél fel új ügyfelet: Példa Kft., adószám 12345678-1-42, cím Budapest, Fő utca 1.“
• „Nyiss munkalapot a Példa Kft.-nek kazánkarbantartásra, jövő keddre.“
• „Vettem be egy Jura F50 kávégépet Némethné Hannától, gyári szám SN-1234, nem darál. Nyiss rá szervizlapot a soproni műhelybe.“
• „Nyiss felmérést a Példa Kft. telephelyére, a helyszín Szombathely, Munka utca 1.“
• „Nyiss munkalapot a Példa Kft.-nek kazánkarbantartásra, és add oda Péternek.“
• „Sorold fel a piszkozat munkalapokat, és foglald össze, melyik mennyi.“
• „Írd át a Példa Kft. helyszíni kapcsolattartójának telefonszámát.“

Előfeltételek

Feltétel	Részletek
Jogosultság	Tulajdonosi vagy adminisztrátori hozzáférés a munkaterülethez. Csapattag nem tud csatlakozni.
AI-felhasználás	A Beállítások, Integrációk oldalon az „AI-felhasználás engedélyezése“ kapcsoló bekapcsolva. Alapértelmezés szerint ki van kapcsolva.
Csomag	Bármelyik csomaggal működik. A hívások száma csomagfüggő (lásd a Kéréskorlát részt).
AI-alkalmazás	Claude (webes vagy asztali alkalmazás), vagy ChatGPT Plus, illetve Pro előfizetéssel, bekapcsolt Fejlesztői móddal.

Csatlakozás

1. A connector cím kimásolása

Nyisd meg a Beállítások, Integrációk oldalt, az AI-kapcsolatok szekcióban kattints a Csatlakozás gombra, majd másold ki a connector címet:

https://mcp.okosmunkalap.hu/mcp

2. A cím beillesztése az AI-alkalmazásba

Claude: Beállítások, majd Connectors menü, egyéni connector hozzáadása a fenti címmel.

ChatGPT: kapcsold be a Fejlesztői módot, majd add hozzá a fenti címet új connectorként.

A menük elnevezése és helye időnként változik, ezért ha nem találod, keresd a „connector“, „custom connector“ vagy „MCP“ kifejezést az alkalmazás beállításai között.

3. Belépés és engedélyezés

Az AI-alkalmazás átirányít az OkosMunkalap belépési, majd engedélyező oldalára. Itt látod, mely munkaterülethez kéri a hozzáférést, és itt döntöd el, hogy az AI csak olvashat, vagy írhat is. Az engedélyezés után a kapcsolat kész, és az alkalmazás listázni tudja az elérhető műveleteket.

Engedélyek

Két engedélyszint van. Az engedélyező oldalon az írás külön kapcsolóval elhagyható.

Engedély	Mit jelent
Csak olvasás	Az AI kereshet és lekérdezhet, de semmilyen adatot nem módosít.
Olvasás és írás	Az AI létrehozhat és módosíthat munkalapot, ügyfelet és címet is.

Az AI-alkalmazások ezen felül a saját oldalukon is engedélyt kérnek az egyes műveletek futtatásához. Az olvasó műveleteket nyugodtan engedélyezheted automatikusan, az adatot módosítókat viszont érdemes egyenként jóváhagyni.

Elérhető műveletek

Munkalapok

Művelet	Típus	Leírás
list_worksheets	olvasás	Munkalapok listázása szűrőkkel (státusz, ügyfél, ütemezett dátum-tartomány), lapozással.
get_worksheet	olvasás	Egy munkalap teljes adata, tételsorokkal, azonosító alapján.
create_worksheet	írás	Új munkalap egy meglévő ügyfélre, tételsorokkal. A bizonylat típusa és a sorszám-prefix a lenti táblázat szerint alakul.
update_worksheet_status	írás	Státuszváltás. A végleges státuszok emberi megerősítést kérnek.
assign_worksheet	írás	Munkalap hozzárendelése kollégákhoz, szerepkörrel.
list_service_locations	olvasás	A javításhoz választható műhelyek (telephelyek): név, cím, és hogy melyik az alapértelmezett.

Milyen bizonylat készül

A létrehozásnál két egymástól független dolgot mondhatsz meg: hol végzik a munkát, és mi a dokumentum jellege. A négy kombinációnak külön sorszám-tartománya van, pontosan úgy, mint amikor a felületen hozod létre:

	Kiszállásos (az ügyfélnél)	Szerviz (műhelybe átvéve)
Munkalap	ML	SZ
Felmérés	FE	SZF

Alapértelmezés a kiszállásos munkalap (ML), ezért ezt nem kell külön kérned. A többihez elég természetesen megfogalmazni: „szervizlap“, „felmérés“, „bevettem a műhelybe“.

Szerviz bizonylatnál megadható az átvett eszköz (típus, gyártó, modell, gyári szám, tartozékok, tárolási hely) és a hibafelvétel (az ügyfél által jelzett hiba, illetve megjegyzés az eszköz állapotáról). Ez a kettő együtt az átvételi jegyzőkönyv feltétele is: ha megvannak, és a javítás a műhelyben történik, a munkalap Műveletek menüjében az „Átvételi jegyzőkönyv PDF generálása“ azonnal elérhető. Ügyfélcímes javításnál nincs átvételi jegyzőkönyv (nincs mit átvenni), és a záró bizonylat is teljesítési igazolás lesz, nem kiadási bizonylat. Az eszköz emellett bekerül az Eszközök nyilvántartásba, így a gép szerviz-előzménye a következő alkalommal is előjön. A szerviz bizonylat az „Átvéve“ státuszban indul.

Kiszállásos bizonylaton eszköz és átvételi adat nem adható meg, mert azok a szerviz folyamat részei.

Helyszín

A helyszín a bizonylat típusától függ, mert a kiszállásos és a szerviz munkalap mást ért „helyszín“ alatt.

Kiszállásos munkalapon (ML, FE) a helyszín az a cím, ahol a munka történik. Akkor is megadható, ha eltér az ügyfél címétől: az AI a munkalapra írja, az ügyfél törzsadatát nem módosítja. Megadás nélkül az ügyfél elsődleges címe kerül a munkalapra.

Ha egy ügyfélnél több visszatérő telephely van, érdemesebb azokat az ügyfélhez felvenni (add_customer_address), mert onnan a felületen is választhatók.

Szerviz bizonylaton (SZ, SZF) a helyszín azt jelenti, hol javítják a gépet. Két eset van:

• A saját műhelyedben. Ez az alapértelmezés. Megmondhatod, melyik telephelyen: „vidd a soproni műhelybe“. Az AI a telephely nevét is elfogadja, ragozva is, és a list_service_locations művelettel meg tudja nézni, mid van. Ha nem mondasz semmit, az utoljára használt műhely kerül a munkalapra, pontosan úgy, mint a felületen. Telephely nélküli fióknál a cég címe.
• Az ügyfélnél, kiszállással (beépített gép, kazán, nagy berendezés). Ilyenkor mondd meg: „a javítás az ügyfélnél lesz“, és megadhatod a címet is. A munkalapon felvihető kiszállási díj, a bizonylatokra pedig az ügyfél címe kerül, nem a műhelyé.

Ez azért fontos, mert a műhely neve és címe több helyen megjelenik: az ügyfélnek küldött emailben (útvonaltervező gombbal), a munkalap PDF-jén, az átvételi jegyzőkönyvön és a számla megjegyzésében. A visszajelzésben az AI meg is nevezi, hova került a gép („Létrejött a(z) SZ-2026-0001 munkalap (szerviz, Sopron Műhely, …)“).

Kollégához rendelés

A munkalap kiosztható az AI-nak is, akár már létrehozáskor: „Nyiss munkalapot a Példa Kft.-nek, és add oda Péternek.“ Az AI ilyenkor előbb lekéri a csapattagok listáját, hogy tudja, kire gondolsz, ezért érdemes olyan nevet mondanod, ami a csapattag-listában szerepel.

Szerepkört is megadhatsz (fő felelős, felmérő, árajánlatkészítő, munkaszervező, kivitelező, kapcsolattartó); ha nem mondasz semmit, a kolléga fő felelős lesz. A hozzárendelt kolléga a szokásos értesítést kapja, és a munkalap megjelenik nála.

Átrendezésnél a megadott lista a végállapot: aki nincs benne, lekerül a munkalapról. Ha azt kéred, hogy „vedd le róla mindenkit“, minden hozzárendelés törlődik. A kiszállásokat tartalmazó munkalapon a kiosztás az egyes kiszállásokon történik, nem az összesítő munkalapon.

Csapat

Művelet	Típus	Leírás
list_team_members	olvasás	A munkaterület aktív csapattagjai: név, szerep, elérhetőség. Ebből tudja az AI, kire gondolsz, amikor kiosztod a munkát.

Ügyfelek

Művelet	Típus	Leírás
search_customers	olvasás	Keresés név, cég, e-mail, telefon vagy cím alapján.
find_customer_by_external_id	olvasás	Ügyfél keresése külső rendszerbeli azonosító alapján.
create_customer	írás	Új ügyfél létrehozása, akár több címmel.
update_customer	írás	Meglévő ügyfél adatainak módosítása.
add_customer_address	írás	Új cím hozzáadása az ügyfélhez.
update_customer_address	írás	Meglévő cím módosítása.
remove_customer_address	írás	Cím törlése. Emberi megerősítést kér.
set_primary_customer_address	írás	Elsődleges cím kijelölése.

Tételtörzs

Művelet	Típus	Mit csinál
search_materials	olvasás	Keresés a tételtörzsben név, cikkszám, vonalkód, gyártó vagy beszállítói elnevezés alapján.
check_stock	olvasás	Egy vagy több tétel aktuális készlete raktáranként és összesen, egy hívásban legfeljebb húsz.
create_material	írás	Egy vagy több tétel (anyag, munkadíj, kiszállás) felvétele a tételtörzsbe, egy hívásban legfeljebb ötven.

Ezek a műveletek a Pro csomagtól érhetők el, ahogy a készlet modul is; alacsonyabb csomagon meg sem jelennek az AI eszközei között.

A tipikus használat: a beszállítói árlistát megnyitod az AI-val, és megkéred, hogy a hiányzó termékeket vegye fel a törzsedbe, mielőtt az árajánlat összeáll. Amit tudni érdemes róla:

• Nem keletkezik duplikátum. A művelet előbb megnézi, van-e már ilyen tétel: azonos cikkszám, vagy cikkszám hiányában azonos név, egység és típus. Ha van, a meglévőt adja vissza, és nem hoz létre újat. Ha van cikkszámod, mindig add meg, mert a névre az egyezés kis- és nagybetű-érzékeny.
• Az eladási árat nem az AI találja ki. Ha csak a beszerzési árat adod meg, a rendszer a saját felár-beállításodból számolja az eladási árat, ugyanúgy, mint a bevételezésnél a felületen. Kikapcsolt felárnál a beszerzési ár lesz az eladási is.
• Készletet nem állít. Az árlistából nincs valós készletadat, ezért a művelet nem vezet be nyitókészletet és nem hoz létre készletmozgást. A bevételezés marad a felületen.
• Részleges siker látszik. Ha a kötegben van hibás sor (például érvénytelen ÁFA-kulcs), a többi tétel akkor is létrejön, és a válasz megmondja, melyik sorral mi történt.

Több száz soros árlistához a felület CSV-importja a gyorsabb út (Beállítások → Cég adatai → Import), ami egy menetben ötezer sort visz.

Keresés és készlet

A keresés ugyanazt a találati sorrendet adja, mint a felület keresőmezője, és a magyar összetett szavakat is kezeli: a „mágnesszelep“ a „szelep“ szóra is előjön. A cikkszámra és a vonalkódra viszont pontos egyezést vár, mert ott a részleges találat rossz terméket adna vissza. Kérdezhetsz úgy is, hogy „van-e már ilyen a törzsemben“, és úgy is, hogy „sorold fel a munkadíjaimat“.

A készlet külön művelet, és tudatosan az: a keresés a keresőindexből dolgozik, ami néhány perces késéssel követi a változásokat, a mennyiséget viszont nem szabad elavultan mondani. A check_stock ezért a raktári nyilvántartásból olvas, és raktáranként bontva adja vissza a mennyiséget, a foglalt darabszámmal és a tárolóhellyel együtt, jelezve azt is, hogy a készlet elfogyott, alacsony, rendben van vagy túlkészlet. Nem raktározott tételnél (munkadíj, kiszállás) és még be nem vételezett anyagnál nulla az eredmény.

Az AI nem tud készletet módosítani: bevételezni, kivételezni és korrigálni csak a felületen lehet.

Árajánlatok

Művelet	Típus	Mit csinál
create_quote	írás	Új árajánlat készítése egy meglévő ügyfélre, tételsorokkal.
list_quotes	olvasás	Árajánlatok listája szűrőkkel (státusz, ügyfél), lapozással.
get_quote	olvasás	Egy árajánlat teljes tartalma a tételsorokkal.

Az árajánlat minden csomagban elérhető, de a havi darabszám csomagfüggő (Ingyenes 3, Alap 20, Profi és Üzleti korlátlan), és a felületen készített ajánlatok is ebből a keretből fogynak. A keret betelte után az AI beszédes hibát kap, nem készül el az ajánlat.

Amit tudni érdemes róla:

• Az ajánlat piszkozat marad, és nem megy ki az ügyfélhez. A kiküldés, az elfogadás és az elutasítás a felületen történik, ahol látod is, mit küldesz. Az AI-kapcsolaton keresztül megosztási link sem keletkezik.
• Az árat a rendszer számolja. Az AI tételsorokat küld (megnevezés, mennyiség, egységár, ÁFA-kulcs), a végösszeget és az ÁFA-bontást a rendszer állítja elő, ugyanazzal a számítással, amit a felület használ. Így a beszélgetésben látott összeg és a kész ajánlat nem térhet el.
• Meglévő ügyfélre készül. Új ügyfélhez előbb a create_customer kell, a törzsből hiányzó termékekhez a create_material. A három művelet együtt adja ki a teljes folyamatot: ügyfél, tételek, ajánlat.
• Egy megismételt kérés nem duplikál. Ha az AI hálózati hiba után újraküldi ugyanazt, a már elkészült ajánlat jön vissza, nem készül második.

Az ajánlat nem tud egyedi kedvezményt, érdeklődős (ügyfél nélküli) ajánlatot és a piszkozattól eltérő státuszt: ezek a felület műveletei.

Ezen felül két erőforrás olvasható közvetlenül azonosító alapján: worksheet://{azonosító} és customer://{azonosító}. Ezek egy munkalap, illetve egy ügyfél teljes adatát adják vissza.

Amit az AI nem tud

Szándékosan kimaradt minden olyan művelet, amely visszafordíthatatlan pénzügyi vagy kifelé menő hatással jár. Az AI-kapcsolaton keresztül nem lehet: számlát kiállítani, véglegesíteni vagy sztornózni, ügyfelet vagy munkalapot törölni, e-mailt vagy SMS-t küldeni az ügyfélnek, pénzügyi tranzakciót rögzíteni, csapattag-jogosultságot módosítani, előfizetést vagy fiókbeállítást megváltoztatni.

Ezen kívül a következők egyelőre csak a felületen mennek, nem az AI-kapcsolaton: kiszállások (több részteljesítés egy munkalapon), fotó és rajz feltöltése, aláírás felvétele, meglévő munkalap tételeinek módosítása.

Kéréskorlát és havi keret

Az AI-forgalomra a csomag szerinti gépi hozzáférési korlát fele vonatkozik. A perc alapú korlát kapcsolatonként számít, a havi keret a teljes munkaterületre.

Csomag	Hívás percenként	Hívás havonta
Ingyenes	2	250
Basic	7	1 500
Pro	30	15 000
Business	60	75 000

Egy beszélgetés jellemzően több hívást is elindít (például keresés, majd a találat megnyitása), ezért alacsonyabb csomagon érdemes egyszerre egy dolgot kérni az AI-tól.

Az ismételt, azonos létrehozások nem fogyasztják a havi keretet: ha a hálózat elszáll és az AI-alkalmazás újraküldi ugyanazt a létrehozást, a rendszer felismeri, a már létrejött munkalapot vagy ügyfelet adja vissza, és nem számolja el másodszor. A percenkénti korlátba viszont minden hívás beleszámít, az ismételt is.

Biztonság és felügyelet

• Alapértelmezés szerint kikapcsolva. A hozzáférés két, egymástól független lépést kíván: a kapcsoló bekapcsolását és a csatlakozás engedélyezését.
• Csak a saját munkaterületed. A kapcsolat a belépett fiókhoz kötött, más munkaterület adata nem érhető el rajta.
• Emberi megerősítés. A visszafordíthatatlan műveletek (munkalap végleges státuszba állítása, ügyfélcím törlése) jóváhagyást kérnek. A Claude-ban ezt az OkosMunkalap saját megerősítő kérdése adja, a ChatGPT-ben az alkalmazás művelet-engedélyező párbeszéde. Ezért a ChatGPT-ben érdemes az írási műveleteket egyenként engedélyezni, nem automatikusan jóváhagyni.
• Auditnapló. Minden AI-művelet naplózódik, és a Beállítások, Integrációk oldal Audit napló nézetében visszanézhető: mit hívott, mikor, milyen eredménnyel és melyik AI-alkalmazás. A művelet paramétereiből a személyes adatok kitakarva kerülnek a naplóba.
• Leválasztás bármikor. A Beállítások, Integrációk oldalon látod az élő kapcsolatokat, és bármelyiket bonthatod. A visszavonás legfeljebb egy percen belül a már kiadott hozzáférési kulcsot is érvényteleníti.
• Te hagyod jóvá, alkalmazásonként. A hozzáférés az OkosMunkalap saját engedélyező oldalán keletkezik, ahol látod, melyik alkalmazás kéri és melyik munkaterülethez. Jóváhagyás nélkül semmilyen alkalmazás nem fér az adataidhoz.
• Csak a támogatott AI-alkalmazások. A szerver kizárólag a Claude és a ChatGPT visszairányítási címeire enged regisztrálni, ezért egy idegen alkalmazás akkor sem tudja megszerezni a hozzáférésedet, ha megtévesztő néven kérné.

Adatvédelem

Az összekötéssel a kiválasztott AI-szolgáltató (a Claude esetében az Anthropic PBC, a ChatGPT esetében az OpenAI) hozzáférést kap a lekérdezett adatokhoz. Ez a szolgáltató nem az OkosMunkalap adatfeldolgozója: az adatáramlást te kezdeményezed azzal, hogy a saját AI-fiókodat összekapcsolod, és a szolgáltató a veled kötött saját szerződése alapján jár el. Az ügyfeleid adatai tekintetében te vagy az adatkezelő, ezért a te felelősséged, hogy megfelelő jogalappal rendelkezz, és az érintetteket tájékoztasd.

A részleteket az Adatvédelmi Tájékoztató 4.19. pontja tartalmazza.

Hibaelhárítás

Amit látsz	Mit jelent és mit tegyél
„Az AI-célú felhasználás nincs engedélyezve ehhez a fiókhoz vagy kulcshoz.“	Az AI-felhasználás kapcsoló ki van kapcsolva. A csatlakozás ilyenkor is sikerül és a műveletek listája is betöltődik, de minden kérés ezzel a hibával áll meg. Kapcsold be a Beállítások, Integrációk oldalon, utána azonnal működik, újracsatlakozás nélkül.
„Ezt a műveletet csak tulajdonos vagy adminisztrátor végezheti.“	A fiókod nem tulajdonosi vagy adminisztrátori szintű a munkaterületen. Kérd meg a tulajdonost, hogy ő kösse össze a saját fiókját.
„A hozzáférés vissza lett vonva. Csatlakozz újra az OkosMunkalap engedélyezésével.“	A kapcsolatot leválasztották a Beállítások, Integrációk oldalon. Csatlakozz újra az AI-alkalmazásból.
„Túl sok kérés. Próbáld újra később.“	Elérted a perc alapú korlátot. Várj egy percet, vagy kérj egyszerre kevesebbet.
„Elérted a havi API hívás kereted.“	A munkaterület havi kerete elfogyott. A keret a hónap fordulóján áll vissza, vagy nagyobb csomaggal bővíthető.
Az AI azt írja, hogy megerősítés kell	Visszafordíthatatlan műveletet kértél. Erősítsd meg a felugró kérdésben, vagy mondd meg az AI-nak, hogy hajtsa végre megerősítéssel.
Az AI nem látja a műveleteket	A kapcsolat megszakadt vagy le lett választva. Nézd meg a Beállítások, Integrációk oldalon, és szükség esetén csatlakozz újra.
„A megadott redirect_uri nem engedélyezett.“	Az alkalmazás nem a Claude vagy a ChatGPT hivatalos visszairányítási címét használja. Ha a támogatott alkalmazások egyikéből próbálkozol és mégis ezt kapod, jelezd nekünk: a szolgáltató megváltoztathatta a címét.

Technikai részletek

Ez a rész azoknak szól, akik saját MCP-klienst építenének vagy a működést szeretnék pontosan ismerni.

Jellemző	Érték
Végpont	https://mcp.okosmunkalap.hu/mcp
Transport	Streamable HTTP (MCP 2025-11-25)
Hitelesítés	OAuth 2.1 Authorization Code + PKCE
Kliens-regisztráció	Dynamic Client Registration és Client ID Metadata Document, mindkettő a támogatott AI-szolgáltatókra korlátozva: a DCR csak a Claude és a ChatGPT visszairányítási címeit fogadja el, a CIMD pedig csak az ő domainjeikről tölt metadata dokumentumot. Saját, önállóan hosztolt MCP-kliens tehát jelenleg nem regisztrálható.
Metadata	/.well-known/oauth-protected-resource/mcp és /.well-known/jwks.json
Scope-ok	okm.read, okm.write (a write kumulatívan tartalmazza a readet)
Hozzáférési kulcs élettartama	15 perc, megújítható refresh tokennel

A létrehozó műveletek (ügyfél, munkalap, cím) újraküldés ellen védettek: a hívás tartalmából képzett kulccsal a rendszer felismeri az ismételt küldést, és determinisztikus azonosítóval dolgozik, így egy megismételt létrehozás nem eredményez második rekordot, és a válasz szövege is jelzi, hogy korábbi művelet eredményét kaptad vissza. A védelem ablaka öt perc: ennél később ugyanaz a kérés már szándékos új létrehozásnak számít, és új rekord jön létre. A módosító műveletek természetükből adódóan ismételhetők, mert ugyanazt az állapotot állítják be. A cím törlése az öt perces ablakon belül szintén a korábbi eredményt adja vissza, azon túl viszont „Nem található cím a megadott azonosítóval.“ hibát, hiszen a cím addigra már nincs meg.

Ha programozott, nem AI-vezérelt integrációt építesz, a REST API alkalmasabb: ott API kulccsal hitelesítesz, és a teljes végpontkészlet elérhető.