MCP server

MCP server propojí AI nástroje s daty vašeho Elasticru. Přes něj si Claude, ChatGPT nebo jiný AI klient, který podporuje protokol MCP, prohlédne katalog a připraví úpravy kategorií, produktů a parametrů. Nic se ale nezmění, dokud změnu neschválíte.

Experimentální funkce

MCP server je zatím experimentální. Rozsah funkcí, jejich chování i způsob připojení se ještě může měnit.

O funkci

MCP (Model Context Protocol) je otevřený standard, kterým AI nástroje komunikují s okolními systémy. Elasticr přes něj AI nástroji nabízí sadu funkcí, například „najdi produkty“, „ukaž strom kategorií“ nebo „připrav přesun kategorie“. AI si podle zadání v konverzaci sama vybere, kterou funkci zavolá. Vy tedy jen napíšete, co potřebujete, třeba „najdi produkty, které nejsou v žádné kategorii, a navrhni, kam je zařadit“.

Stejné funkce používá i Elly, asistentka v administraci. Ta je volá přímo uvnitř Elasticru, kdežto vlastní AI klient se k nim připojuje přes síť. Pro oba platí stejná oprávnění i stejné schvalování změn.

Stránka je určená správci nebo IT pracovníkovi obchodu, který chce AI nástroj na data Elasticru napojit. Plány změn, které AI připravila, najdete v administraci tady:

Cesta v administraci

AI > AI agent > Plány změn

Zapnutí MCP serveru

Připojení zvenčí je na každé instalaci ve výchozím stavu vypnuté. Dokud není zapnuté, adresa MCP serveru odpovídá, jako by neexistovala, a AI klient se nepřipojí. O zapnutí požádejte podporu Elasticru.

Na Elly v administraci tento vypínač nemá vliv. Týká se jen nástrojů, které se připojují zvenčí.

Uživatel a token pro AI nástroj

AI klient se do Elasticru přihlašuje tokenem jednoho uživatele. Postup:

1. Pro AI nástroj založte samostatného uživatele. Všechno, co AI udělá, proběhne pod jeho jménem, takže v historii změn hned poznáte, co šlo přes AI.
2. Uživateli zapněte přepínač API přístup a uložte ho. Token se vygeneruje při uložení a najdete ho v poli Token.
3. Přidělte uživateli skupinu s oprávněními podle oddílu níže.

Jak se s tokenem zachází a co se stane po vypnutí API přístupu, popisuje stránka Uživatelé.

Token je heslo

Kdo token zná, pracuje v Elasticru s oprávněními toho uživatele. Vkládejte ho jen do nastavení AI klienta, nikdy přímo do konverzace.

Připojení AI klienta

V nastavení AI klienta přidejte vzdálený MCP server s těmito údaji:

Údaj	Hodnota
Adresa	https://<adresa vaší administrace>/platform/mcp
Způsob připojení	Streamable HTTP
Hlavička s tokenem	X-AUTH-TOKEN, hodnota = token uživatele

Přihlášení přes účet (OAuth) Elasticr nenabízí. Klient proto musí umět poslat vlastní hlavičku s tokenem. Pokud to váš klient nedovoluje, připojit se nedá.

Oprávnění uživatele

Co AI smí, určují oprávnění uživatele v jeho skupinách:

• Přístup k API: bez něj server připojení odmítne. Totéž oprávnění potřebuje i uživatel, který chce používat Elly.
• Katalog: prohlížení kategorií potřebuje zobrazení navigace, úpravy kategorií navíc její úpravu, zakládání nových kategorií navíc její vytvoření.
• Produkty: změny typů produktů a hodnot parametrů potřebují úpravu produktů. Pokud má AI založit novou hodnotu parametru, potřebuje uživatel navíc úpravu typů produktů.
• Parametry a typy produktů: prohlížení potřebuje zobrazení typů produktů, změny jejich úpravu a založení nového parametru nebo typu produktu navíc jejich vytvoření.
• Plány změn: zobrazení přehledu plánů v administraci a pro zahození plánu jeho úpravu.

Funkce, ke které uživatel nemá oprávnění, se AI vůbec nenabídne. AI tak o ní neví a nemůže ji zkusit použít.

Co AI umí

Přehled obchodu. AI zjistí, pod jakým uživatelem pracuje, jaké máte prodejní kanály, v jakém jazyce je obsah a jaké má omezení.

Prohlížení a rozbor katalogu:

• strom kategorií a detail kategorie včetně pravidla, filtrů a počtu produktů;
• typy produktů, parametry a jejich hodnoty;
• vyhledání produktů podle textu, kódu, typu nebo kategorie;
• vysvětlení, proč produkt v kategorii je, nebo není;
• vyzkoušení pravidla kategorie ještě předtím, než ho nastaví;
• hledání problémů ve stromu kategorií, třeba kategorie bez pravidla nebo bez produktů;
• produkty, které nejsou v žádné viditelné kategorii.

Změny kategorií: založení, úprava názvu, adresy a SEO, nastavení pravidla a filtrů, přesun ve stromu, skrytí nebo archivace. Kategorie smazat nejde, místo toho ji AI archivuje.

Hromadné změny produktů: přidání nebo odebrání typů produktů, nastavení hodnot parametrů a založení nové hodnoty parametru, třeba nové značky.

Úpravy parametrů a typů produktů: založení a úprava parametru, přejmenování a seřazení jeho hodnot, sloučení duplicitních hodnot do jedné, založení typu produktu a úprava jeho parametrů. Smaže se při tom jen hodnota, která se sloučila do jiné; produkty, které ji měly, dostanou tu ponechanou. Parametry, které spravuje import, AI měnit nemůže.

Stav úloh na pozadí. Rozsáhlé změny se provádějí na pozadí a AI průběžně sleduje, jak daleko jsou.

AI pracuje ve výchozím jazyce obsahu obchodu. Pokud máte víc prodejních kanálů, AI si vybere ten, kterého se zadání týká. Když žádný nevybere, použije výchozí kanál a upozorní na to.

Jak se schvalují změny

Žádná změna kategorií, produktů ani parametrů se neprovede rovnou. AI nejdřív připraví plán změn s náhledem, co se změní, a teprve schválený plán se provede.

• Vlastní AI klient: náhled vám AI ukáže v konverzaci a provede ho, až když s ním souhlasíte.
• Elly: plán se zobrazí na kartě v konverzaci a provedete ho, nebo zahodíte, tlačítky na kartě. Elly sama plán provést nemůže.

Pro každý plán platí:

• platí 24 hodin, potom vyprší a provést už nejde;
• vidí a provést ho může jen uživatel, který ho vytvořil;
• provede se celý, nebo vůbec. Pokud se dotčená data od přípravy plánu změnila, plán se odmítne se stavem Zastaralý a AI musí připravit nový.

Přehled plánů v administraci

Přehled Plány změn ukazuje plány, které AI připravila: shrnutí, oblast (Katalog, Produkty, Parametry), stav, počet operací, kdo plán vytvořil a kdy. U každého plánu otevřete jeho Operace a Historii. Plán ve stavu Čeká na schválení můžete tlačítkem Zahodit zrušit. Provést plán z přehledu nejde: to se dělá jen v konverzaci, kde vznikl.

Stavy plánu: Čeká na schválení, Vypršel, Ve frontě, Provádí se, Proveden, Selhal, Zahozen, Zastaralý.

Časté dotazy (FAQ)

AI klient se nepřipojí, server „neexistuje“. Co s tím?

Nejspíš není na vaší instalaci MCP server zapnutý. Požádejte o zapnutí podporu Elasticru. Zkontrolujte také, že adresa končí na /platform/mcp.

Připojení se odmítne kvůli oprávnění. Proč?

Uživatel, jehož token klient používá, nemá přístup k API. Doplňte ho v jeho skupině.

Může AI něco změnit bez mého souhlasu?

Ne. Změny kategorií, produktů a parametrů se vždy nejdřív připraví jako plán změn a provedou se až po vašem souhlasu.

AI tvrdí, že plán nejde provést. Proč?

Plán buď vypršel (platí 24 hodin), nebo se mezitím změnila data, kterých se týká. Požádejte AI, ať připraví nový plán.

Související dokumentace

• Uživatelé: API přístup a token
• Uživatelské skupiny: oprávnění
• Přehled integrací: další cesty, jak Elasticr napojit