Propojení Mergada s AI agenty (ChatGPT, Claude, Cursor)#

Co je MCP a proč ho používat?#

MCP (Model Context Protocol) je standard, který umožňuje AI agentům (ChatGPT, Claude, Cursor a další) pracovat s vašimi daty a službami. Po propojení přes MCP může AI agent vaším jménem v Mergadu číst projekty, pravidla a statistiky a podle vašeho zadání s nimi pracovat – to vše přímo v rozhovoru s AI.

Místo toho, abyste data z Mergada ručně kopírovali do AI a zpátky, AI si je vezme a vrátí vám rovnou výsledek.

Mergado MCP HUB#

Přes jedno MCP napojení máte pohromadě nástroje Mergado Editoru i připojených rozšíření — nemusíte spravovat víc samostatných spojení. Když rozšíření své nástroje změní nebo přidá nové, promítne se to automaticky, bez přenastavování z vaší strany.

Aktuálně je v HUBu dostupný Mergado Editor, rozšíření jako Pricing Fox a Feed Image Editor budou přibývat postupně. Pricing Fox má zatím i vlastní samostatné MCP napojení, které zůstává k dispozici i po zařazení do HUBu — více na pricing-fox.cz.

Příklady, co po propojení můžete s AI dělat#

„Kolik produktů má aktuálně každý můj projekt?“
„Potřebuji zobrazit všechny produkty, které nemají vyplněný EAN.“
„Spusť audit feedu na projektu XY a shrň, co je třeba opravit.“
„Potřebuji upravit název položky, aby byl ve struktuře: výrobce + název položky + velikost + barva.“

Co Mergado MCP server umí#

Po připojení získá AI agent přístup k těmto oblastem dat a operacím v Mergadu:

Oblast	Co AI po propojení může dělat
Projekty	Založit nový projekt pod e-shopem — včetně zdroje dat, výstupního formátu, autorizace produktů, Auditu a párovacích elementů. Procházet vaše projekty, číst jejich data, historii zpracování a logy. Spouštět nová zpracování (import z XML, aplikace pravidel, export do XML). Díky strukturovaným chybovým stavům v logách umí AI přesněji identifikovat a reportovat příčiny selhání importů či exportů.
Pravidla	Číst existující pravidla v projektech, vytvářet nová, upravovat je a mazat. Pomáhat s návrhy pravidel podle zadání.
Audit feedu	Spouštět audity XML feedu projektu a číst výsledky – nalezené problémy, chybějící elementy, návrhy oprav.
Produkty a výběry	Procházet produkty v projektu, filtrovat je pomocí výběrů (queries), upravovat a mazat produkty. Vytvářet a spravovat výběry.
Elementy a proměnné	Číst a upravovat strukturu projektu – elementy (výstupní pole feedu) a proměnné.
Statistiky a Google Analytics	Číst statistiky e-shopu i jednotlivých projektů, pokročilou analytiku a data z Google Analytics propojených přes Keychain.
E-shopy a Keychain	Číst seznam vašich e-shopů a jejich detaily, data napojených služeb (Heureka, Google Ads…) přes Keychain, případně tato data upravovat.
Notifikace	Číst notifikace v Mergadu (vaše osobní i z e-shopu).

💡 Filtrování podle času: ve výběrech (přes API create_project_query + query_products, i přes MCP nástroj query_products) můžete filtrovat podle stáří produktu ve feedu (@@DAYS_IN_PROJECT) nebo podle toho, jak dlouho se hodnota nezměnila — @@DAYS_WITHOUT_INPUT_CHANGE (dny od poslední změny na vstupu), @@DAYS_WITHOUT_OUTPUT_CHANGE (dny od poslední změny na výstupu) a @@DAYS_WITHOUT_CHANGE (dny od novější z předchozích dvou změn). Užitečné třeba pro odhalení novinek ve feedu nebo produktů, které dlouho nikdo needitoval.

Rozsah toho, co AI smí dělat, je daný oprávněními (scopes) vašeho přístupového tokenu nebo OAuth autorizace – viz Bezpečnost. Pokud například tokenu udělíte jen scope „Čtení pravidel”, AI bude moci pravidla číst, ale nikoliv upravovat či mazat.

Kompletní seznam jednotlivých oprávnění (scopes) je v článku Osobní přístupový token (PAT).

💡 Tip pro přesnější práci s AI: MCP připojení dává AI přístup k vašim datům v Mergadu. Pokud chcete, aby AI také hluboce znala pravidla, elementy a možnosti Mergada – třeba přesně věděla, jaká pravidla existují a jak je správně sestavit –, přidejte Mergado Skills sady:

Mergado Skills – Context7

Mergado Skills – GitHub

Možnosti propojení – přehled#

Existují dvě cesty:

	Cesta A – přes PAT	Cesta B – Oficiální Mergado MCP App
Stav	✅ Funkční	✅ Funkční
Pro koho	Cursor, Claude Code, Claude Desktop, vlastní skripty	ChatGPT, Claude (oficiální app v jejich nabídce konektorů)
Jak se autorizujete	Vygenerujete PAT a vložíte ho do konfigurace klienta	Zadáte adresu MCP serveru do klienta, otevře se přihlašovací stránka Mergada (OAuth), token není potřeba
Náročnost	Vyžaduje chvilkové nastavení (config soubor / formulář v UI)	Pár kliknutí v UI

TL;DR: Pokud nechcete generovat token, použijte Cestu B – OAuth funguje v klientech, kteří podporují dynamickou registraci (např. n8n nebo Claude Desktop s placeným plánem). Oficiální konektory přímo v ChatGPT a Claudovi se teprve připravují.

Cesta A: Připojení přes PAT#

Předpoklady#

Vygenerovaný PAT – viz Osobní přístupový token (PAT).
Vybraná oprávnění (scopes) odpovídající tomu, co chcete přes AI dělat. Pokud např. chcete jen číst statistiky, dejte tokenu jen čtecí scope.
MCP klient (Cursor, Claude Code, Claude Desktop, vlastní skript).

Společné údaje pro všechny klienty#

Údaj	Hodnota
MCP server URL	`https://mcp.mergado.com`
Autorizace	HTTP hlavička `Authorization: Bearer <váš-PAT>`
Protokol	MCP přes Streamable HTTP

Cursor#

Otevřete Settings → MCP.
Klikněte na Add new MCP server.
Vyplňte:
- Name: Mergado
- URL: https://mcp.mergado.com
- Header: Authorization: Bearer mergado_pat_…
Uložte a restartujte Cursor.
V chatu zkontrolujte, že se Mergado tools objevily v seznamu dostupných nástrojů.

Podrobný postup, jak napojit Mergado MCP do aplikace Cursor.

Claude Code (CLI)#

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

Ověření, že je server připojený:

claude mcp list

Claude Desktop#

Claude Desktop aktuálně nepodporuje připojení k remote MCP serverům přímo přes HTTP – komunikuje pouze přes lokální procesy. Musí se proto použít mezičlánek mcp-remote, který funguje jako lokální „převodník" mezi Claude Desktop a vzdáleným serverem mcp.mergado.com.

1. Nainstalujte Node.js#

mcp-remote se spouští přes Node.js, který musíte mít na počítači nainstalovaný.

Co je Node.js? Prostředí, ve kterém na vašem počítači běží programy napsané v JavaScriptu. Některé nástroje jako mcp-remote se distribuují právě jako Node.js balíčky a bez Node.js je nelze spustit.

Stáhněte instalátor z nodejs.org/en/download/current a zvolte správnou variantu podle:

operačního systému (Windows / macOS / Linux),
architektury procesoru – u macOS je třeba vybrat ARM64 pro procesory Apple Silicon (M1 a novější), nebo x64 pro starší Macy s procesory Intel.

Po instalaci ověřte v terminálu (Příkazový řádek / Terminál):

node --version

Pokud vypíše verzi (např. v22.x.x), instalace proběhla v pořádku.

2. Upravte konfigurační soubor Claude Desktop#

Otevřete (nebo vytvořte) soubor:

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

A vložte do něj následující konfiguraci:

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

Místo mergado_pat_... vložte celý svůj PAT.

3. Restartujte Claude Desktop#

Po restartu by se v rozhraní Claude Desktop měl objevit Mergado MCP server jako dostupný nástroj. První spuštění může trvat o pár sekund déle – npx při prvním běhu stáhne balíček mcp-remote.

Tip pro placené plány Claude (Pro, Max, Team, Enterprise): v Claude Desktop existuje také funkce Custom Connectors (Settings → Connectors → Add custom connector), která remote MCP servery podporuje nativně bez Node.js a mcp-remote. Pokud máte placený plán, je to jednodušší cesta.

Vlastní skript / aplikace#

Pokud si píšete vlastního MCP klienta nebo používáte SDK (TypeScript, Python), připojte se na https://mcp.mergado.com s hlavičkou Authorization: Bearer <PAT>. Detaily MCP protokolu najdete v oficiální MCP specifikaci.

Cesta B: Oficiální Mergado MCP App#

Mergado MCP server podporuje OAuth s dynamickou registrací klienta – nepotřebujete generovat ani spravovat žádný token. Stačí zadat adresu https://mcp.mergado.com do svého MCP klienta a potvrdit přihlašovací obrazovku Mergada.

Připravujeme také oficiální Mergado konektory, které budou dostupné přímo v nabídce konektorů ChatGPT a Claude. Jakmile budou dostupné, doplníme sem postup pro jejich napojení.

Oproti Cestě A nebudete potřebovat:

generovat ani spravovat osobní přístupový token (PAT),
instalovat Node.js ani žádné další pomocné nástroje,
ručně upravovat konfigurační soubory.

Autorizace probíhá standardním OAuth flow – stejně jako když se přihlašujete k webové službě „přes Google” nebo „přes Facebook”. Mergado si od vás vyžádá souhlas s konkrétními oprávněními a vy je můžete kdykoliv odebrat v sekci API a přístupy. Na přihlašovací obrazovce nově vidíte přehled konkrétních oprávnění (scopů), o které si aplikace žádá — takže přesně víte, co dané připojení bude moct v Mergadu dělat, ještě než souhlas potvrdíte.

ChatGPT#

Podrobný postup, jak napojit Mergado MCP do ChatGPT desktop app.

Claude (Connectors Directory)#

Oficiální konektor pro Claude se teprve připravuje. Jakmile bude dostupný, doplníme sem postup.

Bezpečnost#

AI agent připojený k Mergadu provádí akce vaším jménem. Když mu řeknete „promaž stará pravidla“, opravdu pravidla maže. Pár pravidel, jak to mít pod kontrolou:

Princip nejmenších oprávnění#

Tokenu / OAuth autorizaci dejte jen ty scopes, které AI skutečně potřebuje. Pokud chcete jen analyzovat statistiky, nedávejte právo na zápis. AI by tak teoreticky nemohla nic v Mergadu změnit, i kdyby chtěla nebo dostala podvržené instrukce.

Bezpečnostní anotace nástrojů#

Nástroje, které v Mergadu mění nebo mažou data, jsou označené bezpečnostní anotací. AI klienty, které anotace respektují, se u takových nástrojů chovají opatrněji — typicky si od vás před spuštěním vyžádají potvrzení.

Cesta A vs Cesta B z pohledu bezpečnosti#

Cesta A (PAT): token máte fyzicky uložený v konfiguraci klienta. Pokud se vám konfigurační soubor dostane do nepovolaných rukou (Git, sdílený screenshot, ukradený notebook), token musíte zneplatnit.
Cesta B (OAuth): přístup je vázaný na konkrétní službu (ChatGPT/Claude účet) a nepoužíváte žádný „kopírovatelný" token. Z hlediska bezpečnosti pohodlnější.

Pravidelně si projděte přístupy#

U Cesty A v Mergadu otevřete API a přístupy a zneplatněte tokeny, které už nepoužíváte.
U Cesty B ve stejné stránce uvidíte seznam připojených aplikací a budete je moci odpojit.

Pozor na prompt injection#

Pokud necháváte AI agenta zpracovávat externí obsah (e-maily, webové stránky, texty produktů), může v nich být skrytá instrukce, která se pokusí AI zmanipulovat. Proto:

Přístup k zápisu udělujte střídmě a jen tam, kde to skutečně potřebujete.
U citlivých akcí (mazání, hromadné úpravy) si od AI nechte potvrdit záměr před vykonáním.
Po práci AI zkontrolujte výsledek v Mergadu – co AI udělala, vidíte standardně v projektu/pravidlech.

FAQ#

Token v Cursoru / Claude Code nefunguje, dostávám 401. Co s tím?#

Ověřte, že hlavička je přesně Authorization: Bearer mergado_pat_... (slovo Bearer s mezerou).
Token v Mergadu nesmí být zneplatněný a nesmí mít vypršenou platnost – viz seznam tokenů na API a přístupy.
V Cursoru/Claude Code restartujte aplikaci po změně konfigurace.

AI nemá přístup k tomu, co potřebuju. Co s tím?#

Token nemá potřebné scope. Vytvořte nový token s rozšířenými oprávněními (existující token rozšířit nelze) a aktualizujte ho v MCP klientu.

Můžu jeden PAT používat ve více AI nástrojích zároveň?#

Technicky ano, ale doporučujeme vytvořit samostatný token pro každý nástroj. Když pak budete chtít přístup z jednoho nástroje odebrat, stačí zneplatnit jeden token, ostatní zůstanou funkční.

Můžu se připojit přes OAuth, i když ještě nejsou hotové oficiální konektory pro ChatGPT a Claude?#

Ano. OAuth funguje v klientech, kteří podporují dynamickou registraci, například n8n nebo Claude Desktop s placeným plánem. Stačí zadat URL https://mcp.mergado.com, token generovat nemusíte. Oficiální konektory přímo v ChatGPT a Claudovi se teprve připravují.

Bude Mergado MCP App fungovat zdarma?#

Ano. Oficiální Mergado MCP App bude dostupná zdarma pro všechny uživatele Mergada. Provoz vlastních MCP klientů (Cesta A) je rovněž bezplatný – platí se pouze za AI nástroj, který používáte (ChatGPT Plus, Claude Pro apod.).

Které modely AI to podporují?#

Jakýkoliv MCP-kompatibilní klient. Aktuálně to znamená především: ChatGPT (Apps), Claude (Desktop, Code, Connectors), Cursor a vlastní implementace přes MCP SDK.

Související odkazy#

Osobní přístupový token (PAT) – co to je a jak ho používat
API a přístupy – správa PAT a připojených aplikací
Mergado API reference: api-docs.mergado.com
MCP specifikace: modelcontextprotocol.io
Mergado Skills – Context7 – kompletní dokumentace pravidel a možností Mergada pro AI asistenty
Mergado Skills – GitHub
mcp.mergado.com — přehled a návody k připojení (OAuth i PAT, ChatGPT, Claude, Cursor, VS Code a další) v češtině, angličtině, slovenštině i maďarštině

Byl tento článek užitečný?