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ástroj	Co dělá	Modul	Oprávnění
`whoami`	Kdo jste, vaše firma a dostupné moduly	–	čtení
`search_partners`	Vyhledá partnery podle názvu, IČO nebo DIČ	Adresář	čtení
`get_partner`	Detail partnera: adresy, kontakty, účty, poznámky	Adresář	čtení
`list_outgoing_invoices`	Seznam vydaných faktur (text, stav, rok, odběratel)	Vydané faktury	čtení
`get_outgoing_invoice`	Detail faktury včetně položek a úhrad	Vydané faktury	čtení
`list_bills`	Seznam účtenek (stav, typ, období)	Účtenky	čtení
`get_bill`	Detail účtenky s rozpisem DPH a historií	Účtenky	čtení
`create_bill`	Zapíše novou účtenku (čeká na schválení)	Účtenky	zápis
`list_todos`	Vaše úkoly nebo úkoly týmu	Úkoly	čtení
`create_todo`	Vytvoří úkol	Úkoly	zápis
`list_projects`	Seznam projektů	Projekty	čtení

Příklady dotazů pro asistenta:

„Které faktury pro firmu ABC jsou po splatnosti?“
„Najdi IČO a kontakty dodavatele ČEZ.“
„Zapiš účtenku za oběd 450 Kč ze včerejška.“
„Vytvoř mi úkol: zavolat klientovi do pátku.“

Vytvoření tokenu¶

Otevřete Profil (vlastní profil) a v části AI asistenti (MCP) klikněte na Nový token.
Zadejte název, například „Claude na notebooku“, abyste token později poznali.
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.
Nastavte platnost (výchozí 90 dní, nejvýše 365).
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) – webové konektory vyžadují přihlášení přes OAuth. Tuto možnost připravujeme. Do té doby použijte některého z klientů výše.

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í nejsou dostupné.
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. Přístup skončí okamžitě.
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 token is read-only“	Pro zápis vytvořte token s oprávněním čtení a zápis.
Klient hlásí 429	Překročili jste limit požadavků. Počkejte minutu.