Přeskočit na obsah
patří do skupinyApertiaDraivix

01AI a integrace · modul

MCP pro externí AI agenty

Připojte Claude Code, Codex a další agenty k ERP s oprávněními konkrétního uživatele

K dispoziciDomluvit konzultaci
  • API klíč
  • Osobní přístupový token
  • MCP token
  • AI konverzace
13
schopností
4
druhů záznamů
3
automatizací
12
integrací a AI nástrojů

02Co modul umí

Méně rutiny. Víc hodnoty.

MCP (Model Context Protocol) umožní externím AI agentům, například Claude Code nebo Codexu, pracovat s daty v Draivixu. Agent dostane stejný katalog nástrojů jako vestavěný asistent a každé volání proběhne s oprávněními konkrétního uživatele a jeho API klíče. Vaše firma tak zapojí vlastní agenty bez obcházení oprávnění a auditu.

  • Agent ví, co smí volatExterní AI agent si stáhne katalog nástrojů s popisem jejich vstupů a výstupů. Vaši agenti tak pracují s daty podle popsaného rozhraní, ne podle odhadu.
  • 85 nástrojů na jedné adresePřes jeden koncový bod, tedy jednu adresu rozhraní, má agent k dispozici 85 povolených nástrojů vestavěného asistenta. Napojení vlastních agentů tak zůstává jednoduché.
  • Návrh změny má pojistkuZápisy přes most schopností ve výchozím nastavení vrátí návrh. Agent nebo člověk ho potvrdí nástrojem mutation_confirm, nebo zruší nástrojem mutation_cancel.
  • Klíč jen na vybrané nástrojeAPI klíč, kterým se agent přihlašuje, můžete zúžit na vyjmenované nástroje. Agent pak dostane jen to, co mu vaše firma povolí, a nic navíc.
  • Klíč natrvalo v čisté místnostiAPI klíč lze trvale připnout do režimu čisté místnosti, určeného pro citlivá data. Takový klíč vidí v katalogu jen nástroje pro tento režim.
  • Agent nepřekročí práva uživateleVýsledný přístup agenta je průnikem práv uživatele a stropu API klíče. Agent tak smí jen to, co dovoluje oboje, a klíč sám žádný záznam nezpřístupní.
  • Vlastní server pro vaše agentySamostatný MCP (Model Context Protocol) server newerp-agents-mcp nabízí 53 nástrojů nad REST API. Jeho zápisy se provedou okamžitě v rozsahu práv uživatele, bez návrhů ke schválení.
  • Přihlášení, jaké agent potřebujeAgent se přihlásí předaným tokenem, osobním přístupovým tokenem nebo podpisem výzvy klíčem SSH. Poslední možnost se hodí pro agenty v příkazové řádce.
  • Práce agenta dohledatelná u úkolu12 nástrojů propojí práci agenta s úkoly a commity, tedy uloženými změnami kódu, v GitLabu. U úkolu tak dohledáte, co agent udělal.
  • Chat a dokumenty na přáníServer lze doplnit o volitelné nástroje pro Mattermost a analýzu dokumentu přes Gemini, která potřebuje klíč k této službě. Zapojíte jen to, co opravdu využijete.
  • Každé volání zůstane v audituKaždé volání agenta se zapisuje do auditu se zdrojem mcp. Zpětně tedy poznáte, co udělal externí agent a co člověk přímo v aplikaci.
  • Strop 600 volání za minutuMost schopností, tedy rozhraní pro agenty přímo v Draivixu, je omezen na 600 volání za minutu. Zatížení od agentů tak zůstává v jasných mezích.
  • Předání konverzace službě HermesKonverzaci z asistenta lze předat agentní službě Hermes s krátkodobým pověřením na 300 sekund. Běží s právy uživatele, který konverzaci zahájil, a zapisuje se do auditu.

03Jak to funguje

Jak to funguje krok za krokem.

  1. Dvě cesty pro agenty

    První cestou je most schopností přímo v Draivixu. Agent si stáhne katalog nástrojů a volá je jedním koncovým bodem. Katalog obsahuje povolené nástroje vestavěného asistenta (85 z přibližně 100 registrovaných) a devět akcí: potvrzení a zrušení návrhu změny, úpravy položek hromadného návrhu, odeslání e-mailu a zavření zobrazené plochy. Katalog má verzi; když se nezměnil, server odpoví, že je aktuální, a agent ho nemusí stahovat znovu.

    Číst podrobněji

    Druhou cestou je samostatný MCP server newerp-agents-mcp, který obaluje obecné REST API pro programovací a provozní agenty. Nabízí 53 nástrojů: práci se záznamy a metadaty, vazby, přílohy, e-mail, úkoly, aktivity a reporty, globální vyhledávání, kalendář, 12 nástrojů pro propojení práce agenta s úkoly a commity v GitLabu a volitelně 7 nástrojů pro Mattermost. Nástroj pro analýzu dokumentu potřebuje klíč ke Gemini. Server běží přes stdio nebo HTTP a odpovědi zkracuje, aby se vešly do kontextu modelu.

  2. Oprávnění a API klíče

    Agent vždy jedná jako konkrétní uživatel. Oprávnění k mostu schopností klíč pouze vpustí na rozhraní, samo nedává přístup k žádnému záznamu. Výsledný přístup je průnikem práv uživatele a stropu API klíče. Klíč lze zúžit jen na vyjmenované nástroje a lze ho trvale připnout do režimu čisté místnosti; takový klíč vidí v katalogu jen nástroje pro tento režim.

    Číst podrobněji

    Server newerp-agents-mcp nemá vlastní oprávnění: každé volání nese token uživatele a prochází standardním REST API. Přihlásit se lze předaným bearer tokenem, osobním přístupovým tokenem, nebo podpisem výzvy SSH klíčem, což se hodí pro agenty v příkazové řádce.

    Most schopností je omezen na 600 volání za minutu. Každé volání proběhne v kontextu auditu se zdrojem mcp a identifikátorem pro dohledání. Příznak, zda nástroj mění data, se agentovi předává jako standardní nápověda MCP (jen pro čtení, nebo měnící).

  3. Kontrola změn

    Přes most schopností platí stejné pravidlo jako ve vestavěném asistentovi: nástroje pro založení, úpravu a smazání ve výchozím nastavení vrátí návrh. Agent nebo člověk ho potvrdí nástrojem mutation_confirm, nebo zruší nástrojem mutation_cancel. Potvrzení znovu spustí skutečnou operaci pod oprávněními uživatele.

    Číst podrobněji

    Server newerp-agents-mcp návrhy ani režim čisté místnosti nemá. Jeho zápisy se provedou okamžitě, vždy v rozsahu práv uživatele, jehož token agent používá. Pro agenty, u kterých chcete schvalovat každou změnu, proto použijte most schopností.

  4. Delegace na agentní službu Hermes

    Konverzaci ve vestavěném asistentovi lze předat agentní službě Hermes. Ta dostane krátkodobé pověření platné 300 sekund, vázané na firmu, a volá zpět přes most schopností. Volání běží s oprávněními uživatele, který konverzaci zahájil; režim čisté místnosti nejde rozšířit. Každé delegované volání se zapisuje do auditu jako bezpečnostně významné.

04Co běží samo

Automatizace, které šetří čas.

  1. Katalog se zbytečně neposílá

    Katalog nástrojů se drží v mezipaměti 15 minut pro firmu a verzi. Když se agent zeptá a katalog se nezměnil, server ho znovu neposílá a agent ho nemusí stahovat.

  2. Stopa po každém volání

    Při každém volání agenta vznikne automaticky zápis v auditu se zdrojem mcp a identifikátorem pro dohledání. Konkrétní zásah tak později najdete.

  3. Pověření samo vyprší

    Při předání konverzace dostane služba Hermes pověření vázané na firmu, které po 300 sekundách vyprší. Přístup tak zůstává krátkodobý.

Napojení ven

  • Claude Code v roli agentaClaude Code připojíte k Draivixu přes MCP (Model Context Protocol). Pracuje s daty s oprávněními konkrétního uživatele a jeho API klíče, bez obcházení oprávnění a auditu.
  • Codex pod stejnými pravidlyCodex se k Draivixu připojí přes MCP a dostane stejný katalog nástrojů jako vestavěný asistent. Každé volání proběhne s oprávněními konkrétního uživatele.
  • Hermes převezme konverzaciAgentní služba Hermes dostane předanou konverzaci z asistenta a volá zpět přes most schopností. Režim čisté místnosti nejde rozšířit a každé volání se zapisuje do auditu.
  • Analýza dokumentů přes GeminiServer newerp-agents-mcp nabízí nástroj pro analýzu dokumentu, který běží přes Gemini a potřebuje klíč k této službě. Agent tak pracuje i s obsahem dokumentů.
  • Práce agenta vedle commitůNástroje v newerp-agents-mcp propojí práci agenta s úkoly a commity v GitLabu. Práci agenta pak dohledáte přímo u příslušného úkolu.
  • Mattermost, když ho potřebujeteServer newerp-agents-mcp lze doplnit o 7 volitelných nástrojů pro Mattermost. Agent pak pracuje i s týmovým chatem, pokud to vaše firma chce.

Co zvládne AI agent

  • Data pro vaše agenty

    Externí agent umí číst, vyhledávat a počítat záznamy libovolné entity, tedy typu záznamu. Vidí přitom jen to, na co má uživatel a jeho API klíč právo.

  • Změna nejdřív jako návrh

    Přes most schopností agent ve výchozím nastavení jen navrhne změnu záznamu. Agent nebo člověk ji potvrdí a operace znovu proběhne pod oprávněními uživatele.

  • Hromadný návrh doladíte předem

    Položky hromadného návrhu lze před potvrzením upravit, takže kvůli jedné nesprávné položce nemusíte celý návrh zamítat.

  • E-mail odešle i agent

    Agent může odeslat e-mail jako jednu z akcí v katalogu nástrojů. Akce běží pod konkrétním uživatelem a zapisuje se do auditu, takže víte, kdo za ní stojí.

  • Přílohy a e-mail přes server

    Přes server newerp-agents-mcp agent pracuje s přílohami a e-mailem. Zápisy se provedou okamžitě v rozsahu práv uživatele; pro schvalování každé změny použijte most schopností.

  • Práce agenta u správného úkolu

    Agent propojí svou práci s úkoly a commity, tedy uloženými změnami kódu, v GitLabu. Při kontrole tak vidíte, ke kterému úkolu jeho změny patří.

Člověk schvaluje, kde jde o peníze, zákazníka nebo výjimku.

05Časté otázky

Mohu k Draivixu připojit Claude Code nebo jiného AI agenta?

Ano. Agent se připojí přes MCP, buď mostem schopností v Draivixu, nebo samostatným serverem newerp-agents-mcp, a pracuje s oprávněními uživatele, jehož klíč nebo token používá.

Může agent přes MCP obejít oprávnění?

Ne. Každé volání běží jako konkrétní uživatel a přístup je průnikem jeho práv a stropu API klíče. Klíč lze navíc zúžit na vybrané nástroje.

Zapisuje agent změny hned?

Přes most schopností vrací založení, úprava a smazání ve výchozím nastavení návrh, který se potvrdí zvlášť. Server newerp-agents-mcp zapisuje okamžitě, v rozsahu práv uživatele.

Dá se dohledat, co agent v systému dělal?

Ano. Každé volání přes most schopností se zapisuje do auditu se zdrojem mcp a identifikátorem pro dohledání, delegovaná volání služby Hermes se označují jako bezpečnostně významná.

06Souvisí s tím

Moduly, které dávají smysl společně.

Všechny moduly oblasti AI a integrace

Začneme spolu

Popište nám, jak funguje vaše firma.

My vám ukážeme, jak by mohl vypadat systém, který část této práce převezme.

Domluvit konzultaci