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

Mi az MCP, és miért érdemes használni?#

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

Ahelyett, hogy manuálisan másolnád az adatokat a Mergadóból az AI-ba és vissza, az AI maga olvassa be, és az eredményt közvetlenül adja vissza.

Példák arra, mit tehetsz az AI-jal a csatlakoztatás után#

• „Hány termék van jelenleg az egyes projektjeimben?"
• „Szeretném látni 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ítani szeretném a termék nevét úgy, hogy a következő mintát kövesse: gyártó + termék neve + 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 hozzáférési token vagy az OAuth-engedélyezés jogosultságai (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 jogosultságok (scope-ok) teljes listáját a Személyes hozzáférési token (PAT) cikkben találod.

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

Két út létezik:

Röviden: Ha ChatGPT-t vagy Claude-ot használsz a hivatalos bővítményen keresztül, és gyors csatlakozást szeretnél, várj a B útra (tervezett megjelenés: 2026. május 27.). Ha Cursort, Claude Code-ot használsz, vagy saját integrációt építesz, menj egyenesen az A úttal.

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

Előfeltételek#

1. Egy generált PAT – lásd Személyes hozzáférési token (PAT).
2. Kiválasztott jogosultságok (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 jelenleg nem támogatja a közvetlen HTTP-kapcsolatot a távoli MCP-szerverekhez – csak helyi folyamatokon keresztül kommunikál. Ezért az mcp-remote segédeszközt kell használnod, amely helyi „hídként" működik a Claude Desktop és a távoli mcp.mergado.com szerver között.

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

Az mcp-remote a 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. Egyes eszközök, mint az mcp-remote, Node.js csomagként vannak terjesztve, és nélküle nem indíthatók 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 válaszd az ARM64-et Apple Silicon (M1 vagy újabb) processzorokhoz, vagy az x64-et régebbi Intel-alapú Mac-ekhez.

A telepítés után ellenőrizd egy terminálban (Parancssor / Terminal):

node --version

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

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 teljes 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 a Claude Desktop-ban. Az első indítás néhány másodperccel tovább tarthat – az npx az első futtatáskor letölti 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 natívan támogatják a távoli MCP-szervereket Node.js és mcp-remote nélkül. Ha fizetős csomagot használsz, ez az egyszerűbb út.

Saját szkript / alkalmazás#

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#

🚧 Jelenleg fejlesztés alatt. Tervezett megjelenés: 2026. május 27. A frissítéseket a Mergadóban, a forum.mergado.com oldalon, vagy ebben a cikkben találod, amelyet részletes lépésekkel frissítünk, amint a bővítmény elérhető lesz.

A megjelenés után a Mergado hivatalos bővítményként lesz elérhető közvetlenül a ChatGPT és a Claude összekötő könyvtárában. A csatlakozás két kattintás lesz – keresd meg a Mergadót az általad választott AI összekötő listájában, kattints a Csatlakozás gombra, és erősítsd meg a Mergado bejelentkezési képernyőn.

Az A úthoz képest nem kell majd:

• személyes hozzáférési tokent (PAT-ot) generálni vagy kezelni,
• Node.js-t vagy egyéb segédeszközöket telepíteni,
• konfigurációs fájlokat manuálisan szerkeszteni.

Az engedélyezés a szabványos OAuth-folyamaton keresztül működik – éppúgy, mint amikor egy webes szolgáltatásba „Google-lal" vagy „Facebookkal" jelentkezel be. A Mergado MCP bővítmény bizonyos jogosultságokhoz kér hozzájárulást, amelyeket bármikor visszavonhatsz az API és hozzáférések oldalon.

ChatGPT#

A ChatGPT-hez tartozó lépésenkénti útmutatót a hivatalos Mergado MCP bővítmény megjelenése után adjuk hozzá.

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

A Claude-hoz tartozó lépésenkénti útmutatót a hivatalos Mergado MCP bővítmény megjelenése után adjuk hozzá.

Mit tegyél addig?#

Használd az A utat – Claude esetén ez már most működik a Claude Desktop-on vagy a Claude Code-on keresztül; Cursor esetén a beépített MCP-integráción keresztül.

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 a szabályokat. 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 tudna 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 fizikailag tárolódik a kliens konfigurációjában. Ha a konfigurációs fájl rossz kezekbe kerül (Git, megosztott képernyőkép, ellopott laptop), vissza kell vonni a tokent.
• B út (OAuth): a hozzáférés egy adott szolgáltatáshoz (ChatGPT/Claude fiók) kötött, és 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 a Mergadóban, és vonjud vissza a már nem használt tokeneket.
• B út esetén ugyanezen az oldalon látható a csatlakoztatott bővítmények listája, és ott le is választhatod őket.

Figyelj a prompt injektálásra#

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

• Adj írási hozzáférést takarékosan, 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 erősítse meg a szándékot a végrehajtás előtt.
• Miután az AI végzett, ellenőrizd az eredményt a Mergadóban – amit az AI tett, szokás szerint látható a projektedben/szabályaidban.

GYIK#

A tokenem nem működik a 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 a Mergadóban nem lehet visszavonva, és nem járhatott le – nézd meg a tokenlistát az API és hozzáférések oldalon.
• A Cursorban / Claude Code-ban indítsd újra a programot a konfiguráció módosítása után.

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ő tokent nem lehet bővíteni), és frissítsd az MCP kliensben.

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

Technikailag igen, de javasoljuk, hogy minden eszközhöz hozz létre külön tokent. Ha az egyik eszköztől vissza akarod vonni a hozzáférést, csak azt az egy tokent kell visszavonni; a többi továbbra is működik.

A B út még nem érhető el – használhatom a ChatGPT-t a Mergadóval addig is?#

Natív ChatGPT-integrációval nem – a teljesen kattintásmentes csatlakozás csak a hivatalos Mergado MCP bővítmény megjelenése után lesz elérhető. Addig ajánljuk vagy a várakozást, vagy egy másik AI ügynök használatát, ahol az A út ma is működik: Claude Desktop, Claude Code vagy Cursor.

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

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

Mely AI modellek támogatottak?#

Bármely MCP-kompatibilis kliens. Ma ez 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