MCP server

MCP server vám umožní získat asistenta, který vám snadno dokáže odpovědět na dotazy týkající se vašeho eshopu, aniž byste mu museli poskytovat exporty dat, nebo ho učit základní věci jako co je to eshop, jak fungují objednávky atd.

Hlavní výhodou propojení s MCP serverem je, že je mnohem levnější, než kdybyste do AI nechali napojit kompletní API eshopu.

Postup propojení

Aby propojení fungovalo, je nutné aktivovat doplněk MCP server.

1. Výběr AI nástroje
   MCP server lze propojit s několika AI nástroji. Záleží pouze na tom, zda-li poskytovatelé AI nástroje připojení umožní. Nejčastěji používanými jsou: Claude a ChatGPT
2. Připojení MCP serveru
   Připojení MCP serveru má každý AI nástroj jinak. Nejlepší možností je, se zeptat samotného AI nástroje v chatu.
   "Potřebuji připojit MCP server, jak to nejlépe přes tvou aplikaci udělat"
   AI vám následně popíše postup samotného připojení.
   Pokud se dostanete do fáze, kdy budete potřebovat URL adresu MCP serveru, najdete jí vždy po aktivaci doplňku v sekci Doplňky / API, MCP server
   https://AdrasaVasiAdministrace.upgates.com/mcp/statistics
   
   • Ilustrační manuály propojení
     • GPT
     • Claude
     • Cursor
3. Ověření účtu
   Jedním z bodů propojení bude, že si MCP server vyžádá OAuth ověření.
   
   • Po povolení přístupu je AI nástroj propojen s Upgates.

Ověření účtu (OAuth)

Při připojení Upgates MCP serveru budete vyzváni k přihlášení do svého Upgates účtu. Ověření probíhá pomocí zabezpečeného protokolu OAuth, takže své přihlašovací údaje nezadáváte přímo do AI nástroje.

1. AI nástroj zahájí ověření
2. Budete přesměrování na OAuth ověření
   Pokud do eshopu ještě nejste přihlášení, budete se muset nejdříve přihlásit
3. Zobrazí se potvrzovací stránka
   
   
   • Vyberte k čemu bude mít aplikace přístup 
     • openid – Umožňuje ověřit vaši identitu a bezpečně vás přihlásit prostřednictvím Upgates účtu.
     • profile – Umožňuje získat uživatelské jméno.
     • email – Umožňuje získat uživatelskou e-mailovou adresu.
       Přednastavení zobrazení / předschválení těchto polí můžete určit podle nápovědy OAuth funkce.
   • Povolit přístup - Udělíte přístup k propojení MCP serveru
   • Odmítnout - Zrušíte ověřování účtu
4. Po povolení se spáruje MCP server eshopu s vaším AI nástrojem.
   MCP server bude mít přístup pouze k funkcím a datům, které odpovídají oprávněním přihlášeného uživatele.

Uživatelská práva

MCP server při práci kontroluje nejen, že uživatel jako takový v e-shopu stále existuje, ale také že má i dostatečná práva.

• Seznam plateb
  • Nastavení / Objednávky / Platby - Právo: Zobrazit
• Seznam doprav
  • Nastavení / Objednávky / Dopravy - Právo: Zobrazit
• Seznam stavů pro objednávky
  • Nastavení / Objednávky / Stavy - Právo: Zobrazit
• Odpověď na počet
  • Objednávky / Seznam objednávek - Právo: Zobrazit
• Souhrn
  • Objednávky / Seznam objednávek - Právo: Zobrazit
• Objednávky
  
  • Objednávky / Seznam objednávek - Právo: Zobrazit

Limity a omezení

MCP server funguje za pomocí API komunikace. Každý eshop má určitý počet požadavků, které může přes API využít zdarma.

Maximální počet požadavků se odvíjí od tarifu e-shopu a od individuálně navýšeného API limitu. Po vyčerpání dostupného limitu není možné další požadavky dočasně zpracovat.
Pokud máte zároveň aktivní doplněk API, počet API požadavků není oddělený, ale sčítá se dohromady s MCP požadavky do celkového limitu počtu požadavků.

• Soupis základního počtu požadavků, které jsou Zdarma dle zvoleného tarifu.
• Individuální navýšení počtu požadavků

Odebrání přístupu

Přístup uživateli k MCP serveru lze udělat ze dvou míst.

Ze strany uživatele

1. Otevřete administraci Upgates
2. V levém menu vyberte Můj profil / Profil
3. V sekci Propojené aplikace odpárujte příslušné AI klienty, které již nechcete používat.

Ze strany administrátora

1. Otevřete administraci Upgates
2. V levém menu vyberte Nastavení / Administrace / Uživatelé
3. Vyberte uživatele, kterému chcete přístup zakázat
4. V horní sekci ve Funkcích administrace odklikněte Upgates MCP

Bezpečnost dat

Je důležité si uvědomit, že MCP server není AI, je to jen můstek předávající data, nepracuje s nimi.
Dávejte také pozor na to, jaké informace dáváte samotnému AI klientovi.
Upgates, ani MCP server po vás nikdy nebude chtít do chatu zaslat přístupové údaje do eshopu, nebo jiného prostředí. 

Podpora

Pozor! Upgates neposkytuje podporu spojenou s propojováním, rozhraním a funkcemi samotných AI nástrojů.