A Mergado csatlakoztatása AI ügynökökhöz (ChatGPT, Claude, Cursor)#

Az MCP – mi ez és mire jó#

Az MCP (Model Context Protocol) egy szabvány, amely lehetővé teszi, hogy az AI ügynökök (ChatGPT, Claude, Cursor és mások) hozzáférjenek az adataidhoz és a szolgáltatásaidhoz. A csatlakoztatás után az AI a Mergadóban lévő projektjeidet, szabályaidat és statisztikáidat közvetlenül olvashatja, és az utasításaid alapján cselekedhet is – mindezt a csevegőből.

Nem kell adatokat másolgatni a Mergadóból az AI-ba és vissza – az AI maga veszi el, amire szüksége van, és közvetlenül visszaadja az eredményt.

Néhány példa, mit tehetsz a csatlakoztatás után#

• „Hány termék van jelenleg az egyes projektjeimben?"
• „Mutasd az összes terméket, amelynél nincs kitöltve az EAN."
• „Futtasd le a feed auditot az XY projekten, és összegezd, mit kell kijavítani."
• „Módosítsd a termékneveket úgy, hogy ezt a struktúrát kövessék: gyártó + terméknév + méret + szín."

Mit tud a Mergado MCP-szerver#

A csatlakoztatás után az AI ügynök hozzáfér a következő adatokhoz és műveletekhez a Mergadóban:

Azt, hogy az AI mit tehet, a token vagy az OAuth-engedélyezés scope-jai határozzák meg – lásd Biztonság. Ha például a tokenhez csak az „Szabályok olvasása" scope-ot adod, az AI olvasni tudja a szabályokat, de nem szerkesztheti vagy törölheti őket.

Az egyes scope-ok teljes listáját a Személyes hozzáférési token (PAT) cikkben találod.

💡 Tipp a pontosabb AI-munkához: Az MCP-kapcsolat a Mergadó adataihoz ad hozzáférést az AI-nak. Ha azt is szeretnéd, hogy az AI mélyebben ismerje a Mergado szabályait, elemeit és lehetőségeit – például pontosan tudja, milyen szabályok léteznek és hogyan kell őket felépíteni –, add hozzá a Mergado Skills készleteket:

• Mergado Skills – Context7
• Mergado Skills – GitHub

Csatlakozási lehetőségek – áttekintés#

Két út létezik:

Röviden: Ha Cursort, Claude Code-ot használsz, vagy saját integrációt építesz, menj az A úttal. Ha OAuth-ot szeretnél (token nélkül), a B út már működik – add meg a https://mcp.mergado.com URL-t az MCP kliensedben.

A út: Csatlakozás PAT-on keresztül#

Előfeltételek#

1. Generált PAT – lásd Személyes hozzáférési token (PAT).
2. Kiválasztott scope-ok, amelyek megfelelnek annak, amit az AI-tól elvársz. Ha például csak statisztikákat szeretnél olvasni, adj a tokennek csak olvasási scope-okat.
3. MCP kliens (Cursor, Claude Code, Claude Desktop, saját szkript).

Közös értékek minden klienshez#

Cursor#

1. Nyisd meg a Beállítások → MCP menüpontot.
2. Kattints az Új MCP-szerver hozzáadása lehetőségre.
3. Töltsd ki:
   • Név: Mergado
   • URL: https://mcp.mergado.com
   • Fejléc: Authorization: Bearer mergado_pat_…
4. Mentsd el, és indítsd újra a Cursort.
5. A csevegőben ellenőrizd, hogy a Mergado eszközök megjelennek-e az elérhető eszközök listájában.

Claude Code (CLI)#

claude mcp add --transport http mergado https://mcp.mergado.com \
  --header "Authorization: Bearer mergado_pat_..."

Ellenőrizd, hogy a szerver csatlakoztatva van-e:

claude mcp list

Claude Desktop#

A Claude Desktop nem támogatja a közvetlen HTTP-kapcsolatot a távoli MCP-szerverekhez – csak helyi folyamatokon keresztül kommunikál. Ezért szükség van az mcp-remote segédeszközre, amely helyi hídként működik a Claude Desktop és a mcp.mergado.com szerver között.

1. Telepítsd a Node.js-t#

Az mcp-remote Node.js-en fut, amelynek telepítve kell lennie a számítógépeden.

Mi a Node.js? Egy futtatókörnyezet, amely JavaScript programokat futtat a számítógépeden. Az mcp-remote Node.js csomagként van terjesztve, és nélküle nem indul el.

Töltsd le a telepítőt a nodejs.org/en/download/current oldalról, és válaszd a megfelelő verziót:

• operációs rendszer szerint (Windows / macOS / Linux),
• processzorarchitektúra szerint – macOS-en ARM64 az Apple Silicon (M1 vagy újabb) processzorokhoz, x64 a régebbi Intel-alapú Mac-ekhez.

Telepítés után ellenőrizd egy terminálban:

node --version

Ha megjelenik egy verziószám (pl. v22.x.x), a telepítés sikerült.

2. Szerkeszd a Claude Desktop konfigurációs fájlját#

Nyisd meg (vagy hozd létre) a fájlt:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Majd illeszd be a következő konfigurációt:

{
  "mcpServers": {
    "mergado": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mergado.com",
        "--header",
        "Authorization: Bearer mergado_pat_..."
      ]
    }
  }
}

Cseréld ki a mergado_pat_... részt a saját PAT-odra.

3. Indítsd újra a Claude Desktop-ot#

Az újraindítás után a Mergado MCP-szerver elérhető eszközként jelenik meg. Az első indítás kicsit tovább tarthat – az npx az első futtatáskor tölti le az mcp-remote csomagot.

Tipp fizetős Claude csomagokhoz (Pro, Max, Team, Enterprise): A Claude Desktop Egyéni összekötőket is kínál (Beállítások → Összekötők → Egyéni összekötő hozzáadása), amelyek Node.js és mcp-remote nélkül is támogatják a távoli MCP-szervereket. Ha fizetős csomagot használsz, ez az egyszerűbb út.

Saját szkript / bővítmény#

Ha saját MCP klienst építesz vagy SDK-t használsz (TypeScript, Python), csatlakozz a https://mcp.mergado.com címhez az Authorization: Bearer <PAT> fejléccel. Az MCP protokoll részleteit a hivatalos MCP specifikációban találod.

B út: Hivatalos Mergado MCP bővítmény#

A szerver dinamikus regisztrációval támogatja az OAuth-t – nem szükséges tokent generálni. Elegendő megadni a https://mcp.mergado.com URL-t az MCP kliensben, és megerősíteni a Mergado bejelentkezési képernyőn.

Az A úthoz képest:

• nem kell tokent generálni vagy kezelni,
• nem kell Node.js-t vagy egyéb segédeszközöket telepíteni,
• nem kell konfigurációs fájlokat kézzel szerkeszteni.

Az engedélyezés a szabványos OAuth-folyamaton keresztül működik – ugyanúgy, mint amikor egy webes szolgáltatásba „Google-lal" vagy „Facebookkal" jelentkezel be. A csatlakoztatott bővítményeket bármikor visszavonhatod az API és hozzáférések oldalon. A bejelentkezési képernyőn mostantól látod az adott bővítmény által kért konkrét engedélyek (scope-ok) összefoglalóját — így még a hozzájárulás megerősítése előtt pontosan tudod, hogy az adott csatlakozás mit végezhet el a Mergadóban.

ChatGPT#

A hivatalos összekötő előkészítés alatt – hamarosan elérhető lesz.

Claude (Összekötők könyvtára)#

A hivatalos összekötő előkészítés alatt – hamarosan elérhető lesz.

Biztonság#

A Mergadóhoz csatlakoztatott AI ügynök a te nevédben jár el. Ha azt mondod: „töröld a régi szabályokat", valóban törli őket. Néhány alapelv, hogy ez kézben maradjon:

A legkisebb jogosultság elve#

Adj a tokenhez / OAuth-engedélyezéshez csak azokat a scope-okat, amelyekre az AI-nak valóban szüksége van. Ha csak statisztikákat szeretnél elemezni, ne adj írási hozzáférést – így az AI nem tud semmit megváltoztatni a Mergadóban, még ha akarna is, vagy injektált utasításokat kapna is.

A és B út biztonsági szempontból#

• A út (PAT): a token a kliens konfigurációjában van tárolva. Ha a konfigurációs fájl rossz kezekbe kerül (Git, megosztott képernyőkép, ellopott laptop), azonnal vonjad vissza a tokent.
• B út (OAuth): a hozzáférés egy adott szolgáltatáshoz (ChatGPT/Claude fiók) kötött, nem használsz „másolható" tokent – biztonsági szempontból ez kényelmesebb.

Rendszeresen ellenőrizd a hozzáféréseket#

• A út esetén nyisd meg az API és hozzáférések oldalt, és vonjad vissza a már nem használt tokeneket.
• B út esetén ugyanitt látható a csatlakoztatott bővítmények listája, ahol le is választhatod őket.

Figyelj a prompt injektálásra#

Ha az AI-jal külső tartalmat (e-maileket, weboldalakat, termékleírásokat) dolgozol fel, ezek tartalmazhatnak rejtett utasítást, amely megpróbálja manipulálni az AI-t. Ezért:

• Az írási hozzáférést takarékosan add meg, csak ott, ahol valóban szükséges.
• Érzékeny műveleteknél (törlés, tömeges szerkesztés) kérd meg az AI-t, hogy végrehajtás előtt erősítse meg a szándékot.
• Miután az AI végzett, ellenőrizd az eredményt a Mergadóban – a változások szokás szerint láthatók a projektedben és a szabályaidban.

GYIK#

A tokenem nem működik Cursorban / Claude Code-ban, 401-es hibát kapok. Mit tegyek?#

• Ellenőrizd, hogy a fejléc pontosan Authorization: Bearer mergado_pat_... (a Bearer szó, utána szóköz).
• A token nem lehet visszavonva, és nem járhatott le – nézd meg a tokenlistát az API és hozzáférések oldalon.
• A konfiguráció módosítása után indítsd újra az alkalmazást.

Az AI-nak nincs hozzáférése ahhoz, amire szükségem van. Mit tegyek?#

A tokennek nincs megfelelő scope-ja. Hozz létre új tokent szélesebb jogosultságokkal (a meglévőt nem lehet bővíteni), és frissítsd az MCP kliensben.

Használhatok egy PAT-ot több AI eszközben is?#

Igen, de érdemes minden eszközhöz külön tokent létrehozni. Ha az egyik eszköztől vissza akarod vonni a hozzáférést, elég csak azt az egy tokent visszavonni – a többi továbbra is működik.

Használhatom az OAuth-t a hivatalos összekötők nélkül is?#

Igen. Az OAuth működik a dinamikus regisztrációt támogató kliensekben (n8n, Claude Desktop fizetős csomaggal). Add meg a https://mcp.mergado.com URL-t – tokent nem kell generálni.

Ingyenes a Mergado MCP bővítmény?#

Igen, minden Mergado-felhasználó számára ingyenesen elérhető. A saját MCP kliensek futtatása (A út) szintén ingyenes – csak az általad használt AI eszközért kell fizetni (ChatGPT Plus, Claude Pro stb.).

Mely AI kliensek támogatottak?#

Bármely MCP-kompatibilis kliens. Jelenleg elsősorban: ChatGPT (bővítmények), Claude (Desktop, Code, Összekötők), Cursor, és az MCP SDK-val készített egyéni implementációk.

Kapcsolódó linkek#

• Személyes hozzáférési token (PAT) – mi ez és hogyan kell használni
• API és hozzáférések – PAT-ok és csatlakoztatott bővítmények kezelése
• Mergado API referencia: api-docs.mergado.com
• MCP specifikáció: modelcontextprotocol.io
• Mergado Skills – Context7 – a Mergado szabályainak és lehetőségeinek teljes dokumentációja AI-asszisztensek számára
• Mergado Skills – GitHub