AI asistenti (MCP)

Innovanet môžete pripojiť k AI asistentovi, napríklad Claude, ChatGPT, Cursor, GitHub Copilot alebo Gemini. Asistent potom vie v Innovanete vyhľadávať a s vaším súhlasom aj vytvárať záznamy. Používa na to MCP (Model Context Protocol), otvorený štandard na prepojenie AI asistentov s aplikáciami.

Asistent pracuje vo vašom mene a s vašimi oprávneniami. Vidí len to, čo vidíte vy v portáli, a len moduly, ktoré má vaša firma aktivované.

Čo asistent dokáže

Nástroj	Čo robí	Modul	Oprávnenie
whoami	Kto ste, vaša firma a dostupné moduly	–	čítanie
search_partners	Vyhľadá partnerov podľa názvu, IČO alebo DIČ	Adresár	čítanie
get_partner	Detail partnera: adresy, kontakty, účty, poznámky	Adresár	čítanie
list_outgoing_invoices	Zoznam vydaných faktúr (text, stav, rok, odberateľ)	Odoslané faktúry	čítanie
get_outgoing_invoice	Detail faktúry vrátane položiek a úhrad	Odoslané faktúry	čítanie
list_bills	Zoznam bločkov (stav, typ, obdobie)	Bločky	čítanie
get_bill	Detail bločku s rozpisom DPH a históriou	Bločky	čítanie
create_bill	Zapíše nový bloček (čaká na schválenie)	Bločky	zápis
list_todos	Vaše úlohy alebo úlohy tímu	Úlohy	čítanie
create_todo	Vytvorí úlohu	Úlohy	zápis
list_projects	Zoznam projektov	Projekty	čítanie

Príklady otázok pre asistenta:

• „Ktoré faktúry pre firmu ABC sú po splatnosti?“
• „Nájdi IČO a kontakty dodávateľa Slovnaft.“
• „Zapíš bloček za obed 18,50 € zo včera.“
• „Vytvor mi úlohu: zavolať klientovi do piatku.“

Vytvorenie tokenu

1. Otvorte Profil (vlastný profil) a v časti AI asistenti (MCP) kliknite na Nový token.
2. Zadajte názov, napríklad „Claude na notebooku“, aby ste token neskôr spoznali.
3. Vyberte oprávnenie:
   • len čítanie – asistent môže vyhľadávať a čítať, nič nezmení (odporúčané),
   • čítanie a zápis – asistent môže aj vytvárať bločky a úlohy.
4. Nastavte platnosť (predvolene 90 dní, najviac 365).
5. Token si hneď skopírujte. Zobrazí sa iba raz. Innovanet z neho ukladá len odtlačok (hash), takže ho nevie zobraziť znova.

V okne s tokenom je pripravená konfigurácia pre jednotlivé AI klienty na skopírovanie.

Pripojenie AI klienta

Adresa servera je https://api.innovanet.com/mcp (presnú adresu vidíte v profile). Namiesto TOKEN vložte svoj token.

Claude Code

claude mcp add --transport http innovanet https://api.innovanet.com/mcp --header "Authorization: Bearer TOKEN"

Claude Desktop (súbor claude_desktop_config.json, vyžaduje Node.js)

{
  "mcpServers": {
    "innovanet": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.innovanet.com/mcp", "--header", "Authorization: Bearer TOKEN"]
    }
  }
}

Cursor, Windsurf (súbor mcp.json)

{
  "mcpServers": {
    "innovanet": {
      "url": "https://api.innovanet.com/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

VS Code s GitHub Copilot (súbor .vscode/mcp.json)

{
  "servers": {
    "innovanet": {
      "type": "http",
      "url": "https://api.innovanet.com/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

Gemini CLI (súbor ~/.gemini/settings.json)

{
  "mcpServers": {
    "innovanet": {
      "httpUrl": "https://api.innovanet.com/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

ChatGPT a claude.ai (web) – webové konektory vyžadujú prihlásenie cez OAuth. Túto možnosť pripravujeme. Dovtedy použite niektorého z klientov vyššie.

Bezpečnosť

• Token je ako heslo. Nikomu ho neposielajte a neukladajte ho do verejných repozitárov.
• Asistent má rovnaké oprávnenia ako vy. Nevidí nič, čo nevidíte v portáli.
• Token s oprávnením len čítanie nemôže nič zmeniť ani vytvoriť.
• Nástroje na mazanie nie sú dostupné.
• Každé volanie nástroja sa zapisuje do logu aktivít firmy (modul mcp).
• V profile vidíte pri každom tokene, kedy a z akého klienta bol naposledy použitý, a koľkokrát.
• Token môžete kedykoľvek zrušiť. Prístup skončí okamžite.
• Na jeden token je limit 120 požiadaviek za minútu.
• Používatelia s prístupom iba k dochádzke tokeny používať nemôžu.

Údaje a AI poskytovatelia: Údaje, ktoré si asistent v Innovanete vyžiada, spracúva poskytovateľ vášho AI asistenta (napríklad Anthropic alebo OpenAI) podľa vašej zmluvy s ním. Pred pripojením si overte, či to vyhovuje pravidlám vašej firmy.

Riešenie problémov

Problém	Riešenie
Klient hlási 401	Token je neplatný, expirovaný alebo zrušený. Vytvorte nový.
Chýba nejaký nástroj	Modul nie je pre vašu firmu aktivovaný, alebo token má len čítanie (zapisovacie nástroje sa nezobrazia).
„This token is read-only“	Na zápis vytvorte token s oprávnením čítanie a zápis.
Klient hlási 429	Prekročili ste limit požiadaviek. Počkajte minútu.