> ## Documentation Index
> Fetch the complete documentation index at: https://vexioncards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AI asistenti (MCP)

> Pripojte Claude, ChatGPT alebo iného AI asistenta k svojmu podniku vo VEXiON, určte, čo smie robiť, a kedykoľvek ho odstráňte.

AI asistentovi môžete dovoliť pracovať s vaším podnikom vo VEXiON. Pripojíte ho raz a potom sa pýtate bežnými slovami: "Koľko nových zákazníkov sme získali tento mesiac?" alebo "Vytvor pečiatkovú kartu pre novú kaviareň."

Funguje to cez **MCP** (Model Context Protocol), otvorený štandard, ktorým AI asistenti komunikujú s iným softvérom. Server prevádzkuje VEXiON za vás. Nič neinštalujete.

Záložka **Pre vývojárov** v [Nastaveniach](https://vexioncards.mintlify.site/cs/knowledge-base/settings-overview.md) má tri časti: [API kľúče](https://vexioncards.mintlify.site/cs/knowledge-base/developer-api-keys.md), [Webhooky](https://vexioncards.mintlify.site/cs/knowledge-base/developer-webhooks.md) a **AI asistenti** (táto stránka). Táto záložka zobrazuje asistentov pripojených k podniku, ktorý máte práve otvorený v nástenke.

## Čo sa môžete spýtať

Napíšte, čo chcete, obyčajnými slovami. Nemusíte pomenovať žiadny nástroj. Čo asistent zvládne, závisí od [úrovne prístupu](#tri-úrovne-prístupu), ktorú ste zvolili.

| Opýtate sa | Čo sa stane | Prístup |
| - | - | - |
| "Koľko nových zákazníkov sme získali tento mesiac?" | Spočíta registrácie a koľkí pridali kartu do peňaženky. | Iba čítanie |
| "Nájdi zákazníčku s e-mailom [anna@example.com](mailto:anna@example.com) a povedz mi, koľko má pečiatok." | Vyhľadá zákazníka a prečíta zostatok na karte a posledné návštevy. | Iba čítanie |
| "Koľko návštev sme mali minulý týždeň v prevádzke Hlavná ulica v porovnaní s predchádzajúcim týždňom?" | Vytvorí zostavu za oba týždne a porovná ich. | Iba čítanie |
| "Aké karty máme a koľko ľudí každú drží?" | Vypíše vaše karty s počtom vydaných. | Iba čítanie |
| "Anna si práve kúpila kávu. Pridaj jej na kartu jednu pečiatku." | Zaznamená jej návštevu. | Čítanie a zápis |
| "Vytvor pečiatkovú kartu pre moju kaviareň: 8 pečiatok, deviata káva zadarmo." | Navrhne kartu, ukáže vám dizajn a vytvorí ju. | Čítanie a zápis |
| "Pošli všetkým s kávovou kartou: V piatok dvojité pečiatky!" | Ukáže vám náhľad s textom a publikom. Pošle až po vašom potvrdení. | Čítanie a zápis |

Pomenujte kartu, prevádzku alebo dátumy, keď môžete. "Návštevy v prevádzke Staré Mesto minulý týždeň" dá presnejšiu odpoveď ako "nedávne návštevy".

Ak je asistent pripojený k viacerým podnikom, pomenujte aj podnik: "Návštevy v Brew Haven minulý týždeň". Pri viacerých podnikoch každá odpoveď začína názvom podniku.

Správy zákazníkom sa nikdy neposielajú pri prvej požiadavke. Pozri [Správy zákazníkom potrebujú vaše potvrdenie](https://vexioncards.mintlify.site/cs/knowledge-base/developer-ai-assistants-safety.md#správy-zákazníkom-potrebujú-vaše-potvrdenie).

## Ktorí asistenti fungujú

Funguje každý AI asistent, ktorý vie pridať vzdialený MCP server. Tieto sú krok za krokom popísané v [návode na pripojenie](https://vexioncards.mintlify.site/ai/mcp-server.md#connect-an-assistant) (po anglicky):

* Claude (web aj desktop) a Claude Code
* ChatGPT
* Gemini CLI
* Cursor
* VS Code

Vaša AI aplikácia musí podporovať MCP server typu **Streamable HTTP**. Aplikácie, ktoré podporujú len starší typ SSE, sa nepripoja.

Adresa, ktorú v AI aplikácii pridáte, je vždy rovnaká:

```text theme={null}
https://api.vexioncards.one/mcp
```

> [!NOTE]
>
> Ponuky v AI aplikáciách sa často menia. Ak sa názov v návode líši od vašej aplikácie, hľadajte miesto, kde sa pridáva **vlastný konektor** alebo **vlastný MCP server**, a použite adresu vyššie. V ChatGPT závisí použitie od vášho plánu ChatGPT a nastavení pracovného priestoru. VEXiON to neovplyvňuje.

## Kto sa môže pripojiť

Asistenta môžete pripojiť, ak platí všetko z toho:

* Ste **administrátor** podniku. Manažéri a používatelia so skenerom asistenta pripojiť nemôžu.
* Podnik je v pláne **VEXiON PRO**. Stránka pripojenia zobrazí "Vyžaduje plán PRO" pri podniku, ktorý v ňom nie je.
* Podnik je aktívny. Podnik, ktorý je pozastavený, uzamknutý, zrušený alebo ešte neaktívny, stránka pripojenia zobrazí aj s dôvodom a nedá sa vybrať.

Tieto pravidlá platia pre každý podnik zvlášť. Ak ste administrátorom viacerých podnikov, ktoré spĺňajú podmienky, jedno pripojenie môže pokryť všetky, najviac 50 naraz. Každý podnik má vlastnú úroveň prístupu. Podnik, ktorý podmienky nespĺňa, zostane zašedlý a ostatné fungujú.

## Pripojenie asistenta

**1. Pridajte VEXiON do svojej AI aplikácie**

V AI aplikácii pridajte vlastný konektor alebo vlastný MCP server s adresou `https://api.vexioncards.one/mcp`. V Claude je to **Customize → Connectors → + Add → Add custom connector**. Postup pre jednotlivé aplikácie nájdete v [návode na pripojenie](https://vexioncards.mintlify.site/ai/mcp-server.md#connect-an-assistant).

**2. Prihláste sa do VEXiON**

V AI aplikácii kliknite na **Connect**. V prehliadači sa otvorí stránka VEXiON. Prihláste sa svojím bežným účtom VEXiON. Asistent nikdy neuvidí vaše heslo.

**3. Prejdite tri kroky**

Stránka VEXiON má tri kroky. Sú popísané nižšie.

**4. Položte prvú otázku**

V AI aplikácii sa spýtajte: "Daj mi prehľad môjho účtu VEXiON." Mal by odpovedať názvom podniku, plánom, prevádzkami a kartami.

### Tri kroky na stránke VEXiON

**1. Vyberte podniky**

Označte podniky, ktoré smie asistent používať. Uvidí iba tieto podniky. Tlačidlom **Vybrať všetky** označíte všetky podniky. Počítadlo **Podniky, ktoré môžete pripojiť: N** ukazuje, koľko podnikov spĺňa podmienky. Podnik, ktorý je už k tejto aplikácii pripojený, je označený a má štítok **Pripojený**. Podnik, ktorý sa nedá pripojiť, je zašedlý s dôvodom. Môžete vybrať najviac 50. Kliknite na **Pokračovať (N)**.

**2. Vyberte prístup**

Vyberte jednu z troch úrovní (pozri nižšie). **Iba čítanie** je označené ako **Odporúčané**. Úroveň platí pre všetky vybrané podniky: "Pre všetky vybrané podniky (N). Jeden podnik môžete zmeniť v ďalšom kroku." Kliknite na **Pokračovať**.

**3. Skontrolujte a povoľte**

Uvidíte názov aplikácie, každý podnik s jeho prístupom, zoznam toho, čo bude aplikácia môcť robiť, a web, na ktorý vás vrátime. Pri viacerých podnikoch má zoznam nadpis **V týchto podnikoch bude môcť najviac**. Kliknutím na **Povoliť** pripojíte aplikáciu, kliknutím na **Zamietnuť** skončíte. Kým nekliknete na **Povoliť**, nie je nič pripojené.

### Zmena jedného podniku pred povolením

Pri kontrole má každý podnik dve tlačidlá. Kým nekliknete na **Povoliť**, nič sa neuloží.

* **Upraviť prístup** (ceruzka): otvorí **Prístup pre** tento podnik. Zmení sa iba tento podnik. Ostatné si prístup ponechajú. Vyberte úroveň a kliknite na **Uložiť**. Aj **Späť** vás vráti na kontrolu.
* **Odstrániť** (X): vyradí podnik zo zoznamu.

Kliknutím na **Pridať ďalší podnik** sa vrátite na prvý krok.

### Opätovné pripojenie aplikácie

Opätovné pripojenie aplikácie **nahradí** jej zoznam podnikov. Podniky, ktoré už má, sú od začiatku označené a majú štítok **Pripojený**. Podnik, ktorý odznačíte alebo odstránite, sa po kliknutí na **Povoliť** vynechá a aplikácia k nemu stratí prístup. Podnik, ktorý už nie je dostupný, napríklad pre stratu role administrátora alebo odchod z plánu VEXiON PRO, je sivý a tiež sa vynechá.

Ak majú označené podniky dnes rôzny prístup, krok 2 nemá vybranú úroveň. Kliknite na **Skontrolovať** a každý pripojený podnik si ponechá svoj prístup, nový podnik dostane **Iba čítanie**. Alebo vyberte jednu úroveň pre všetky.

### Kedy sa nový zoznam spustí

Nič sa nezmení, kým nekliknete na **Povoliť**. Potom sa nový zoznam spustí prvou požiadavkou AI aplikácie. Aplikácia ju musí poslať do 10 minút, inak povolenie vyprší. Dovtedy platí:

* aplikácia si ponechá starý prístup
* vyšší prístup čaká
* nižší prístup platí hneď
* podnik, ktorý ste odstránili, sa stane iba na čítanie
* podnik, ktorý ste pridali, zatiaľ nemá žiadny prístup

> [!WARNING]
>
> Povoľte iba aplikácie, ktorým dôverujete. VEXiON nekontroluje, čo AI aplikácia s vašimi údajmi robí po povolení. Krok kontroly vám to pripomenie. Po pripojení nechajte v AI aplikácii zapnuté schvaľovanie nástrojov pri činnostiach, ktoré posielajú správy alebo menia údaje.

## Tri úrovne prístupu

| Úroveň | Asistent môže | Asistent nemôže |
| - | - | - |
| **Iba čítanie** (odporúčané) | Prezerať vaše údaje: karty, zákazníkov, transakcie, produkty, prevádzky, odoslané notifikácie a zostavy | Nič meniť ani písať zákazníkom |
| **Čítanie a zápis** | Všetko z úrovne Iba čítanie a navyše údaje vytvárať a meniť a posielať správy zákazníkom | Nič zo [zoznamu vecí, ktoré nemôže nikdy](https://vexioncards.mintlify.site/cs/knowledge-base/developer-ai-assistants-safety.md#čo-asistent-nemôže-nikdy) |
| **Vlastné nastavenie** | Len to, čo povolíte, oblasť po oblasti | Čokoľvek, čo necháte na **Žiadny** |

Pri úrovni **Vlastné nastavenie** vyberáte **Žiadny**, **Čítanie** alebo **Zápis** pre každú oblasť: Karty, Zákazníci, Transakcie, Produkty a Prevádzky. Pri Notifikáciách vyberáte **Žiadny**, **Čítanie** alebo **Posielať správy**. Musíte povoliť aspoň jednu oblasť.

Posielanie správ zákazníkom vyžaduje **Zápis** do Zákazníkov. VEXiON ho zapne za vás, keď zvolíte **Posielať správy**.

Nech zvolíte čokoľvek, asistent vždy vidí názov, plán a definície vlastných polí vášho podniku.

> [!TIP]
>
> Začnite s úrovňou **Iba čítanie**. Väčšina otázok, ako sú zostavy a vyhľadávanie, nepotrebuje viac. Vyššiu úroveň môžete neskôr nastaviť cez [Zmenu prístupu](#zmena-prístupu).

Keď povolíte zápis, krok kontroly vám tiež pripomenie: zápis aktualizuje karty zákazníkov v peňaženke a môže spustiť automatické správy vášho podniku, napríklad pri dosiahnutí odmeny.

## Zobrazenie pripojených aplikácií

Prejdite do **Nastavenia → Pre vývojárov** a otvorte záložku **AI asistenti**. Záložka zobrazuje aplikácie pripojené k podniku, ktorý máte práve otvorený v nástenke. Ak chcete vidieť aplikácie iného podniku, najprv otvorte tento podnik. Každá pripojená aplikácia zobrazuje:

* názov aplikácie a úroveň prístupu (**Iba čítanie**, **Čítanie a zápis** alebo **Vlastné**)
* stav: **Aktívna**, alebo **Čaká na prvé použitie**, ak ste ju povolili, ale ešte nič nevykonala
* kto ju pripojil ("Pripojil(a) ...")
* kedy bola naposledy použitá, alebo **Zatiaľ nepoužité**

Ak nie je pripojená žiadna aplikácia, záložka to oznámi a pripomenie, že máte pridať server VEXiON do svojej AI aplikácie.

> [!NOTE]
>
> Záložku **AI asistenti** vidia len administrátori a len pri podniku v pláne VEXiON PRO. V pláne VEXiON cards ONE vám záložka Pre vývojárov namiesto toho ponúkne prechod na vyšší plán.

## Zmena prístupu

Prístup aplikácie môžete zmeniť bez nového pripájania. Zmena sa týka iba podniku, ktorý máte otvorený.

**1. Otvorte záložku AI asistenti**

Prejdite do **Nastavenia → Pre vývojárov → AI asistenti**.

**2. Kliknite na Zmeniť prístup**

Nájdite aplikáciu a kliknite na **Zmeniť prístup**. Tlačidlo je pri riadkoch so stavom **Aktívna**. Otvorí sa okno **Zmeniť prístup pre** danú aplikáciu.

**3. Vyberte úroveň**

Zvoľte **Iba čítanie**, **Čítanie a zápis** alebo **Vlastné nastavenie**. Pozri [tri úrovne prístupu](#tri-úrovne-prístupu).

**4. Kliknite na Uložiť**

Zmení sa iba tento podnik. Platí od ďalšej požiadavky aplikácie.

Čo uvidí AI aplikácia:

* Aplikácia sa o zmene nedozvie. Zistí ju pri ďalšej požiadavke.
* Nižšia úroveň platí hneď.
* Nástroj, ktorý aplikácia predtým nemala, sa zobrazí, keď začne nový chat (v Claude a ChatGPT).

> [!NOTE]
>
> Väčší prístup môže dať iba osoba, ktorá aplikáciu pripojila. Ktorýkoľvek iný administrátor podniku ho môže iba znížiť. Uvidí poznámku "Väčší prístup môže dať iba osoba, ktorá aplikáciu pripojila. Vy ho môžete znížiť." a rovnakú správu dostane, ak sa ho pokúsi zvýšiť. Ak chcete aplikácii dať viac prístupu, požiadajte osobu, ktorá ju pripojila.

## Odstránenie aplikácie

**1. Otvorte záložku AI asistenti**

Prejdite do **Nastavenia → Pre vývojárov → AI asistenti**.

**2. Kliknite na Odvolať**

Nájdite aplikáciu, kliknite na **Odvolať** a potvrďte. Aplikácia okamžite stratí prístup k tomuto podniku. Ostatné podniky, ku ktorým je pripojená, si prístup ponechajú.

Ak to bol posledný podnik aplikácie, aplikácia sa odpojí úplne.

Aplikácia so stavom **Čaká na prvé použitie** má namiesto toho tlačidlo **Odmietnuť**. Použite ho, ak nechcete, aby sa aplikácia pripojila.

Tú istú aplikáciu môžete neskôr pripojiť znova. Podniky a úroveň prístupu si potom zvolíte nanovo.

Prístup sa skončí aj sám, približne do 60 sekúnd, keď prestanete byť administrátorom, keď podnik opustí plán VEXiON PRO alebo keď je podnik pozastavený, uzamknutý alebo zrušený.

## Ďalšie kroky

> [card] [Bezpečnosť a otázky](https://vexioncards.mintlify.site/cs/knowledge-base/developer-ai-assistants-safety.md)
>
> Čo asistent môže a nemôže robiť, prečo správy zákazníkom potrebujú vaše potvrdenie a odpovede na časté otázky.

> [card] [Návod na pripojenie pre každú aplikáciu](https://vexioncards.mintlify.site/ai/mcp-server.md#connect-an-assistant)
>
> Presný postup pre Claude, ChatGPT, Claude Code, Cursor, VS Code a Gemini CLI (po anglicky).

> [card] [Pre vývojárov](https://vexioncards.mintlify.site/ai/mcp-server.md)
>
> Technické stránky: všetky nástroje, oprávnenia, limity a prihlásenie API kľúčom (po anglicky).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.