AI asistenti (MCP)

Innovanet můžete připojit k AI asistentovi, například Claude, ChatGPT, Cursor, GitHub Copilot nebo Gemini. Asistent pak umí v Innovanetu vyhledávat a s vaším souhlasem i vytvářet záznamy. Používá k tomu MCP (Model Context Protocol), otevřený standard pro propojení AI asistentů s aplikacemi.

Asistent pracuje vaším jménem a s vašimi oprávněními. Vidí jen to, co vidíte vy v portálu, a jen moduly, které má vaše firma aktivované.

Co asistent umí

Nástroje jsou rozdělené podle modulů: partneři, faktury, platby, účtenky, úkoly, projekty, objednávky, smlouvy, servicedesk, události, docházka, žádosti, organizace, rezervace, služební cesty, pokladna, pošta, majetek a reporty jednotlivých sekcí. Asistent vidí jen nástroje modulů, které má vaše firma aktivované. Platby a pokladnu navíc jen tehdy, máte-li na ně oprávnění v portálu. Nástroje se zápisem jsou dostupné jen s oprávněním čtení a zápis.

Obecné

Nástroj	Co dělá	Oprávnění
whoami	Kdo jste, vaše firma, moduly a dostupné nástroje	čtení

Profil zaměstnance

Nástroj	Co dělá	Oprávnění
get_my_profile	Váš profil: pozice, útvar, nadřízený, smlouva, kontakt, vzdělání (bez citlivých údajů)	čtení
get_employee_profile	Profil kolegy v rozsahu, který vidíte v portálu	čtení
search_employees	Vyhledá kolegu podle jména nebo e-mailu	čtení
list_qualifications	Certifikáty, školení, lékařské prohlídky, oprávnění, jazyky	čtení
list_expiring_qualifications	Končící a propadlé kvalifikace	čtení

Adresář

Nástroj	Co dělá	Oprávnění
search_partners	Vyhledá partnery podle názvu, IČO nebo DIČ	čtení
get_partner	Detail partnera: adresy, kontakty, účty, poznámky	čtení
create_partner	Přidá partnera (i s adresou a kontaktní osobou)	zápis
update_partner	Upraví název, identifikátory, web, poznámku, aktivitu	zápis
add_partner_contact	Přidá kontaktní osobu	zápis
add_partner_note	Přidá poznámku (např. shrnutí hovoru)	zápis

Vydané faktury

Nástroj	Co dělá	Oprávnění
list_outgoing_invoices	Seznam vydaných faktur (text, moje, po splatnosti, rok, odběratel)	čtení
get_outgoing_invoice	Detail faktury včetně položek a úhrad	čtení

Přijaté faktury

Nástroj	Co dělá	Oprávnění
list_incoming_invoices	Seznam přijatých faktur (text, rok, měsíce, dodavatel)	čtení
get_incoming_invoice	Detail přijaté faktury se schvalováním a úhradami	čtení

Platby

Nástroj	Co dělá	Oprávnění
list_payments	Bankovní platby (datum, částka, IBAN, partner, spárování)	čtení
get_payment	Detail platby a doklady, ke kterým patří	čtení
list_unaccounted_payments	Nespárované platby za měsíc	čtení

Účtenky

Nástroj	Co dělá	Oprávnění
list_bills	Seznam účtenek (stav, typ, období)	čtení
get_bill	Detail účtenky s rozpisem DPH a historií	čtení
create_bill	Zapíše novou účtenku (čeká na schválení)	zápis
update_bill	Upraví neschválenou účtenku	zápis
add_bill_comment	Přidá komentář k účtence	zápis

Úkoly

Nástroj	Co dělá	Oprávnění
list_todos	Vaše úkoly nebo úkoly týmu	čtení
get_todo	Detail úkolu s historií	čtení
list_todo_users	Uživatelé, kterým lze přiřadit úkol	čtení
create_todo	Vytvoří úkol	zápis
update_todo	Upraví úkol (termín, priorita, řešitel …)	zápis
add_todo_note	Přidá komentář k úkolu	zápis
resolve_todo	Označí úkol jako vyřízený	zápis
reopen_todo	Znovu otevře úkol	zápis

Projekty

Nástroj	Co dělá	Oprávnění
list_projects	Seznam projektů	čtení
get_project	Detail projektu s finančním přehledem	čtení
get_project_financials	Doklady za tržby, náklady a režii projektu	čtení

Objednávky

Nástroj	Co dělá	Oprávnění
list_orders	Seznam objednávek (text, partner, projekt, typ, stav zpracování, platnost)	čtení
get_order	Detail objednávky: strany, položky, částky, soubory (metadata) a poznámky	čtení
list_order_types	Typy objednávek	čtení
list_order_statuses	Stavy zpracování objednávek	čtení
add_order_note	Přidá poznámku k objednávce (samotnou objednávku nemění)	zápis

Smlouvy

Nástroj	Co dělá	Oprávnění
list_contracts	Seznam smluv (text, partner, projekt, typ, platnost)	čtení
get_contract	Detail smlouvy: strany, položky, částky, soubory (metadata) a poznámky	čtení
list_contract_types	Typy smluv	čtení
add_contract_note	Přidá poznámku ke smlouvě (samotnou smlouvu nemění)	zápis

Servicedesk

Nástroj	Co dělá	Oprávnění
list_tickets	Seznam tiketů	čtení
get_ticket	Detail tiketu s komentáři a historií	čtení
list_ticket_categories	Kategorie tiketů	čtení
create_ticket	Nahlásí incident nebo požadavek	zápis
add_ticket_comment	Přidá komentář k tiketu	zápis
change_ticket_status	Změní stav tiketu (řešitel nebo operátor)	zápis

Události

Nástroj	Co dělá	Oprávnění
list_events	Události v období	čtení
get_event	Detail události	čtení
create_event	Přidá událost (s oprávněním na události)	zápis

Docházka

Nástroj	Co dělá	Oprávnění
get_my_attendance	Vaše záznamy docházky	čtení
list_my_absences	Vaše nepřítomnosti a jejich schválení	čtení
list_absence_reasons	Typy nepřítomnosti	čtení
get_attendance_month	Měsíční přehled: fond, odpracováno, saldo, přesčasy, stravné (kolegové jen pro vedoucího/HR, bez důvodů nepřítomnosti)	čtení
who_is_at_work	Kdo je v práci a kdo chybí (bez důvodu)	čtení
attendance_check_in	Zapíše váš příchod (i na projekt)	zápis
attendance_check_out	Zapíše váš odchod	zápis
request_absence	Požádá o nepřítomnost (např. dovolenou)	zápis

Žádosti

Nástroj	Co dělá	Oprávnění
list_request_forms	Formuláře žádostí	čtení
get_request_form	Pole formuláře a limit	čtení
list_my_requests	Vaše žádosti a jejich stav	čtení
get_request	Detail žádosti	čtení
submit_request	Podá žádost ke schválení	zápis

Organizace

Nástroj	Co dělá	Oprávnění
find_person	Najde kolegu: útvar, pozice, nadřízený, kontakt	čtení
get_my_manager	Váš nadřízený	čtení
list_org_units	Organizační útvary	čtení

Rezervace

Nástroj	Co dělá	Oprávnění
list_reservation_resources	Místnosti, auta a zařízení k rezervaci	čtení
list_reservations	Rezervace v období	čtení
check_reservation_overlap	Ověří, zda je termín volný	čtení
create_reservation	Zarezervuje místnost, auto nebo zařízení	zápis

Služební cesty

Nástroj	Co dělá	Oprávnění
list_my_business_trips	Vaše služební cesty	čtení
get_business_trip	Detail cesty (vlastní nebo schvalované)	čtení

Pokladna

Nástroj	Co dělá	Oprávnění
list_cash_records	Pokladní doklady	čtení
get_cash_record	Detail pokladního dokladu	čtení

Pošta

Nástroj	Co dělá	Oprávnění
list_post	Došlá a odeslaná pošta	čtení
get_post	Detail zásilky	čtení

Majetek

Nástroj	Co dělá	Oprávnění
list_assets	Majetek (vlastní, správce vidí vše): text, kategorie, stav, držitel, sklad, aktivní, končící záruka	čtení
get_asset	Detail majetku: kategorie, držitel, sklad, stav, cena, záruka, vlastní pole, komentáře a přílohy (metadata)	čtení
get_asset_history	Historie životního cyklu (předání, vrácení, přesun, oprava, vyřazení, prodej) a protokoly	čtení
list_assets_by_user	Majetek podle osob a označení (např. místnost) s počty	čtení
list_asset_categories	Kategorie majetku	čtení
list_asset_warehouses	Sklady a místa uložení	čtení
list_pending_asset_protocols	Protokoly, které čekají na vaše převzetí	čtení
get_asset_protocol	Detail předávacího, přebíracího nebo vyřazovacího protokolu	čtení
list_asset_requests	Žádosti o majetek a stav jejich schvalování	čtení
get_asset_request	Detail žádosti o majetek s úkoly a komentáři	čtení
create_asset_request	Podá žádost o nový majetek nebo o odkoupení používaného (spustí schvalování)	zápis
add_asset_comment	Přidá komentář k majetku (např. porucha, chybějící příslušenství)	zápis

Reporty a přehledy

Stejné souhrny, jaké vidíte na stránkách reportingu a na nástěnce portálu. Každý report má oprávnění své stránky v portálu.

Nástroj	Co dělá	Oprávnění
get_outgoing_invoices_report	Roční report vydaných faktur: počty a částky po měsících, top 10 odběratelů, před splatností a po splatnosti	čtení
get_incoming_invoices_report	Roční report přijatých faktur: počty a částky po měsících, top 10 dodavatelů, před splatností a po splatnosti	čtení
get_financial_overview	Měsíční přehled: příjmy, výdaje, zisk, změna oproti minulému měsíci, top 5 odběratelů	čtení
get_yearly_income	Fakturované příjmy po měsících za rok	čtení
get_payments_stats	Přijaté a odeslané platby za měsíc, saldo, změna a nespárované platby (oprávnění na platby)	čtení
get_cashflow	Cashflow firmy za období: očekávané a skutečné příjmy a výdaje po týdnech a měsících (oprávnění na platby)	čtení
get_project_cashflow	Cashflow jednoho projektu za období	čtení
get_treasury_stats	Součty pokladny za období: příjmy, výdaje, počty (oprávnění na pokladnu)	čtení
get_servicedesk_stats	Počty tiketů podle stavu, volitelně za rok	čtení
get_my_attendance_report	Váš podrobný měsíční report docházky po dnech: fond, odpracováno, přestávky, přesčasy, stravné, projekty	čtení
get_team_attendance_overview	Uzávěrka docházky lidí, které vidíte: fond, odpracováno, saldo, přesčasy a stav uzávěrky (bez důvodů nepřítomnosti)	čtení
get_vehicles_report	Měsíční report vozidel s knihou jízd: finanční nebo HR (oprávnění na vozidla)	čtení

Citlivé osobní údaje (IBAN, mzda, rodné číslo, doklady, zdravotní pojišťovna, soukromý kontakt) se přes MCP neposílají nikdy, ani uživatelům z HR.

Příklady dotazů pro asistenta:

• „Které faktury pro firmu ABC jsou po splatnosti?“
• „Jaký byl obrat v září a kdo byli naši největší odběratelé?“
• „Kolik přijatých faktur máme po splatnosti a za kolik?“
• „Najdi IČO a kontakty dodavatele a přidej k němu poznámku z dnešního hovoru.“
• „Které smlouvy s firmou ABC platí a do kdy? Přidej ke smlouvě poznámku o dohodnutém prodloužení.“
• „Jaké objednávky čekají na schválení?“
• „Který majetek mám přidělený a kterému končí záruka?“
• „Požádej o nový monitor pro nového kolegu v grafickém oddělení.“
• „Zapiš účtenku za oběd 18,50 € ze včerejška.“
• „Vytvoř mi úkol: zavolat klientovi do pátku.“
• „Požádej o dovolenou od 22. do 23. prosince.“
• „Je zasedačka volná zítra od 10:00 do 11:00? Pokud ano, zarezervuj ji.“
• „Nahlas na servicedesk, že nefunguje tiskárna ve 2. patře.“

Co asistent záměrně nedělá: nemaže záznamy a neprovádí ani nepřipravuje platby. Úhrady jdou nadále jen přes portál po vygenerování SEPA souboru. Faktury, platby, pokladna a všechny reporty jsou jen ke čtení. U objednávek, smluv a majetku umí asistent přidat poznámku nebo komentář a podat žádost o majetek; samotné doklady, jejich stavy a majetek (přesun, vyřazení, prodej, převzetí protokolu) se mění jen v portálu.

Vytvoření tokenu

1. Otevřete Profil (vlastní profil) a v části AI asistenti (MCP) klikněte na Nový token.
2. Zadejte název, například „Claude na notebooku“, abyste token později poznali.
3. Vyberte oprávnění:
   • jen čtení – asistent může vyhledávat a číst, nic nezmění (doporučeno),
   • čtení a zápis – asistent může i vytvářet účtenky a úkoly.
4. Nastavte platnost (výchozí 90 dní, nejvýše 365).
5. Token si hned zkopírujte. Zobrazí se jen jednou. Innovanet z něj ukládá jen otisk (hash), takže ho nedokáže zobrazit znovu.

V okně s tokenem je připravená konfigurace pro jednotlivé AI klienty ke zkopírování.

Připojení AI klienta

Adresa serveru je https://api.innovanet.com/mcp (přesnou adresu vidíte v profilu). Místo TOKEN vložte svůj token.

Claude Code

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

Claude Desktop (soubor 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 (soubor mcp.json)

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

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

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

Gemini CLI (soubor ~/.gemini/settings.json)

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

ChatGPT a claude.ai (web) – přihlášení bez tokenu

Webové konektory se připojují přes OAuth: token nevytváříte, přihlásíte se přímo do Innovanetu.

1. V asistentovi otevřete nastavení konektorů:
   • claude.ai – Settings → Connectors → Add custom connector,
   • ChatGPT – Settings → Connectors (vyžaduje režim vývojáře nebo firemní plán s vlastními konektory).
2. Zadejte adresu serveru https://api.innovanet.com/mcp (přesnou adresu najdete v profilu v části AI asistenti (MCP)). Client ID ani secret nevyplňujte.
3. Asistent otevře přihlášení do Innovanetu. Přihlaste se (pokud ještě nejste) a na obrazovce souhlasu:
   • zkontrolujte název aplikace, která žádá o přístup,
   • vyberte firmu, se kterou má asistent pracovat,
   • vyberte oprávnění jen čtení nebo čtení a zápis,
   • klikněte na Povolit přístup.
4. Asistent se vrátí do konverzace a nástroje Innovanetu jsou dostupné.

Připojené aplikace vidíte v profilu v seznamu Připojené aplikace (OAuth). Tam je můžete kdykoli odpojit. Přístup se obnovuje automaticky, dokud aplikaci neodpojíte nebo ji 30 dní nepoužijete.

Stejné přihlášení přes OAuth podporují i další klienti, například Claude Code, VS Code nebo Cursor – stačí jim zadat adresu serveru bez hlavičky Authorization.

Jak používat s AI? v portálu

V portálu klikněte vpravo nahoře na své jméno a vyberte Jak používat s AI?. Stránka má čtyři záložky:

• Návody – postup připojení, podporovaní klienti, adresa serveru a tipy, jak se ptát.
• Podle modulů – ukázkové otázky a nástroje pro každý aktivovaný modul. Tlačítko Vyzkoušet otevře nástroj v playgroundu s předvyplněnými parametry.
• Playground – vyzkoušení MCP serveru přímo v prohlížeči.
• FAQ – nejčastější otázky.

Playground

Playground spouští stejné nástroje jako AI asistent, ale bez tokenu – jako přihlášený uživatel portálu.

1. Vyberte metodu: tools/call, tools/list nebo initialize.
2. U tools/call zvolte nástroj a vyplňte parametry.
3. Zapisovací nástroje se spustí jen po zaškrtnutí Povolit zápis. Vytvoří skutečný záznam.
4. Klikněte na Spustit. Vpravo uvidíte požadavek JSON-RPC a odpověď serveru.
5. Pod formulářem je příkaz curl pro test s vlastním tokenem.

Volání z playgroundu se zapisují do logu aktivit.

Příklady podle modulů

Modul	Příklad dotazu
Profil a zaměstnanci	„Kdo je můj nadřízený?“ · „Komu v týmu vyprší školení BOZP do 60 dní?“
Adresář	„Najdi IČO a kontakty dodavatele ČEZ.“ · „Přidej k partnerovi poznámku z dnešního hovoru.“
Vydané faktury	„Které faktury jsou po splatnosti?“ · „Napiš upomínku k nejstarší neuhrazené faktuře.“
Přijaté faktury	„Které faktury od dodavatele XY čekají na schválení?“
Platby	„Které platby z října ještě nejsou spárované?“
Účtenky	„Které účtenky mi ještě neschválili?“ · „Zapiš účtenku za oběd 450 Kč ze včerejška.“
Úkoly	„Co mám dnes otevřené?“ · „Vytvoř úkol: zavolat klientovi do pátku.“
Projekty	„Které projekty jsou aktivní pro zákazníka ABC?“ · „Jaký je cashflow projektu Web 2027 do konce roku?“
Objednávky a smlouvy	„Které smlouvy nám končí do konce roku?“ · „Přidej k objednávce 125 poznámku o změně termínu.“
Servicedesk	„Nahlas, že nefunguje tiskárna ve 2. patře.“ · „Kolik tiketů je otevřených?“
Docházka	„Jaké mám saldo a kolik dní dovolené mi zbývá?“ · „Kdo je teď v práci?“
Majetek	„Který majetek mám přidělený?“ · „Požádej o nový notebook pro kolegu.“
Reporty	„Jaký byl obrat v září a kdo byli největší odběratelé?“ · „Porovnej příjmy a výdaje za poslední tři měsíce.“

Časté otázky

Může AI něco smazat? Ne. Nástroje na mazání neexistují. Token „jen čtení“ nemůže nic změnit.

Který klient vybrat? Na běžnou práci Claude Desktop nebo claude.ai a ChatGPT přes OAuth, pro vývojáře Claude Code, Cursor nebo VS Code s Copilotem. Všechny používají tentýž server a tytéž nástroje.

Které moduly asistent zná? Všechny uvedené výše: partnery, vydané i přijaté faktury, platby, účtenky, úkoly, projekty, objednávky, smlouvy, servicedesk, události, docházku, žádosti, organizaci, rezervace, služební cesty, pokladnu, poštu, majetek a reporty. Zatím nejsou dostupné e-learning, datové úložiště, stránky a novinky.

Jak zjistím, co asistent uvidí? V portálu otevřete Jak používat s AI? → Playground a spusťte tools/list nebo whoami.

Bezpečnost

• Token je jako heslo. Nikomu ho neposílejte a neukládejte ho do veřejných repozitářů.
• Asistent má stejná oprávnění jako vy. Nevidí nic, co nevidíte v portálu.
• Token s oprávněním jen čtení nemůže nic změnit ani vytvořit.
• Nástroje pro mazání a pro platby nejsou dostupné.
• Asistent má stejná omezení jako portál: oprávnění, viditelnost záznamů a u plateb a pokladny i oprávnění na modul.
• Záznamy docházky, nepřítomnosti a žádosti jsou přes asistenta jen vaše vlastní. Vedoucí a personalista vidí měsíční přehled kolegů a kdo je v práci, ale bez důvodů nepřítomnosti a poznámek. Důvod (např. nemoc) je údaj o zdraví a AI asistentovi ho neposíláme. Podrobnosti najdete v portálu.
• Z profilu zaměstnance asistent nikdy nedostane citlivé údaje (IBAN, mzda, rodné číslo, doklady, zdravotní pojišťovna, soukromý kontakt), ani když jste personalista.
• U kolegů (find_person) asistent dostane jen pracovní údaje: jméno, útvar, pozici, nadřízeného a pracovní kontakt.
• Každý vstup od asistenta se před zpracováním kontroluje: typy, délky, povolené hodnoty, neznámá pole se odmítnou a řídicí znaky se odstraní. Poté ho ověří i Innovanet stejnými pravidly jako formulář v portálu.
• Při chybě na serveru asistent dostane jen referenční kód (např. reference 1a2b3c4d), ne technické detaily. Podle kódu správce chybu dohledá.
• Každé volání nástroje se zapisuje do logu aktivit firmy (modul mcp).
• V profilu vidíte u každého tokenu, kdy a z jakého klienta byl naposledy použit a kolikrát.
• Token můžete kdykoli zrušit a aplikaci připojenou přes OAuth odpojit. Přístup skončí okamžitě.
• Při připojení přes OAuth Innovanet nikdy neposílá aplikaci vaše heslo. Aplikace dostane krátkodobý přístupový token (1 hodina), který se průběžně obnovuje.
• Na jeden token je limit 120 požadavků za minutu.
• Uživatelé s přístupem jen k docházce tokeny používat nemohou.

Údaje a AI poskytovatelé: Údaje, které si asistent v Innovanetu vyžádá, zpracovává poskytovatel vašeho AI asistenta (například Anthropic nebo OpenAI) podle vaší smlouvy s ním. Před připojením si ověřte, zda to odpovídá pravidlům vaší firmy.

Řešení problémů

Problém	Řešení
Klient hlásí 401	Token je neplatný, expirovaný nebo zrušený. Vytvořte nový.
Chybí nějaký nástroj	Modul není pro vaši firmu aktivován, nebo má token jen čtení (zapisovací nástroje se nezobrazí).
„This connection is read-only“	Pro zápis vytvořte token s oprávněním čtení a zápis, nebo aplikaci odpojte a připojte znovu s oprávněním čtení a zápis.
Konektor v ChatGPT / claude.ai se nepřihlásí	Zkontrolujte, že adresa končí na /mcp. Žádost o přihlášení platí 30 minut; pokud vypršela, spusťte připojení znovu.
Klient hlásí 429	Překročili jste limit požadavků. Počkejte minutu.
„You do not have permission for this module“	Na modul nemáte oprávnění v portálu (např. platby, pokladna, zápis událostí). Požádejte správce.
„Unknown argument“ nebo „invalid format“	Asistent poslal pole, které nástroj nezná, nebo hodnotu ve špatném tvaru. Většinou to opraví sám při dalším pokusu.
„The operation failed on the server (reference …)“	Chyba na serveru. Zkuste to později nebo v portálu. Při nahlášení pošlete správci referenční kód.