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.

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	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).
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).

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).

Možnosti propojení – přehled#

Existují dvě cesty:

	Cesta A – přes PAT	Cesta B – Oficiální Mergado MCP App
Stav	✅ Funkční	🚧 Připravujeme – předběžné vydání 27. 5. 2026
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	Kliknete na Připojit v aplikaci, otevře se přihlašovací stránka Mergada (OAuth)
Náročnost	Vyžaduje chvilkové nastavení (config soubor / formulář v UI)	Pár kliknutí v UI

TL;DR: Pokud používáte ChatGPT nebo Claude přes oficiální aplikaci a chcete připojení během chvilky, počkejte na Cestu B (předběžné vydání 27. 5. 2026). Pokud používáte Cursor, Claude Code nebo si vyvíjíte vlastní integraci, jděte rovnou Cestou A.

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ů.

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#

🚧 Aktuálně připravujeme. Předběžné vydání: 27. 5. 2026. Aktualizace najdete v Mergadu, na forum.mergado.com nebo v tomto článku, který doplníme o detailní postup, jakmile bude aplikace dostupná.

Po vydání bude Mergado k dispozici jako oficiální aplikace přímo v nabídce konektorů ChatGPT a Claude. Připojení proběhne na dvě kliknutí – stačí v dané AI najít Mergado v seznamu konektorů, kliknout na Připojit a potvrdit přihlašovací obrazovku Mergada.

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 MCP App 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.

ChatGPT#

Postup pro propojení v ChatGPT doplníme po vydání oficiální Mergado MCP App.

Claude (Connectors Directory)#

Postup pro propojení v Claude doplníme po vydání oficiální Mergado MCP App.

Co dělat do té doby?#

Použijte Cestu A – pro Claude funguje hned přes Claude Desktop nebo Claude Code, pro Cursor přes vestavěnou MCP integraci.

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.

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í.

Cesta B ještě neexistuje, můžu zatím použít ChatGPT s Mergadem?#

Aktuálně ne přes nativní propojení v ChatGPT – plně bezklikové připojení tam bude dostupné až po vydání oficiální Mergado MCP App. Zatím doporučujeme buď počkat, nebo použít alternativního AI agenta, kde Cesta A funguje hned: Claude Desktop, Claude Code nebo Cursor.

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