MCP: propojení Pricing Foxu s AI asistentem#
Napojení MCP umožňuje propojit Pricing Fox s AI klientem, jako je například Claude Desktop, Claude Code, Cursor, případně další nástroje podporující Model Context Protocol.
Díky MCP může AI asistent bezpečně přistupovat k datům vašeho projektu a pomáhat vám s jejich správou pomocí běžného zadání v přirozeném jazyce. Nemusíte tedy vše ručně vyhledávat v rozhraní aplikace – vybraných věcí se můžete jednoduše zeptat AI asistenta.
Můžete se ho zeptat například:
-
„Kolik produktů se v projektu aktuálně zpracovává?“
-
„Najdi mi produkty, které mají nízkou marži.“
-
„Vypiš mi pravidla, která se používají pro přeceňování.“
-
„Zkontroluj, jestli jsou v projektu produkty bez nákupní ceny.“
-
„Shrň mi, co se v projektu změnilo za posledních 30 dní.“
-
„Najdi produkty, které jsou levnější než konkurence.
Dostupné možnosti se vždy odvíjí od toho, jaké MCP nástroje má Pricing Fox pro daný projekt k dispozici a jaká oprávnění má použitý přístupový token.
Co je MCP#
MCP je zkratka pro Model Context Protocol. Jde o komunikační standard, který umožňuje AI nástrojům bezpečně pracovat s externími aplikacemi, službami a daty.
V praxi to znamená, že AI asistent nemusí odpovídat pouze podle obecných znalostí. Po propojení přes MCP může pracovat s konkrétními daty z vašeho projektu v Pricing Foxu a provádět nad nimi dostupné akce.
Jednoduše řečeno:
MCP je most mezi Pricing Foxem a vaším AI klientem. AI asistent díky němu získá přístup k vybraným nástrojům Pricing Foxu a může je používat podle vašeho zadání.
K čemu se MCP hodí#
MCP se hodí hlavně ve chvíli, kdy chcete s projektem pracovat rychleji, přirozeněji nebo ve větším rozsahu.
Místo ručního klikání v aplikaci můžete AI asistentovi položit otázku nebo zadat úkol.
Typicky se může hodit například pro:
-
rychlou kontrolu produktů,
-
vyhledání problémových položek,
-
kontrolu marží,
-
práci s pravidly,
-
orientaci v přeceňování,
-
shrnutí výkonu projektu,
-
analýzu sortimentu,
-
kontrolu konkurence,
-
přípravu podkladů pro další práci.
Příklad:
Místo toho, abyste ručně filtrovali produkty podle marže, můžete se AI asistenta zeptat:
Najdi mi produkty s marží nižší než 10 % a seřaď je podle obratu.AI klient přes MCP požádá Pricing Fox o odpovídající data a vrátí vám výsledek přímo v konverzaci.
Kde MCP v Pricing Foxu najdete#
MCP najdete v Pricing Foxu na několika místech.
1. V Nastavení projektu#
MCP se zobrazuje v části Nastavení v bloku Aktivní napojení.
Mezi ostatními napojeními zde najdete kartu MCP. Kliknutím na ikonu s otazníkem otevřete boční panel s návodem k propojení. V něm najdete základní informace o MCP, adresu MCP serveru Pricing Foxu a postup pro připojení k vybraným AI klientům.
2. Na stránce Napojení#
MCP najdete také na stránce Napojení, konkrétně v části Zdroje vstupních dat.
Zobrazuje se zde mezi ostatními vstupními napojeními, jako jsou Mergado, Heureka, Zboží.cz, Google Merchant, Google Analytics 4, Shoptet nebo vlastní CSV zdroj.
MCP je zde zařazené jako vstupní napojení, protože umožňuje AI klientovi přistupovat k datům projektu přes Model Context Protocol.
Nejde tedy o klasický produktový nebo statistický zdroj dat, ale o technické propojení mezi Pricing Foxem a AI asistentem.
Kliknutím na ikonu otazníku u karty MCP otevřete stejný informační panel s návodem k propojení.
3. Na stránce Přehled#
MCP se zobrazuje také na úvodní stránce Přehled v bloku Aktivní napojení.
Díky tomu hned vidíte, že je MCP součástí aktivních napojení projektu. Stejně jako u ostatních napojení zde karta ukazuje stav propojení a umožňuje rychlou orientaci v tom, jaké zdroje a výstupy má projekt aktuálně k dispozici.
Pokud u MCP vidíte informační ikonu, můžete přes ni otevřít návod k nastavení propojení s AI klientem.
MCP se v rozhraní chová jako samostatné napojení. V přehledech se zobrazuje vedle ostatních zdrojů, ale jeho účel je jiný než u běžných datových konektorů. Slouží k tomu, aby se externí AI klient mohl bezpečně připojit k Pricing Foxu a pracovat s dostupnými nástroji a daty konkrétního projektu.
Co najdete v MCP panelu ?#
V panelu najdete:
-
stručné vysvětlení, k čemu MCP slouží,
-
adresu MCP serveru Pricing Foxu,
-
postup pro získání přístupového tokenu,
-
ukázku konfigurace pro VSCode,
-
ukázku připojení pro Claude Code
Technicky:
MCP server komunikuje na adrese:
https://app-pf.bdfx.cz/mcpTuto adresu vložíte do nastavení AI klienta, kterého chcete s Pricing Foxem propojit.
Jak propojení funguje#
Propojení probíhá přes MCP server Pricing Foxu a přístupový token z Mergada.
Zjednodušeně:
-
V Mergadu si vytvoříte Personal Access Token, zkráceně PAT.
-
Token vložíte do konfigurace svého AI klienta.
-
AI klient se pomocí tokenu připojí k MCP serveru Pricing Foxu.
-
Pricing Fox ověří oprávnění a zpřístupní dostupné nástroje pro práci s projektem.
Technicky:
Autorizace probíhá přes HTTP hlavičku:
Authorization: Bearer mergado_pat_tokenToken slouží k ověření, že má AI klient oprávnění pracovat s daty projektu. Rozsah dostupných akcí závisí na oprávněních, která jsou tokenu přiřazená.
Jak získat přístupový token PAT#
Pro propojení Pricing Foxu s AI klientem je potřeba vytvořit přístupový token v Mergadu.
Postup:
-
Přihlaste se do svého účtu v Mergadu.
-
Přejděte do nastavení svého profilu.
-
Otevřete sekci API a přístupy.
-
V části Osobní přístupové tokeny klikněte na Přidat.
-
Vyplňte požadované položky.
-
Nastavte platnost tokenu.
-
Vyberte oprávnění.
-
Klikněte na Vytvořit token.
-
Vygenerovaný token si zkopírujte a bezpečně uložte.
Důležité:
Vygenerovaný token se po zavření stránky už znovu nezobrazí. Pokud ho ztratíte, bude potřeba vytvořit nový.
Doporučené nastavení tokenu#
V aktuálním návodu v aplikaci doporučujeme nastavit:
-
platnost tokenu na maximální dostupnou dobu,
-
oprávnění podle toho, co má AI klient v Pricing Foxu dělat.
Pokud má AI asistent pomáhat s plnohodnotnou správou projektu, bude potřebovat odpovídající oprávnění. Pokud ho chcete používat jen ke kontrole a čtení dat, nastavte oprávnění pouze pro čtení tam, kde to dává smysl.
Bezpečnostní doporučení:
S tokenem pracujte podobně jako s heslem. Nikomu ho neposílejte, nevkládejte ho do veřejných repozitářů a nesdílejte ho v nechráněných dokumentech.
Připojení k AI klientům#
Po vytvoření tokenu je potřeba přidat MCP server Pricing Foxu do konfigurace AI klienta.
Konkrétní postup se může lišit podle toho, jaký nástroj používáte. V aplikaci najdete ukázku pro VSCode a Claude Code.
Připojení ve VSCode#
Do konfigurace vložte následující nastavení a nahraďte hodnotu mergado_pat_token svým tokenem:
{
"servers": {
"pricing-fox": {
"url": "https://app-pf.bdfx.cz/mcp",
"type": "http",
"headers": {
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream",
"Authorization": "Bearer mergado_pat_token"
}
}
},
"inputs": []
}Po uložení konfigurace by měl AI klient rozpoznat MCP server Pricing Foxu a zpřístupnit jeho nástroje.
Připojení v Claude Code#
Do konzole vložte příkaz:
claude mcp add --transport http pricing-fox https://app-pf.bdfx.cz/mcp \
--header "Authorization: Bearer mergado_pat_token"Hodnotu mergado_pat_token nahraďte svým skutečným přístupovým tokenem.
Po připojení můžete ověřit, že je MCP server dostupný, přímo v Claude Code. Následně můžete začít zadávat dotazy nebo úkoly vztahující se k vašemu projektu v Pricing Foxu.
Co může AI asistent přes MCP dělat#
AI asistent může pracovat pouze s těmi daty a funkcemi, které mu Pricing Fox přes MCP zpřístupňuje.
Může vám pomoci například s těmito oblastmi:
Produkty:
AI může pomoci s vyhledáním a kontrolou produktů podle dostupných parametrů.
Například:
-
produkty s nízkou nebo zápornou marží,
-
produkty bez nákupní ceny,
-
produkty bez pravidla,
-
produkty s výraznou změnou ceny,
-
produkty podle zdroje referenční ceny,
-
produkty podle pozice vůči konkurenci.
Pravidla:
AI může pomoci s orientací v nastavených pravidlech a vysvětlit, jak se v projektu ceny upravují.
Například:
-
vypsat aktivní pravidla,
-
shrnout logiku konkrétního pravidla,
-
najít produkty, kterých se pravidlo týká,
-
navrhnout, jak pravidla zkontrolovat
Statistiky:
Pokud má projekt dostupná výkonnostní data, AI může pomoci s jejich interpretací.
Například:
-
shrnout objednávky, obrat nebo prokliky,
-
najít produkty s vysokým výkonem,
-
porovnat výkon vybraných skupin,
-
upozornit na výrazné změny.
Konkurence a reference:
Pokud má projekt dostupná konkurenční data, AI může pomoci s jejich vyhodnocením.
Například:
-
najít produkty, kde je váš e-shop dražší než konkurence,
-
najít produkty, kde jste nejlevnější,
-
zkontrolovat ceny podle referenčního zdroje,
-
vyhodnotit produkty podle pozice mezi nabídkami.
Důležité omezení: MCP pracuje v rámci konkrétního projektu#
Pricing Fox MCP aktuálně pracuje s nástroji uvnitř konkrétního projektu. To znamená, že AI klient neumí obecně vypsat všechny projekty Pricing Foxu, ke kterým máte přístup.
Jinými slovy:
-
MCP umí pracovat s daty konkrétního projektu,
-
neumí automaticky vypsat seznam všech vašich Pricing Fox projektů,
-
pro práci je potřeba určit konkrétní projekt nebo pracovat v jeho kontextu.
Pokud chcete s AI asistentem řešit konkrétní projekt, je vhodné mu v zadání jasně říct, o jaký projekt jde, případně pracovat v prostředí, kde je daný projekt už vybraný.
Bezpečnost a práce s daty#
MCP propojení umožňuje AI klientovi přístup k datům projektu, proto je důležité pracovat s ním opatrně.
Doporučujeme:
-
používat pouze AI klienty, kterým důvěřujete,
-
token ukládat bezpečně,
-
nesdílet token v chatu, e-mailu ani veřejných souborech,
-
pravidelně kontrolovat, kde token používáte,
-
zrušit token, který už nepotřebujete,
-
nevkládat do AI zadání citlivé údaje, pokud to není nutné.
Technicky:
PAT slouží k autorizaci požadavků mezi AI klientem a Pricing Foxem. Pokud token zrušíte nebo změníte jeho oprávnění, může se tím ovlivnit i funkčnost propojení.
Jak poznáte, že je MCP připojené správně#
Po nastavení by měl AI klient zobrazit dostupné MCP nástroje Pricing Foxu nebo být schopný odpovědět na dotaz týkající se projektu.
Můžete zkusit například jednoduchý dotaz:
Zkontroluj základní informace o aktuálním projektu v Pricing Foxu.Nebo:
Vypiš dostupné nástroje Pricing Fox MCP.Pokud AI klient vrátí chybu autorizace, zkontrolujte hlavně:
-
zda je token správně zkopírovaný,
-
zda v hlavičce používáte formát
Bearer, -
zda token nebyl zrušený nebo expirovaný,
-
zda má token potřebná oprávnění,
-
zda je správně zadaná adresa MCP serveru.
Nejčastější problémy#
AI klient hlásí chybu 401#
Chyba 401 obvykle znamená problém s autorizací.
Zkontrolujte:
-
jestli je token platný,
-
jestli jste ho vložili celý,
-
jestli je v konfiguraci uvedený ve správném formátu,
-
jestli používáte hlavičku
Authorization: Bearer ....
AI klient nevidí nástroje Pricing Foxu#
Zkontrolujte:
-
jestli je správně zadaná adresa serveru,
-
jestli AI klient podporuje MCP přes HTTP,
-
jestli jste konfiguraci uložili,
-
jestli není potřeba klienta restartovat.
AI neumí najít všechny projekty#
To je očekávané chování. Pricing Fox MCP aktuálně nepracuje se seznamem všech projektů, ale s nástroji v rámci konkrétního projektu.
AI nemá přístup k některým datům#
Důvodem může být:
-
chybějící oprávnění tokenu,
-
nedostupná data v projektu,
-
nepodporovaná akce v aktuální sadě MCP nástrojů,
-
práce mimo kontext konkrétního projektu.
Praktické příklady použití#
Rychlá kontrola projektu#
Shrň mi aktuální stav projektu a upozorni mě na věci, které bych měl zkontrolovat.Kontrola marží#
Najdi produkty s marží pod 10 % a seřaď je od nejnižší marže.Kontrola pravidel#
Vysvětli mi, podle jakých pravidel se v projektu aktuálně přeceňuje.Kontrola produktů bez potřebných dat#
Najdi produkty, kterým chybí nákupní cena nebo referenční cena.Analýza konkurence#
Najdi produkty, kde jsme výrazně dražší než hlavní konkurence.Shrnutí pro tým#
Připrav mi krátký souhrn stavu projektu pro kolegy: co funguje, co je potřeba zkontrolovat a kde vidíš největší rizika.Technické poznámky#
-
MCP server Pricing Foxu je dostupný na adrese
https://app-pf.bdfx.cz/mcp. -
Připojení probíhá přes HTTP.
-
Autorizace probíhá pomocí Mergado PAT tokenu.
-
Token se předává v HTTP hlavičce
Authorization. -
AI klient pracuje pouze s nástroji, které Pricing Fox přes MCP zpřístupňuje.
-
Rozsah dostupných akcí závisí na oprávněních tokenu.
-
Pricing Fox MCP aktuálně pracuje v kontextu konkrétního projektu, ne nad seznamem všech projektů.
-
Samotné otevření návodu v aplikaci žádná data nemění.
-
MCP propojení neznamená, že AI automaticky provádí změny bez vašeho zadání – akce vždy vychází z dostupných nástrojů, oprávnění a konkrétního požadavku v AI klientovi.
Shrnutí#
MCP v Pricing Foxu umožňuje propojit váš projekt s AI klientem a pracovat s daty pomocí přirozeného jazyka. Díky tomu můžete rychleji kontrolovat produkty, pravidla, marže, výkon nebo konkurenční situaci bez nutnosti ručně procházet jednotlivé části aplikace.
Pro propojení stačí:
-
vytvořit PAT token v Mergadu,
-
vložit ho do konfigurace AI klienta,
-
připojit MCP server Pricing Foxu,
-
začít pracovat s projektem přes AI asistenta.
MCP je vhodné hlavně pro uživatele, kteří chtějí Pricing Fox ovládat efektivněji, rychleji analyzovat data a využít AI jako pomocníka při každodenní správě pricingu.