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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/rocketoo-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
