Vissza a tudástárbaBeállítások és adminisztráció

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.

  1. 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.
  2. 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).
  3. 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.
  4. 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.
  5. 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.
  6. Kattints az Engedélyezés gombra. A böngésző visszavisz az asszisztenshez, és a kapcsolat kész.
CsoportMit jelentAlapból?
OlvasásMunkalapok, ügyfelek, ajánlatok, termékek, készlet és szerződések megnézése.Alapból bepipálva (a kért olvasások)
ÍrásMunkalap 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ésMunkalapok ü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:

  1. Nyisd meg a Claude-ot (a böngészőben, vagy az asztali alkalmazásban), és jelentkezz be.
  2. Menj a Customize > Connectors oldalra.
  3. 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.)
  4. A névhez írd be: Terepbázis. Ez a név látszik majd a konnektorok listájában.
  5. A szerver címéhez (MCP server URL) írd be: https://mcp.terepbazis.net/mcp, majd kattints a Continue gombra.
  6. 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.
  7. A Request headers részt hagyd üresen: erre csak a kulcsos (haladó) módnál van szükség, lásd lent.
  8. Kattints az Add gombra.
  9. 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:

  1. Menj az Organization settings > Connectors oldalra.
  2. Kattints az Add gombra, vigyél az egeret a Custom fölé, és válaszd a Web pontot.
  3. 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.
  4. 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.):

  1. 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.
  2. A Plugins oldalon jobb felül kattints az Add gombra, majd az Add custom MCP server pontra.
  3. A Name mezőbe írd be: Terepbázis. A Description mező nem kötelező.
  4. A Connection alatt maradjon a Server URL, és illeszd be a címet: https://mcp.terepbazis.net/mcp
  5. Az Authentication maradjon OAuth.
  6. 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.
  7. Ha a ChatGPT nem kéri magától a belépést, a Terepbázis plugin oldalán kattints a Connect gombra.
  8. 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.
  9. 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.

  1. Nyiss egy terminált ott, ahol a Claude Code telepítve van.
  2. 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).
  3. 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.
  4. 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.)
  5. 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.
  6. 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.
  7. 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.

  1. Nyisd meg a Beállítások → Konnektorok oldalt.
  2. Keresd meg az oldal tetején az AI-asszisztens csatlakoztatása kártyát, és benne a Csatlakoztatott asszisztensek listát.
  3. 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).
  4. Kattints a Visszavonás gombra, és a megerősítő kérdésnél („Biztosan visszavonod ezt a kulcsot?”) hagyd jóvá.
  5. 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.

  1. 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.
  2. Az Új API-kulcs létrehozása űrlapon add meg a Nevet (például: Claude Code, saját gép).
  3. 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.
  4. A Lejárat mezőt érdemes kitölteni. Ha üres, a kulcs soha nem jár le.
  5. Kattints a Kulcs generálása gombra.
  6. 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.
  7. 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.