AI-asszisztens csatlakoztatása
Hogyan kötöd a Terepbázist a Claude-hoz, a ChatGPT-hez vagy a Claude Code-hoz: hova kattints, mit írj be, mit látsz a hozzájárulás-lapon, és hogyan vonod vissza a hozzáférést.
Mire jó, és mit kell előtte tudni
Ha az AI-asszisztensedet (Claude vagy ChatGPT) összekötöd a Terepbázissal, rákérdezhetsz a cég adataira a saját beszélgetésedben: munkalapokra, ügyfelekre, ajánlatokra, termékekre, készletre és szerződésekre. Ha külön engedélyt adsz rá, az asszisztens rekordot is létrehozhat vagy módosíthat. Ehhez nem kell kulcsot másolgatnod: az asszisztens a saját beállításaiban csatlakozik, te pedig a Terepbázisba belépve engedélyezed.
A kiszolgáló címe (ezt kell beírnod)
https://mcp.terepbazis.net/mcp
Pontosan így, https-sel és a végén az /mcp résszel. Ugyanez a cím látszik a Beállítások → Konnektorok oldal tetején, az AI-asszisztens csatlakoztatása kártyán, a Másolás gombbal. Ott a Csatlakoztatás Claude-hoz és a Csatlakoztatás ChatGPT-hez gomb a címet a vágólapra másolja, és új lapon megnyitja a gyártó oldalát.
- Be kell tudnod lépni a Terepbázisba. A hozzájárulás-lap böngészőben nyílik meg, a Terepbázis mobilalkalmazásában nem működik.
- Hozzáférést a cég tulajdonosa, adminisztrátora, irodai adminisztrátora, értékesítője és raktárosa adhat. Szerelő szerepkörrel nem lehet jóváhagyni.
- A hozzáférés cégenként külön van megadva: a hozzájárulás-lapon kiválasztod, melyik cég adataihoz kapcsolódik az asszisztens.
- Az asszisztens csak azt látja és csinálja, amit a hozzájárulás-lapon engedélyeztél. Alapból csak olvasási jogosultságok vannak bepipálva.
Mi történik belépéskor és a hozzájárulás-lapon
Ez a rész mindhárom asszisztensnél ugyanaz, mert a hozzájárulás-lapot a Terepbázis adja. Amikor az asszisztensben a csatlakozásra kattintasz, megnyílik a Terepbázis oldala egy böngészőablakban vagy lapon.
- Ha nem vagy belépve, a Terepbázis belépő oldala jön. Jelentkezz be a szokásos módon (ha nálad be van kapcsolva a kétlépcsős azonosítás, azt is el kell végezned). Belépés után a rendszer visszavisz a hozzájárulás-lapra.
- A lap címe: „<az asszisztens neve> hozzáférést kér”. Alatta a Visszatérési cím látszik (Claude-nál claude.ai, ChatGPT-nél chatgpt.com).
- Ellenőrizd, hogy TE indítottad-e a csatlakozást az asszisztensben. Ha nem, kattints a Megtagadás gombra. A lap erre külön figyelmeztet is.
- A Cég mezőben válaszd ki, melyik cég adataihoz kapcsolódjon az asszisztens. Ha csak egy céged van, itt az van kiválasztva.
- A Jogosultságok listában pipáld be, mit tehet az asszisztens (lásd az alábbi táblázatot). Alapból csak olvasási jogosultságok vannak bepipálva (azok, amelyeket az asszisztens kért). Legalább egy jogosultságot ki kell választani.
- Kattints az Engedélyezés gombra. A böngésző visszavisz az asszisztenshez, és a kapcsolat kész.
| Csoport | Mit jelent | Alapból? |
|---|---|---|
| Olvasás | Munkalapok, ügyfelek, ajánlatok, termékek, készlet és szerződések megnézése. | Alapból bepipálva (a kért olvasások) |
| Írás | Munkalap létrehozása és módosítása, ügyfelek és termékek létrehozása és módosítása, ajánlat-piszkozatok írása, készletmozgás rögzítése, szerződések létrehozása és módosítása. | Külön pipa kell |
| Ütemezés | Munkalapok ütemezése. Ez értesítést küld, ezért külön engedély. | Külön pipa kell |
| Törlés | Ügyfelek, termékek (archiválás), munkalapok, ajánlat-piszkozatok és szerződések TÖRLÉSE. Ha bepipálod, a lap piros figyelmeztetést mutat („Törlési jogot adsz”). | Külön pipa kell |
Ha azt látod: „A kérés lejárt”
A hozzájárulási kérés rövid életű, és csak egyszer használható. Ha a lap ezt írja, nem rontottál el semmit: indítsd újra a csatlakozást az asszisztensben, és jön egy új kérés. Ha a jóváhagyásnál azt látod, hogy ehhez a céghez nincs jogosultságod hozzáférést adni, kérd meg a cég tulajdonosát vagy adminisztrátorát.
Claude.ai (web és asztali alkalmazás)
A Claude-ban a Terepbázis egyéni konnektorként (custom connector) vehető fel. Ez a Free, Pro, Max, Team és Enterprise csomagokban is elérhető; Free csomagban egyetlen egyéni konnektort adhatsz hozzá. A Claude-ot az Anthropic dokumentációjának angol nyelvű változata alapján írjuk le, ezért a menüfeliratokat angolul adjuk meg. A párbeszédablak elrendezése szervezetenként is eltérhet; ha a te felületed felirata más, a menü szerkezete akkor is ugyanez.
Egyéni (Free, Pro, Max) fiókkal:
- Nyisd meg a Claude-ot (a böngészőben, vagy az asztali alkalmazásban), és jelentkezz be.
- Menj a Customize > Connectors oldalra.
- Kattints a + Add gombra, majd az Add custom connector pontra. (Egyes fiókoknál közvetlenül az Add custom connector gomb látszik: a felirat eltérhet.)
- A névhez írd be: Terepbázis. Ez a név látszik majd a konnektorok listájában.
- A szerver címéhez (MCP server URL) írd be: https://mcp.terepbazis.net/mcp, majd kattints a Continue gombra.
- A Claude megmutatja a felismert hitelesítési beállításokat. Általában nem kell rajtuk változtatni. Ha választanod kell, az Authentication mezőben a Sign in now illik a Terepbázishoz: ilyenkor mindenki a Terepbázis saját bejelentkezésén át, a saját fiókjával csatlakozik. Az OAuth client mezőben hagyd az ajánlott Use Claude’s published identity (Recommended) értéket; ha a csatlakozás ezzel nem sikerül, próbáld a Register automatically értéket.
- A Request headers részt hagyd üresen: erre csak a kulcsos (haladó) módnál van szükség, lásd lent.
- Kattints az Add gombra.
- A konnektor megjelenik a Customize > Connectors listában. Kattints a Connect gombra: megnyílik a Terepbázis, és a fenti hozzájárulás-lap vár (belépés, cég, jogosultságok, Engedélyezés).
Team vagy Enterprise csomagnál a konnektort a szervezetben egy Owner veszi fel, nem a tagok. Enterprise csomagnál az Owner mellett az is felveheti, akinek az egyéni szerepköre tartalmazza a könyvtárak kezelését (Manage access to Libraries). Az Owner lépései:
- Menj az Organization settings > Connectors oldalra.
- Kattints az Add gombra, vigyél az egeret a Custom fölé, és válaszd a Web pontot.
- Add meg a nevet (Terepbázis) és a címet (https://mcp.terepbazis.net/mcp), majd haladj tovább a Continue gombbal. A hitelesítési beállításoknál az egyéni fiókos lépések szerint járj el.
- Fejezd be az Add gombbal.
Utána minden tag a saját fiókjával csatlakozik: Customize > Connectors, megkeresi a Custom címkés Terepbázis sort, és rákattint a Connect gombra. Így mindenki csak azt látja, amit a saját Terepbázis-jogosultsága és a hozzájárulás-lapon adott engedélye megenged.
Használat egy beszélgetésben
Egy beszélgetésben a bal alsó + gombra kattintva, majd a Connectors pontot választva kapcsolhatod be vagy ki a Terepbázis konnektort. A Customize > Connectors oldalon az egyes eszközök (tool) engedélyét is szabályozhatod, például a nem kívánt eszközt Blocked értékre állíthatod.
Fontos: a Claude-ban a konnektor nevét és címét utólag szerkesztheted, a hitelesítési beállításait (OAuth, fejlécek) viszont nem. Ha ezeken változtatnál, töröld a konnektort (Remove), és vedd fel újra; a tagoknak ilyenkor újra kell csatlakozniuk.
ChatGPT
A ChatGPT-ben a Terepbázis egyéni MCP-szerverként vehető fel, a ChatGPT Plugins oldalán. Ez az OpenAI oldalán új, még alakuló funkció, ezért a feliratok idővel változhatnak. Az alábbi lépéseket 2026. október 8-án egy ChatGPT Plus fiókkal végigcsináltuk: a csatlakozás és a lekérdezés is működött.
Milyen csomag kell hozzá
Webes ChatGPT kell: az OpenAI súgója szerint a mobilalkalmazásban az egyéni MCP-szerverek nem érhetők el. Plus csomaggal kipróbáltuk, működik. Az OpenAI súgója szerint Pro csomagban olvasási jogosultsággal lehet csatlakoztatni, Business és Enterprise/Edu munkaterületen pedig a teljes MCP, az írással együtt, bétaként érhető el, és ott a munkaterület beállításai korlátozhatják. Az ingyenes csomagról nem tudunk.
Így csatlakoztattuk (ChatGPT Plus, 2026. október 8.):
- A Terepbázisban nyisd meg a Beállítások → Konnektorok oldalt, és kattints a Csatlakoztatás ChatGPT-hez gombra. A gomb a vágólapra másolja a címet, és megnyitja a ChatGPT Plugins oldalát.
- A Plugins oldalon jobb felül kattints az Add gombra, majd az Add custom MCP server pontra.
- A Name mezőbe írd be: Terepbázis. A Description mező nem kötelező.
- A Connection alatt maradjon a Server URL, és illeszd be a címet: https://mcp.terepbazis.net/mcp
- Az Authentication maradjon OAuth.
- Olvasd el a kockázati figyelmeztetést, pipáld be az I understand and want to continue jelölőt, és kattints a Create as a plugin gombra.
- Ha a ChatGPT nem kéri magától a belépést, a Terepbázis plugin oldalán kattints a Connect gombra.
- A Connect Terepbázis ablakban kattints a Continue to Terepbázis gombra. Megnyílik a Terepbázis hozzájárulás-lapja (a Visszatérési cím chatgpt.com): jelentkezz be, válaszd ki a céget és a jogosultságokat, majd kattints az Engedélyezés gombra.
- A ChatGPT visszajelzi, hogy a fiók csatlakozott. A Try in chat gombbal vagy egy új beszélgetésben a @ jellel válaszd ki a Terepbázis plugint, és kérdezz.
Business vagy Enterprise/Edu munkaterületen az OpenAI súgója egy másik utat is leír (Apps): ott az adminisztrátor kapcsolja be a fejlesztői módot (Developer mode), és a Workspace settings → Apps → Create oldalon veszi fel az appot ugyanezzel a címmel és OAuth-tal, a Scan Tools gombbal. Ha a te munkaterületed így van beállítva, kérd meg az adminisztrátort.
- A ChatGPT agent módja nem használ egyéni appokat, a mély kutatás (deep research) pedig csak olvasásra, írásra nem.
- Ha a ChatGPT egy idő után újra belépést kér, csatlakozz újra: a hozzájárulás-lap ugyanaz, mint első alkalommal.
Amit őszintén meg kell mondani
A ChatGPT felülete gyorsan változik, ezért a pontos feliratok a te fiókodban eltérhetnek a fentiektől. Azt biztosan tudjuk, hogy a szerver címe https://mcp.terepbazis.net/mcp, hogy a hitelesítés OAuth, és hogy a Terepbázis hozzájárulás-lapja a fent leírt módon jelenik meg. A biztos lezárás a Terepbázisban végzett visszavonás (lásd lent).
Claude Code
A Claude Code a terminálban (és az IDE-bővítményekben) futó fejlesztői eszköz. Itt a kiszolgálót egy paranccsal veszed fel, a jóváhagyást pedig böngészőben, a Terepbázis hozzájárulás-lapján adod meg.
- Nyiss egy terminált ott, ahol a Claude Code telepítve van.
- Add ki ezt a parancsot: claude mcp add --transport http terepbazis https://mcp.terepbazis.net/mcp (a terepbazis név tetszőleges, ez a neve a kiszolgálónak a Claude Code-ban).
- Alapból a kiszolgáló csak neked és csak az aktuális projektben érhető el (local). Ha minden projektedben szeretnéd, tedd a parancs végére: --scope user.
- Indítsd el a Claude Code-ot, és add ki a /mcp parancsot. Válaszd ki a terepbazis kiszolgálót, és kezdd el a bejelentkezést. (Parancssorból ugyanezt a claude mcp login terepbazis parancs végzi el.)
- Megnyílik a böngésző a Terepbázis hozzájárulás-lapjával. Itt a Visszatérési cím a saját gépedet jelöli (localhost és egy portszám). Jelentkezz be, válaszd ki a céget és a jogosultságokat, majd Engedélyezés. A Claude Code a kiszolgáló által kért olvasási jogosultságokat kéri (munkalapok, ügyfelek, ajánlatok, termékek): ha a készletet vagy a szerződéseket is olvasni szeretnéd, pipáld be őket kézzel.
- Ha a böngésző nem nyílik meg magától, másold ki a Claude Code által kiírt címet, és nyisd meg kézzel. Ha az átirányítás hibával végződik, másold be a böngésző címsorából a teljes visszahívási címet (callback URL) a Claude Code-ban megjelenő mezőbe.
- Ellenőrzés: a claude mcp list parancs a terepbazis sor mellett ✔ Connected állapotot mutat.
Ha már felvetted a Claude.ai-ban
Ha a Claude Code-ba claude.ai fiókkal vagy bejelentkezve, a Claude.ai-ban felvett konnektorok a Claude Code-ban is megjelennek a /mcp listában, külön felvétel nélkül. A bejelentkezést ilyenkor a claude.ai felületén kell elvégezni.
Eltávolítás a Claude Code-ból: a claude mcp remove terepbazis parancs törli a kiszolgálót, és vele a gépen tárolt tokent és kliens-regisztrációt is. Csak a bejelentkezés törléséhez a /mcp menüben a Clear authentication pontot használd, vagy futtasd a claude mcp logout terepbazis parancsot. A Terepbázis oldalán a hozzáférést ettől függetlenül érdemes visszavonni (lásd lent).
A hozzáférés visszavonása
A hozzáférést bármikor visszavonhatod, és ezt a Terepbázisban teheted meg, nem csak az asszisztensben. Ez a biztos út: a visszavont kapcsolattal az asszisztens többé nem éri el a cég adatait, és a megújító (refresh) kérése sem ad új hozzáférést.
- Nyisd meg a Beállítások → Konnektorok oldalt.
- Keresd meg az oldal tetején az AI-asszisztens csatlakoztatása kártyát, és benne a Csatlakoztatott asszisztensek listát.
- Az asszisztens kapcsolata egy sor a listában: a neve az asszisztens nevéből és az (OAuth) utótagból áll, mellette OAuth jelzés látszik, alatta pedig a megadott jogosultságok és az Utolsó használat ideje. A tulajdonos és az adminisztrátor a sor jobb szélén a Visszavonás gombot látja (kuka ikon; keskeny képernyőn csak az ikon).
- Kattints a Visszavonás gombra, és a megerősítő kérdésnél („Biztosan visszavonod ezt a kulcsot?”) hagyd jóvá.
- A sor mellé a Visszavonva jelzés kerül, a dátummal. Innentől az asszisztens kapcsolata megszűnt: ha újra szeretnéd használni, a csatlakozást elölről kell indítanod a hozzájárulás-lappal.
A visszavonás nem törli, hogy az asszisztens korábban mit csinált: a módosításai a Terepbázisban megmaradnak. Ha csak a jogosultságokat akarod szűkíteni, vond vissza a kapcsolatot, és csatlakozz újra szűkebb jogosultságokkal. Az asszisztens oldalán is eltávolíthatod a konnektort (Claude: Customize > Connectors, Remove), de a Terepbázisban végzett visszavonás az, ami biztosan lezárja a hozzáférést.
Kulccsal (haladó)
Fejlesztőknek és haladó felhasználóknak
Az OAuth-os belépés helyett használhatsz API-kulcsot is. A kulcs egy tb_ előtagú titok, amit a Terepbázis egyszer mutat meg. Ezzel a kulccsal olyan kliens csatlakozhat, amely tud fix fejlécet küldeni (például a Claude Code). Kulcsot a cég tulajdonosa és adminisztrátora hozhat létre a felületen.
- Nyisd meg a Beállítások → Konnektorok oldalt, és az oldal alján kattints a Haladó: API-kulcs (fejlesztőknek, Claude Code, saját integráció) sorra: kinyílik.
- Az Új API-kulcs létrehozása űrlapon add meg a Nevet (például: Claude Code, saját gép).
- A Scope-ok (legalább egy) közül pipáld be, mit tehet a kulcs. Szűken add meg: elég az olvasás, ha csak lekérdezni akarsz.
- A Lejárat mezőt érdemes kitölteni. Ha üres, a kulcs soha nem jár le.
- Kattints a Kulcs generálása gombra.
- A zöld keretes dobozban megjelenik a teljes kulcs, a „Ez a kulcs csak most látszik” felirattal. Másold ki a Másolás gombbal, és tedd biztos helyre. A doboz bezárása után a kulcs többé nem jelenik meg.
- A klienst úgy állítsd be, hogy minden kérésnél elküldje az Authorization: Bearer <a kulcs> fejlécet a https://mcp.terepbazis.net/mcp címre.
Kulcs és az asszisztensek
A Claude.ai-ban a fix fejléc (Request headers) az Anthropic dokumentációja szerint béta funkció, és csak egy korlátozott körnek érhető el: ha a konnektor-felvételi ablakban nem látod a Request headers részt, a szervezetednek még nincs hozzáférése. Ha látod, a fejléc nevét válaszd ki a listából, és az értéket teljes alakjában add meg (Bearer, szóköz, a kulcs): a Claude pontosan azt küldi, amit beírsz, előtagot nem tesz elé. A ChatGPT az OpenAI dokumentációja szerint nem tud saját API-kulcsot küldeni, ott az OAuth-os út kell.
Vigyázz a kulccsal
A kulcs jelszóként működik: aki megszerzi, a megadott jogosultságokkal eléri a cég adatait. Ne tedd e-mailbe, chatbe vagy nyilvános tárba. Ha kiszivároghatott, azonnal vond vissza ugyanott, ahol az OAuth-os kapcsolatot (kuka ikon, lásd fent), és hozz létre újat.