Prepojenie Mergada s AI agentmi (ChatGPT, Claude, Cursor)#

Čo je MCP a prečo ho používať?#

MCP (Model Context Protocol) je štandard, ktorý umožňuje AI agentom (ChatGPT, Claude, Cursor a ďalším) pracovať s vašimi dátami a službami. Po prepojení cez MCP môže AI agent vaším menom v Mergade čítať projekty, pravidlá a štatistiky a podľa vášho zadania s nimi pracovať – to všetko priamo v rozhovore s AI.

Namiesto toho, aby ste dáta z Mergada ručne kopírovali do AI a späť, AI si ich vezme a vráti vám rovno výsledok.

Mergado MCP HUB#

Cez jedno MCP napojenie máte pokope nástroje Mergado Editora aj pripojených rozšírení — nemusíte spravovať viac samostatných spojení. Keď rozšírenie svoje nástroje zmení alebo pridá nové, premietne sa to automaticky, bez prenastavovania z vašej strany.

Aktuálne je v HUBe dostupný Mergado Editor, rozšírenia ako Pricing Fox a Feed Image Editor budú pribúdať postupne. Pricing Fox má zatiaľ aj vlastné samostatné MCP napojenie, ktoré zostáva k dispozícii aj po zaradení do HUBu — viac na pricing-fox.cz.

Príklady, čo po prepojení môžete s AI robiť#

• „Koľko produktov má aktuálne každý môj projekt?“
• „Potrebujem zobraziť všetky produkty, ktoré nemajú vyplnený EAN.“
• „Spusti audit feedu na projekte XY a zhrň, čo je potrebné opraviť.“
• „Potrebujem upraviť názov položky, aby bol v štruktúre: výrobca + názov položky + veľkosť + farba.“

Čo Mergado MCP server vie#

Po pripojení získa AI agent prístup k týmto oblastiam dát a operáciám v Mergade:

💡 Filtrovanie podľa času: vo výberoch (cez API create_project_query + query_products, aj cez MCP nástroj query_products) môžete filtrovať podľa veku produktu vo feede (@@DAYS_IN_PROJECT) alebo podľa toho, ako dlho sa hodnota nezmenila — @@DAYS_WITHOUT_INPUT_CHANGE (dni od poslednej zmeny na vstupe), @@DAYS_WITHOUT_OUTPUT_CHANGE (dni od poslednej zmeny na výstupe) a @@DAYS_WITHOUT_CHANGE (dni od novšej z predchádzajúcich dvoch zmien). Užitočné napríklad na odhalenie noviniek vo feede alebo produktov, ktoré dlho nikto needitoval.

Rozsah toho, čo AI smie robiť, je daný oprávneniami (scopes) vášho prístupového tokenu alebo OAuth autorizácie – pozri Bezpečnosť. Ak napríklad tokenu udelíte len scope „Čítanie pravidiel”, AI bude môcť pravidlá čítať, ale nie upravovať či mazať.

Kompletný zoznam jednotlivých oprávnení (scopes) je v článku Osobný prístupový token (PAT).

💡 Tip na presnejšiu prácu s AI: MCP pripojenie dáva AI prístup k vašim dátam v Mergade. Ak chcete, aby AI tiež hlboko poznala pravidlá, elementy a možnosti Mergada – napríklad presne vedela, aké pravidlá existujú a ako ich správne zostaviť –, pridajte Mergado Skills sady:

• Mergado Skills – Context7
• Mergado Skills – GitHub

Možnosti prepojenia – prehľad#

Existujú dve cesty:

TL;DR: Ak nechcete generovať token, použite Cestu B – OAuth funguje v klientoch, ktorí podporujú dynamickú registráciu (napríklad n8n alebo Claude Desktop s plateným plánom). Oficiálne konektory priamo v ChatGPT a Claudovi sa ešte pripravujú.

Cesta A: Pripojenie cez PAT#

Predpoklady#

1. Vygenerovaný PAT – pozri Osobný prístupový token (PAT).
2. Vybrané oprávnenia (scopes) zodpovedajúce tomu, čo chcete cez AI robiť. Ak napríklad chcete len čítať štatistiky, dajte tokenu len čítací scope.
3. MCP klient (Cursor, Claude Code, Claude Desktop, vlastný skript).

Spoločné údaje pre všetkých klientov#

Cursor#

1. Otvorte Settings → MCP.
2. Kliknite na Add new MCP server.
3. Vyplňte:
   • Name: Mergado
   • URL: https://mcp.mergado.com
   • Header: Authorization: Bearer mergado_pat_…
4. Uložte a reštartujte Cursor.
5. V chate skontrolujte, že sa Mergado tools objavili v zozname dostupných nástrojov.

Podrobný postup, ako napojiť Mergado MCP do aplikácie Cursor.

Claude Code (CLI)#

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

Overenie, že je server pripojený:

claude mcp list

Claude Desktop#

Claude Desktop aktuálne nepodporuje pripojenie k remote MCP serverom priamo cez HTTP – komunikuje iba cez lokálne procesy. Musí sa preto použiť medzičlánok mcp-remote, ktorý funguje ako lokálny „prevodník" medzi Claude Desktop a vzdialeným serverom mcp.mergado.com.

1. Nainštalujte Node.js#

mcp-remote sa spúšťa cez Node.js, ktorý musíte mať na počítači nainštalovaný.

Čo je Node.js? Prostredie, v ktorom na vašom počítači bežia programy napísané v JavaScripte. Niektoré nástroje ako mcp-remote sa distribuujú práve ako Node.js balíčky a bez Node.js ich nemožno spustiť.

Stiahnite inštalátor z nodejs.org/en/download/current a zvoľte správny variant podľa:

• operačného systému (Windows / macOS / Linux),
• architektúry procesora – pri macOS je potrebné vybrať ARM64 pre procesory Apple Silicon (M1 a novšie), alebo x64 pre staršie Macy s procesormi Intel.

Po inštalácii overte v termináli (Príkazový riadok / Terminál):

node --version

Ak vypíše verziu (napríklad v22.x.x), inštalácia prebehla v poriadku.

2. Upravte konfiguračný súbor Claude Desktop#

Otvorte (alebo vytvorte) súbor:

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

A vložte doň nasledujúcu konfiguráciu:

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

Namiesto mergado_pat_... vložte celý svoj PAT.

3. Reštartujte Claude Desktop#

Po reštarte by sa v rozhraní Claude Desktop mal objaviť Mergado MCP server ako dostupný nástroj. Prvé spustenie môže trvať o pár sekúnd dlhšie – npx pri prvom behu stiahne balíček mcp-remote.

Tip pre platené plány Claude (Pro, Max, Team, Enterprise): v Claude Desktop existuje tiež funkcia Custom Connectors (Settings → Connectors → Add custom connector), ktorá remote MCP servery podporuje natívne bez Node.js a mcp-remote. Ak máte platený plán, je to jednoduchšia cesta.

Vlastný skript / aplikácia#

Ak si píšete vlastného MCP klienta alebo používate SDK (TypeScript, Python), pripojte sa na https://mcp.mergado.com s hlavičkou Authorization: Bearer <PAT>. Detaily MCP protokolu nájdete v oficiálnej MCP špecifikácii.

Cesta B: Oficiálna Mergado MCP App#

Mergado MCP server podporuje OAuth s dynamickou registráciou klienta – nepotrebujete generovať ani spravovať žiadny token. Stačí zadať adresu https://mcp.mergado.com do svojho MCP klienta a potvrdiť prihlasovaciu obrazovku Mergada.

Pripravujeme tiež oficiálne Mergado konektory, ktoré budú dostupné priamo v ponuke konektorov ChatGPT a Claude. Hneď ako budú dostupné, doplníme sem postup na ich napojenie.

Oproti Ceste A nebudete potrebovať:

• generovať ani spravovať osobný prístupový token (PAT),
• inštalovať Node.js ani žiadne ďalšie pomocné nástroje,
• ručne upravovať konfiguračné súbory.

Autorizácia prebieha štandardným OAuth flow – rovnako ako keď sa prihlasujete k webovej službe „cez Google” alebo „cez Facebook”. Mergado si od vás vyžiada súhlas s konkrétnymi oprávneniami a vy ich môžete kedykoľvek odobrať v sekcii API a prístupy. Na prihlasovacej obrazovke novo vidíte prehľad konkrétnych oprávnení (scopov), o ktoré si aplikácia žiada — takže presne viete, čo dané pripojenie bude môcť v Mergade robiť, ešte než súhlas potvrdíte.

ChatGPT#

Podrobný postup, ako napojiť Mergado MCP do ChatGPT desktop app.

Claude (Connectors Directory)#

Oficiálny konektor pre Claude sa ešte pripravuje. Hneď ako bude dostupný, doplníme sem postup.

Bezpečnosť#

AI agent pripojený k Mergadu vykonáva akcie vaším menom. Keď mu poviete „zmaž staré pravidlá“, naozaj pravidlá maže. Pár pravidiel, ako to mať pod kontrolou:

Princíp najmenších oprávnení#

Tokenu / OAuth autorizácii dajte len tie scopes, ktoré AI skutočne potrebuje. Ak chcete len analyzovať štatistiky, nedávajte právo na zápis. AI by tak teoreticky nemohla nič v Mergade zmeniť, ani keby chcela alebo dostala podvrhnuté inštrukcie.

Bezpečnostné anotácie nástrojov#

Nástroje, ktoré v Mergade menia alebo mažú dáta, sú označené bezpečnostnou anotáciou. AI klienti, ktorí anotácie rešpektujú, sa pri takých nástrojoch správajú opatrnejšie — typicky si od vás pred spustením vyžiadajú potvrdenie.

Cesta A vs Cesta B z pohľadu bezpečnosti#

• Cesta A (PAT): token máte fyzicky uložený v konfigurácii klienta. Ak sa vám konfiguračný súbor dostane do nepovolaných rúk (Git, zdieľaný screenshot, ukradnutý notebook), token musíte zneplatniť.
• Cesta B (OAuth): prístup je viazaný na konkrétnu službu (ChatGPT/Claude účet) a nepoužívate žiadny „kopírovateľný" token. Z hľadiska bezpečnosti pohodlnejšie.

Pravidelne si prejdite prístupy#

• Pri Ceste A v Mergade otvorte API a prístupy a zneplatnite tokeny, ktoré už nepoužívate.
• Pri Ceste B na tej istej stránke uvidíte zoznam pripojených aplikácií a budete ich môcť odpojiť.

Pozor na prompt injection#

Ak necháte AI agenta spracovávať externý obsah (e-maily, webové stránky, texty produktov), môže v nich byť skrytá inštrukcia, ktorá sa pokúsi AI zmanipulovať. Preto:

• Prístup k zápisu udeľujte striedmo a len tam, kde to skutočne potrebujete.
• Pri citlivých akciách (mazanie, hromadné úpravy) si od AI nechajte potvrdiť zámer pred vykonaním.
• Po práci AI skontrolujte výsledok v Mergade – čo AI urobila, vidíte štandardne v projekte/pravidlách.

FAQ#

Token v Cursore / Claude Code nefunguje, dostávam 401. Čo s tým?#

• Overte, že hlavička je presne Authorization: Bearer mergado_pat_... (slovo Bearer s medzerou).
• Token v Mergade nesmie byť zneplatnený a nesmie mať vypršanú platnosť – pozri zoznam tokenov na API a prístupy.
• V Cursore/Claude Code reštartujte aplikáciu po zmene konfigurácie.

AI nemá prístup k tomu, čo potrebujem. Čo s tým?#

Token nemá potrebný scope. Vytvorte nový token s rozšírenými oprávneniami (existujúci token rozšíriť nemožno) a aktualizujte ho v MCP klientovi.

Môžem jeden PAT používať vo viacerých AI nástrojoch zároveň?#

Technicky áno, ale odporúčame vytvoriť samostatný token pre každý nástroj. Keď potom budete chcieť prístup z jedného nástroja odobrať, stačí zneplatniť jeden token, ostatné zostanú funkčné.

Môžem sa pripojiť cez OAuth, aj keď ešte nie sú hotové oficiálne konektory pre ChatGPT a Claude?#

Áno. OAuth funguje v klientoch, ktorí podporujú dynamickú registráciu, napríklad n8n alebo Claude Desktop s plateným plánom. Stačí zadať URL https://mcp.mergado.com, token generovať nemusíte. Oficiálne konektory priamo v ChatGPT a Claudovi sa ešte pripravujú.

Bude Mergado MCP App fungovať zadarmo?#

Áno. Oficiálna Mergado MCP App bude dostupná zadarmo pre všetkých používateľov Mergada. Prevádzka vlastných MCP klientov (Cesta A) je takisto bezplatná – platí sa iba za AI nástroj, ktorý používate (ChatGPT Plus, Claude Pro a podobne).

Ktoré modely AI to podporujú?#

Akýkoľvek MCP-kompatibilný klient. Aktuálne to znamená predovšetkým: ChatGPT (Apps), Claude (Desktop, Code, Connectors), Cursor a vlastné implementácie cez MCP SDK.

Súvisiace odkazy#

• Osobný prístupový token (PAT) – čo to je a ako ho používať
• API a prístupy – správa PAT a pripojených aplikácií
• Mergado API reference: api-docs.mergado.com
• MCP špecifikácia: modelcontextprotocol.io
• Mergado Skills – Context7 – kompletná dokumentácia pravidiel a možností Mergada pre AI asistentov
• Mergado Skills – GitHub
• mcp.mergado.com — prehľad a návody na pripojenie (OAuth aj PAT, ChatGPT, Claude, Cursor, VS Code a ďalšie) v češtine, angličtine, slovenčine aj maďarčine