Cobra MCP Gateway – Felhasználói kézikönyv

1. Mi ez a funkció

A Cobra MCP Gateway lehetővé teszi, hogy egy AI-alkalmazás — jogosultsághoz kötve — közvetlenül tudjon Cobra-adatot lekérdezni: törzsadatokat (partnerek, termékek, munkatársak), bizonylatlistákat (véglegesített és piszkozat/előkészített állapotban is), a bizonylatok tételsorait, készletadatokat, egyenlegeket, és amit a Cobra rendszergazda az adott lekérdezéshez engedélyezett. Ehhez három dolog kell:

1. A saját cége rendszergazdája vagy Cobra-konzulense hozzáférést ad Önnek a Cobra Adminban.
2. Ön ezt a hozzáférést elfogadja a Cobra Connect portálon.
3. Ön a portálon tokent (hozzáférési kulcsot) hoz létre, és ezt beállítja az AI-kliensében.

A lekérdezhető adatok között bizonylatokhoz tartozó csatolmányok is vannak: az AI listázni, letölteni, és (legfeljebb 8 MB méretig) feltölteni is tud egy csatolmányt egy adott bizonylathoz. Ehhez nincs külön beállítás, ez a hozzáférésével automatikusan elérhető. Egy lekérdezés eredményét is kérheti fájlba mentve, ne csak a beszélgetésben megjelenítve — lásd lejjebb.

Eredmény mentése fájlba

Kérheti, hogy egy lekérdezés eredményét ne csak a beszélgetésben mutassa meg az AI, hanem mentse fájlba is — mondja meg, hogy exportálja, és milyen formátumban: TXT, CSV, XLSX, XML vagy JSON. Az XLSX formátum megtartja a dátum- és szám-típust, tehát a fájl Excelben utólag is szűrhető, rendezhető és összesíthető marad, nem csak nyers szöveg.

Webes AI-kliensből (pl. claude.ai) a fájl ugyanúgy érkezik, mint egy letöltött csatolmány, ugyanazzal a méretkorláttal (8 MB): alapból a portál Letöltések lapján várja Önt, vagy ha így állította be, a beszélgetésben kap rá linket (lásd a 3.1 szakaszt). Ha a lekérdezés eredménye ennél nagyobb lenne, szűkítse a szűrőket vagy kérjen kevesebb oszlopot.

2. Regisztráció és bejelentkezés a portálon

A regisztráció meghívásos: a portálon magában nem lehet fiókot nyitni egy e-mail cím és jelszó megadásával. A regisztrációt a Cobra asztali programjából indítja, a Beállítások / Felhasználói adatok / Webes AI asszisztens regisztráció menüpontból. Ez megnyit egy oldalt a böngészőjében, ahol megadja a nevét, az e-mail címét és a jelszavát. A menüpont a 2026.3-as programverziótól érhető el; ha nem találja, a cége rendszergazdája vagy Cobra-konzulense tud gondoskodni a frissítésről. A portál Hogyan regisztrálok lapja ugyanezt írja le, képpel.

Regisztráció után a rendszer megerősítő e-mailt küld a megadott címre; a fiók csak a benne lévő linkre kattintva aktiválódik. A kétfaktoros hitelesítés (2FA) beállítása minden fióknál kötelező — bejelentkezés után a rendszer a jelszó megadása után automatikusan a 2FA-beállító oldalra irányítja, és amíg ezt nem állítja be, más oldalt nem tud használni.

A 2FA beállításakor egy authenticator-alkalmazással (pl. Microsoft Authenticator, Google Authenticator) beolvasandó QR-kódot lát, és a rendszer egyszeri helyreállítási kódokat is ad.

Elfelejtett jelszó. A belépő oldalon az Elfelejtett jelszó gombbal kérhet visszaállító linket: adja meg a fiókjához tartozó e-mail címet, és a rendszer elküldi rá a linket. A link 24 óráig érvényes, és egyszer használható; ha lejárt, kérjen újat. A lap ugyanazt a választ adja akkor is, ha a címhez nem tartozik fiók, így nem árulja el, kinek van itt fiókja. Ha nem találja a levelet, nézze meg a levélszemét mappát is.

3. A portál felépítése

Bejelentkezés után a felső menüsorban ezeket találja:

Nincs külön "Fiók" menüpont a felső sorban — a saját nevére kattintva a jobb felső sarokban éri el a fiókbeállításokat, és itt kezeli az email-címeit is (ez sincs külön lapon). A fiókbeállításokat a 3.2 szakasz írja le.

3.1 Letöltések: hogyan kapja meg a fájlt

Amikor az AI egy csatolmányt tölt le Önnek a Cobrából, vagy egy lekérdezés eredményét fájlba menti, a fájl a Letöltések lapon a Hogyan kapja meg a linket beállítás szerint érkezik:

A beállítást a lapon a Link a beszélgetésbe, illetve a Csak a portálon gombbal váltja. A váltás csak az új fájlokra hat: egy már kiadott link úgy viselkedik tovább, ahogyan a kiadásakor szólt. A váltás a Biztonsági naplóban is megjelenik.

A Várakozó fájlok listájában a már egyszer letöltött, beszélgetésbe kiadott fájl Már letöltve jelöléssel marad látható.

3.2 Fiókbeállítások: e-mail címek, nyelv, felfüggesztés, törlés

A saját nevére kattintva megnyíló Fiók lapon ezeket kezeli:

• E-mail címek. Több címet is a fiókjához rendelhet; mindegyiket külön kell igazolni a kiküldött linkkel. Belépni bármelyik igazolt címével tud, az értesítések az elsődleges címre érkeznek. Egy igazolt címet a Legyen elsődleges gombbal tehet elsődlegessé.
• Portál-azonosító. Itt látja a személyes portál-azonosítóját (CCN-...), másoló gombbal. Ezt adja meg a cége rendszergazdájának vagy Cobra-konzulensének. Ez nem token, bátran továbbadhatja; a tokent soha ne adja tovább.
• Nyelv. A Nyelv kártyán választhat a magyar és az angol között. A portál minden belépés után ezen a nyelven jelenik meg, és a portál leveleit is ezen a nyelven kapja. Amíg nem választ, a portál a böngésző nyelvét követi.
• Fiók felfüggesztése. Ideiglenesen leállítja a hozzáféréseit: minden tokenje azonnal érvénytelenné válik, a már futó AI-alkalmazások is elvesztik a hozzáférést a következő kéréskor, a böngésző-munkameneteiből kilépteti a rendszer, és új tokent nem tud kiadni. Semmi nem törlődik: a tokenjei, címei és hozzáférései megmaradnak, a licenctulajdonosoknál lévő hozzáférései sem szűnnek meg. Bármikor visszakapcsolhatja: lépjen be, és a Visszakapcsolom a fiókomat gombbal minden úgy működik, ahogy korábban.
• Fiók törlése. VÉGLEGES, nem vonható vissza. A megerősítéshez be kell írnia az elsődleges e-mail címét. Minden tokenje azonnal érvénytelenné válik, az e-mail címei lekerülnek a fiókról (egy későbbi regisztrációhoz újra felhasználhatók), a személyes portál-azonosítója visszavonásra kerül, és a licenctulajdonosoknál lévő hozzáférései megszűnt személyként jelennek meg. A biztonsági naplója megmarad. Ha csak egy időre állítaná le a hozzáféréseit, a felfüggesztést válassza.

4. Hozzáférés elfogadása

Ha a cége rendszergazdája hozzáférést hozott létre Önnek egy Cobra-cégéhez, az a Hozzáférések lapon jelenik meg "Függőben — válaszra vár" állapotban. Nyissa meg, és fogadja el (Elfogadom) vagy utasítsa el (Elutasítom) gombbal. Elfogadás nélkül a hozzáférés nem működik AI-kliensből.

Ha a hozzáférést visszavonják, a sor megmarad a listában "Visszavonva" jelöléssel — ez a hozzáférés múltjának nyoma, nem aktív hozzáférés. Ha újra megadják Önnek, ismét el kell fogadnia, mielőtt működne.

5. Licenc kezelése (csak licenc-adminisztrátoroknak)

Ha Ön a cége Cobra-licencének adminisztrátora, a Licenceim menüpontban a licenc adatai mellett két további dolgot is kezelhet: ki adminisztrálhatja Önnel együtt a licencet, és a licenchez tartozó gépeket.

Fontos, hogy licenc-adminisztrátorrá válni ma nem önkiszolgáló — ezt a Cobra ügyfélszolgálata állítja be, nem lehet a portálról valakit meghívni erre a jogra.

5.1 Licenc adminisztrátorok

A "Licenc adminisztrátorok" táblázat mutatja, kik látják/kezelhetik Önnel együtt ezt a licencet a portálon: Személy, Portál-azonosító, Állapot (aktív vagy visszavonva), Megadva (dátum).

5.2 Gépek: felfüggesztés, kizárás, visszakapcsolás

A licenchez tartozó gépek listájában minden gépnél elérhető, állapottól függő műveletek:

• Felfüggesztés: a gép leáll, de a hozzáférési kulcsa megmarad — Visszakapcsolás után azonnal működik, nincs mit újratelepíteni.
• Kizárás: a gép leáll, ÉS a hozzáférési kulcsát is visszavonja a rendszer. Ez is visszakapcsolható, de utána a Cobra Licenckezelőből új kulcsot kell kiadni a gépnek, különben nem tud csatlakozni.

5.3 Gép megosztása másik licenccel

Ha ugyanazt a gépet egy másik licenchez is be kell léptetni (pl. egy közös géppel dolgozó két cég), a "Megosztás megnyitása" gombbal engedélyezheti ezt. Enélkül a másik licenc beléptetése hibával elutasul, akkor is, ha ismeri a gépazonosítót.

6. Tokenek és csatlakoztatott alkalmazások

6.1 Token létrehozása AI-klienshez

A Tokenek menüpontban:

1. Kattintson Új token létrehozására.
2. Adjon neki egy megnevezést (pl. "Claude Desktop, otthoni gép"), hogy később tudja, melyik kliensé.
3. Válasszon lejárati időt (30, 90, 180 vagy 365 nap).
4. Létrehozás után a token értéke egyszer, azonnal megjelenik.

Ne adja ki a token értékét senkinek telefonon vagy emailben — ez a hozzáférési kulcsa.

6.2 Saját tokenjei és Alkalmazások tokenjei

A Tokenek lap két listára bomlik:

• Saját tokenjei: amit Ön adott ki kézzel, és lemásolt egy alkalmazásba.
• Alkalmazások tokenjei: ezeket a csatlakoztatott alkalmazások (Claude, ChatGPT) hozzák létre maguknak, és óránként lecserélik — ezekkel nem kell törődnie, nem Ön hozta létre őket.

Alapból csak az élő kapcsolatok és érvényes tokenek látszanak. A "A bontott kapcsolatok és a lejárt tokenek is" gombbal a korábbi, már lejárt/visszavont sorok is megjeleníthetők — semmi nem törlődik fizikailag, csak el van rejtve.

Egy tokenhez a rendszer megjegyezheti, melyik céget használta vele legutóbb — ha ezt szeretné törölni anélkül, hogy magát a tokent visszavonná, a "Cég elfelejtése" gombot használja: ez csak a megjegyzett céget törli, a token érvényes marad, a következő munkamenet újra cégválasztással indul.

6.3 Csatlakoztatott alkalmazások

Ha egy AI-kliens (pl. Claude) egyszer bejelentkezett OAuth-on keresztül, utána bejelentkezés nélkül is visszatérhet, amíg Ön nem bontja a kapcsolatot.

Ha egy alkalmazást ténylegesen ki akar zárni, a "Kapcsolat bontása" gombot használja a "Csatlakoztatott alkalmazások" szekcióban — ez magát az engedélyt vonja vissza, nem csak egy tokent: az alkalmazás nem tud új tokent váltani magának, és csak akkor tud visszatérni, ha Ön újra bejelentkezik nála.

7. AI-kliens beállítása — a legfontosabb rész

A Cobra MCP Gateway végpontja (amit az AI-kliensben be kell állítani):

https://<a Cobra MCP Gateway publikus címe>/mcp

A pontos címet a Cobra rendszergazdájától vagy ügyfélszolgálatától kapja meg — ez cégenként/telepítésenként más.

A hitelesítés egy egyedi HTTP-fejlécen keresztül történik, nem a szokásos "Authorization: Bearer" fejlécen:

x-api-key: <az Ön tokenje>

7.1 Beállítás claude.ai-ban

1. Nyissa meg a claude.ai Beállítások → Connectors (Csatlakozók) menüjét.
2. Válassza az Add custom connector (Egyedi csatlakozó hozzáadása) lehetőséget.
3. Adja meg a végpont URL-jét (lásd fent).
4. A Request headers (Kérésfejlécek) szekcióban adjon hozzá egy fejlécet:
   • Fejléc neve: x-api-key
   • Fejléc értéke: az Ön tokenje (lásd 6.1 pont)
   • Jelölje Required-nek (kötelezőnek), különben Claude nem küldi el minden kéréssel.
5. Mentse el, és csatlakoztassa a connectort a beszélgetésben.

Claude.ai a fejléc-neveket egy engedélyezett listából fogadja el biztonsági okból; az x-api-key ezen a listán szerepel, tehát ez a beállítás támogatott.

7.2 Beállítás ChatGPT-ben

A ChatGPT egyedi MCP-csatlakozói OAuth-alapú kapcsolódást várnak, és a Cobra MCP Gateway ezt támogatja — a statikus tokenes út mellett, nem helyette. Tehát a bekötés nem igényel fejlesztést.

1. Nyissa meg a ChatGPT Settings → Apps → Advanced settings menüjét, és engedélyezze a Developer mode-ot.
2. Adja hozzá az egyedi MCP-csatlakozót, és adja meg a végpont URL-jét (lásd fent).
3. Válassza az OAuth hitelesítést. A ChatGPT innen magától elvégzi a többit: a Gateway szabványos felderítő végpontot szolgál, ahonnan a hitelesítési és token-címet, valamint a kliens-regisztrációt kiolvassa.
4. A megjelenő bejelentkező oldalon lépjen be a Cobra Connect portál fiókjával, és hagyja jóvá a hozzáférést.

7.3 Helyi (asztali) használat

Ha nem távoli AI-klienst, hanem a Cobra gépén futó Cobra.MCPServer.exe-t használja helyi (stdio) módban, a fenti webes beállítás nem érvényes — ott a helyi rendszergazda/konzulens állítja be a kapcsolatot. Mindkét esetben ajánlott a Cobra.MCPServer.ClientInstructions.md dokumentumban található, kész rendszerinstrukciót bemásolni az AI-kliens rendszer- vagy projektinstrukciói közé — ez segít, hogy az AI konzisztensen és biztonságosan használja a Cobra-eszközöket.

8. Ismerős üzenetek a válaszokban

Két olyan válasz-szöveget érdemes felismerni, amit az AI-kliens időnként megjelenít (angolul, mert ez a Cobra MCP Gateway hibaüzenete, amit az AI csak továbbad vagy összefoglal):

"A gép már annyi cégmunkamenetet futtat, amennyit enged... Ne válasszon céget újra... Várjon kb. egy percet." Ez azt jelenti, hogy a cége Cobra-gépe pillanatnyilag a maximális kapacitásán fut (túl sokan dolgoznak rajta egyszerre AI-kliensből). Ez átmeneti, és nem a hozzáférésével van baj.

"A kapcsolat megszakadt, amíg ez a hívás futott, ezért az eredménye ismeretlen. Kérdezzen újra..." Ez azt jelenti, hogy a kérése közben szakadt meg a kapcsolat a géppel, ezért a rendszer NEM tudja, lefutott-e a művelet vagy nem — ezért nem ismétli meg automatikusan (egy könyvelési vagy feltöltési műveletet kockázatos lenne kétszer lefuttatni). Kérdezzen újra, a kiválasztott cége megmarad, a kapcsolat automatikusan helyreáll.

9. Amikor az AI bizonylatot ír Önnek

Az AI-kliense — ha erre jogosultsága van — nem csak lekérdezni tud Cobra-adatot, hanem létre is tud hozni bejövő (szállítói) számlát, kimenő (vevői) számlát, vegyes (szabad) bizonylatot, pénztárbizonylatot, rendelést, teljesítést (szállítólevelet) vagy készletmozgást, ha megkéri rá. Ezt érdemes néhány dologgal együtt tudni.

Amit ez jelent:

• Amikor megkéri az AI-t, hogy vegyen fel egy számlát vagy pénztárbizonylatot, a bizonylat mindig előkészített (piszkozat) állapotban jön létre — soha nem véglegesen. A véglegesítés az Ön (vagy a könyvelője) döntése marad, a Cobra felületén.
• Ha valamit rosszul ad meg (pl. nem létező partnert vagy hibás adatot), az AI nem hoz létre félkész vagy hibás bizonylatot — a rendszer visszaad egy pontos listát arról, mit kell javítani, és eddig semmi nem került rögzítésre.
• Az AI csak azokhoz az állományokhoz (bizonylattömbökhöz) tud írni, amelyekhez Önnek — pontosabban annak a Cobra-felhasználónak, akinek a nevében az AI dolgozik — módosítási joga van. Ha nincs jogosultsága egy adott állományhoz, a kérés elutasításra kerül, és semmi nem jön létre.
• A kimenő (vevői) számlának két fajtája van, és ha egyértelműen nem mondja meg, melyiket kéri, az AI rá fog kérdezni: a valódi vevői számla, aminek a véglegesítése sorszámot ad és elindítja a NAV felé az online számla-jelentést — ez a legtöbb esetben az, amit keres —, illetve egy egyszerűbb, kizárólag belső pénzügyi nyilvántartási bizonylat, ami NEM jelentődik a NAV-nak. Ha bizonytalan, melyiket szeretné, mondja meg egyszerűen, hogy "állítsak ki egy számlát a vevőnek" — az AI ilyenkor a valódi számlát fogja javasolni.
• A készletmozgás a legkényesebb ezek közül — egy hibásan megadott mozgás nemcsak egy bizonylatot ront el, hanem a raktár nyilvántartott készletértékét is elmozdítja. Érdemes itt különösen pontosan fogalmazni (melyik raktár, milyen irányba, mennyi), és a felvitt piszkozatot még alaposabban átnézni véglegesítés előtt, mint egy számlánál.
• Az AI ismeri a saját cége adatait (nevét, adószámát, székhelyét, bankszámláit) — nem kell Önnek begépeltetnie, amikor ezekre egy bizonylat kiállításakor szükség van. Ez nem külön jogosultsághoz kötött: ezek a cégjegyzékben is nyilvános adatok, ezért bárki lekérdezheti, aki a cégben az AI-hoz hozzáfér.

Amit ez NEM jelent:

• Az AI nem véglegesít és nem könyvel bizonylatot — ezt mindig kézzel kell elvégezni.
• Az AI nem tud olyan bizonylatot létrehozni, aminek eleve sztornó az állapota, vagy aminek a fajtáját (pl. eleve véglegesített) Ön adná meg — ezt a rendszer szándékosan nem engedi.
• Ez nem helyettesíti a könyvelői ellenőrzést — az AI által felvitt piszkozatot ugyanúgy át kell nézni, mint egy kézzel felvitt piszkozatot, mielőtt véglegesítik.

10. Amikor az AI feladatot vagy eseményt rögzít Önnek

Az AI-kliense a bizonylatokon kívül feladatot is ki tud adni vagy le tud zárni, és eseménynapló-bejegyzést (pl. egy telefonhívás vagy egyeztetés rögzítését) is tud írni Önnek vagy egy partnerhez, ha megkéri rá.

• Feladat kiadásakor az AI alapból nem küld értesítő e-mailt a címzettnek — csak akkor, ha Ön kifejezetten kéri. Ez szándékos eltérés attól, ahogy a Cobra felülete viselkedik: egy AI-nak kiadott feladatnál nem szeretnénk, hogy magától levelet küldjön ki valakinek az Ön háta mögött.
• Feladat lezárásakor vagy állapotváltásakor ez fordítva van: az AI alapból küld értesítő levelet, ugyanúgy, ahogyan a Cobra normál működése is tenné. Ha ezt nem szeretné, mondja meg az AI-nak.
• Minden, amit az AI ír az eseménynaplóba, "AI asszisztens" jelleggel kerül be — ez egy külön, a felületen is látható és szűrhető jelzés, tehát bárki, aki később a naplót nézi, látni fogja, hogy azt a sort nem ember gépelte be kézzel.

11. Gyakran ismételt kérdések

Elfelejtettem a jelszavamat. A belépő oldalon az Elfelejtett jelszó gombbal kérjen visszaállító linket — lásd a 2. szakaszt. A link 24 óráig érvényes.

Elvesztettem az authenticator-alkalmazásomat és a helyreállítási kódjaimat is. Erre ma nincs önkiszolgáló út, és az új jelszó sem segít. Jelezze a Cobra ügyfélszolgálatának, hogy nyilvántartsák az igényét.

Nem látom a cégem a portálon. Nézze meg a Hozzáférések lapot — ott minden saját hozzáférését látja, minden állapotban. Ha ott sincs semmi, még nem hoztak létre hozzáférést az Ön részére; kérje meg a cége rendszergazdáját vagy Cobra-konzulensét, hogy a Cobra Adminban adja meg a hozzáférést az Ön portál-azonosítójával (a saját nevére kattintva, a fiókbeállításoknál találja, bejelentkezve pedig a kezdőlapon is, másoló gombbal).

Elvesztettem a token értékét. Nem kérhető le újra — hozzon létre új tokent a Tokenek menüpontban, és a régit törölje/cserélje le az AI-kliensében.

Mekkora fájlt tölthetek fel/le csatolmányként? Legfeljebb 8 MB méretűt. Ha egy csatolmány ennél nagyobb, a feltöltés/letöltés hibaüzenettel elutasul.

Az AI azt írja, hogy a fájl a portálon vár. Hol találom? A portál Letöltések lapján, a Várakozó fájlok között, 24 óráig. Ha inkább a beszélgetésben kapná a linket, ugyanott állítsa át — lásd a 3.1 szakaszt.

Hogyan mentsem el egy lekérdezés eredményét fájlba? Mondja meg az AI-nak, hogy exportálja fájlba a kívánt formátumban (TXT, CSV, XLSX, XML vagy JSON) — lásd az 1. szakaszt. Az eredmény ugyanolyan 8 MB-os méretkorláttal jön, mint a csatolmányok.

Hogyan állíthatom a portált angolra (vagy vissza magyarra)? A Fiók lapon, a Nyelv kártyán — lásd a 3.2 szakaszt. A választott nyelven kapja a portál leveleit is.

Nulla érvényes tokent látok az "Alkalmazások tokenjei" listában, mégis működik a Claude — ez hiba? Nem hiba. A csatlakoztatott alkalmazás kapcsolatát a frissítő token tartja életben (kb. 30 napig), nem az óránként cserélődő hozzáférési token — lásd a 6.3 szakaszt. Nézze meg inkább a "Csatlakoztatott alkalmazások" listát, ott "Csatlakoztatva" állapotot fog látni.

Véletlenül kizártam egy gépet a Licenceim lapon, mit tegyek? Kapcsolja vissza a Visszakapcsolás gombbal, majd adjon ki neki új kulcsot a Cobra Licenckezelőben — kizárás után a régi kulcs már nem érvényes, lásd az 5.2 szakaszt.

Az AI tud véglegesíteni vagy könyvelni egy bizonylatot, amit felvitt? Nem. Az AI kizárólag előkészített (piszkozat) bizonylatot tud létrehozni — a véglegesítés mindig kézi lépés a Cobra felületén. Lásd a 9. szakaszt.

Kap-e e-mailt a kollégám, ha az AI-val adok ki neki egy feladatot? Alapból nem — feladat kiadásakor az AI szándékosan nem küld levelet, csak ha kifejezetten kéri. Ha viszont az AI zár le vagy módosít egy már meglévő feladatot, arról alapból megy értesítés, ugyanúgy, mint amikor Ön teszi ezt a Cobra felületén. Lásd a 10. szakaszt.