> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/rocketoo-mcp.md).

# Rocketoo MCP

Modul **Rocketoo MCP** propojí váš e-shop s moderními AI asistenty (např. Claude). Umožní bezpečně číst data z obchodu — objednávky, produkty, zákazníky i přehled prodejů — přímo v konverzaci s asistentem, bez ručního exportu do tabulek.

Modul vám umožňuje:

* Ptát se na objednávky a zákazníky v přirozeném jazyce
* Rychle zjistit stav skladu nebo prodeje konkrétního zboží
* Sledovat tržby a statistiky za zvolené období
* Omezit, kdo z týmu k jakým datům smí — každý uživatel jen to, co potřebuje
* Nechat AI pracovat jen s **aktuálními** daty z e-shopu, ne se starými exporty

## K čemu modul slouží

Běžně řeší tyto potřeby:

* **Zákaznická podpora** — „Kolik objednávek má zákazník Novák?“, „V jakém stavu je objednávka č. 2025-0042?“
* **Obchod a marketing** — „Co se nejvíc prodávalo minulý měsíc?“, „Které produkty mají nízký sklad?“
* **Vedení a reporting** — rychlý přehled tržeb, počtu objednávek nebo chování zákazníků bez ručního stahování reportů
* **Interní tým** — každý pracuje ve svém AI chatu, ale všichni čerpají ze stejného zdroje pravdy (váš e-shop)

Modul **nemění** objednávky, ceny ani sklad. Slouží pouze ke **čtení** dat. Zápis do e-shopu zůstává v administraci Rocketoo jako doteď.

## Co umí propojení s AI asistentem

Po správném nastavení může asistent (podle oprávnění uživatele) odpovídat například na:

### Objednávky

* Seznam objednávek podle data, stavu, zákazníka nebo částky
* Detail jedné nebo více objednávek včetně položek, dopravy a platby
* Objednávky obsahující konkrétní produkt nebo zákazníka

### Zákazníci

* Souhrn zákazníka — kolik objednal, celková útrata, první a poslední nákup
* Vyhledání podle e-mailu

### Produkty a sklad

* Vyhledání v katalogu podle názvu, kategorie nebo kódu zboží
* Produkty s nízkým nebo záporným skladem
* Prodeje konkrétního produktu v čase

### Statistiky

* Tržby a počet objednávek za den, týden, měsíc nebo vlastní období
* Přehled „kdo nakupuje nejvíc“, „co se prodává nejvíc“ nebo podle kategorie či dopravce

{% hint style="info" %}
**Tip:** Čím konkrétnější je dotaz, tím přesnější odpověď dostanete. Místo „ukaž objednávky“ raději „ukaž objednávky z minulého týdne nad 3 000 Kč“.
{% endhint %}

## Kdo má přístup a bezpečnost

### Přihlášení uživatelů

Každý, kdo se k obchodu připojí přes AI klienta, se **přihlásí stejným firemním účtem**, který spravuje váš administrátor. Anonymní přístup k datům e-shopu není možný.

### Jen čtení

Modul **neumožňuje** přes AI asistenta:

* měnit stavy objednávek
* upravovat ceny nebo sklad
* zakládat produkty nebo zákazníky

Všechny změny v e-shopu provádíte dál v administraci Rocketoo.

### Záznamy o použití

Systém může zapisovat, kdo a kdy si data přes propojení vyžádal. To pomáhá při kontrole a dohledání případných dotazů.

## Napojení Clauda na váš e-shop

Následující kroky obvykle provádí **správce IT** nebo **odpovědná osoba za Authentik**. Běžný uživatel pak jen propojí účet v Claudovi.

### Co je potřeba předem

* Aktivní modul Rocketoo MCP na vašem e-shopu
* Nastavená adresa propojení (URL vašeho obchodu)
* Uživatelský účet pro přihlášení přes OAuth.

### Postup pro koncového uživatele (Claude.ai)

1. Otevřete **Nastavení → Konektory** (Connectors) v Claude.ai
2. Přidejte **vlastní konektor** (Custom connector) s adresou, kterou vám sdělí administrátor
3. Dokončete **přihlášení** — přesměruje vás na firemní login
4. Po úspěšném připojení **zapněte konektor v konkrétním chatu** (ikona konektorů u pole pro zprávu)
5. Ptejte se v běžné češtině na data z obchodu

### Pokud konektor nefunguje

* Ověřte, že jste konektor **zapnuli v daném chatu**, nejen v globálním nastavení
* Zkuste konektor **odpojit a znovu připojit**

## Typické situace v praxi

### Situace 1: Dotaz zákazníka na telefonu

Zákazník volá: „Objednal jsem včera, kde je balík?“\
Podpora v Claudovi: *„Najdi objednávky zákazníka <jan.novak@email.cz> za poslední tři dny.“*\
Asistent vrátí stav objednávky a údaje o dopravě.

### Situace 2: Ranní přehled pro vedoucího

Vedoucí: *„Kolik jsme utržili včera a kolik objednávek přibylo?“*\
Asistent spočítá statistiky za včerejší den bez otevírání administrace.

### Situace 3: Kontrola skladu

Skladník nebo nákupčí: *„Které produkty mají sklad nulový nebo záporný?“*\
Asistent vypíše seznam k doplnění nebo kontrole.

### Situace 4: Marketing

Specialista: *„Co se nejvíc prodávalo v březnu a kdo byli největší zákazníci?“*\
Asistent sestaví přehled podle dostupných statistik (v rámci oprávnění účtu).

## Často kladené otázky

<details>

<summary>Může AI asistent něco změnit v mém e-shopu?</summary>

Ne. Modul umožňuje pouze **čtení** dat. Objednávky, produkty a sklad upravujete v administraci Rocketoo.

</details>

<details>

<summary>Vidí zákazníci na e-shopu, že používáme AI?</summary>

Ne. Propojení je interní pro váš tým. Návštěvníci e-shopu s tím nepřijdou do styku.

</details>

<details>

<summary>Musím něco dělat v administraci Rocketoo při každém dotazu?</summary>

Ne. Po jednorázovém nastavení a přihlášení v Claudovi stačí psát dotazy v chatu.

</details>

<details>

<summary>Q: Funguje to i na mobilu?</summary>

Ano, pokud váš AI klient (např. Claude) podporuje konektory na mobilní aplikaci a máte aktivní přihlášení.

</details>

<details>

<summary>Co když asistent řekne, že nemá k dispozici data obchodu?</summary>

Nejčastěji není v daném chatu zapnutý konektor e-shopu, nebo váš účet nemá přidělená oprávnění. Ověřte obojí u administrátora.

</details>

<details>

<summary>Je to stejné jako export objednávek do Excelu?</summary>

Ne. Data se tahají **živě** z e-shopu v momentě dotazu. Nemusíte ručně aktualizovat soubory.

</details>

<details>

<summary>Q: Kolik lidí se může připojit najednou?</summary>

Více uživatelů může pracovat paralelně. Každý pod svým účtem a podle svých oprávnění.

</details>