ERPIO Workspace Control

ERPIO Workspace Control – dokumentácia

Konektor ERPIO Workspace Control sprístupňuje administráciu workspace ERPIO One ako nástroje pre AI asistentov – Claude a ďalších klientov s podporou MCP. Asistent potom podľa vášho zadania založí data source so SQL nad Heliosom, postaví nad ním set, pridá akcie s parametrami a dlaždice na dashboard. Pracuje pod vaším ERPIO účtom a vo vašom workspace.

Adresa konektorahttps://mcp.erpio.one/mcp

Pre používateľa

Čo konektor dokáže

Asistent volá nástroje sám podľa toho, čo od neho chcete. Ich názvy poznať nemusíte, hodia sa však pri riešení problémov.

čítanie len číta, klient ho spustí bez pýtania  ·  zápis mení workspace alebo nastavenie účtu, klient sa môže pýtať

Dátové zdroje (data sources)

SQL dopyty nad databázou gateway. Synchronizácia načíta stĺpce z výsledku dopytu.

list_datasourcescreate_datasourceupdate_datasourcedelete_datasourcesync_datasource_schemacreate_converter

Stĺpce

Popisy, typy a vlastnosti stĺpcov data source: Key (jediný jednoznačný identifikátor riadku) a Hidden (systémová hodnota, napríklad ID z číselníka, ktorá nie je vidieť v prehľade ani v detaile, ale akcie ju použijú).

list_columnscreate_columnupdate_columnupdate_datasource_columnsdelete_column

Sety

Prehľady (gridy) nad data source, ktoré používatelia otvárajú v ERPIO, vrátane vlastností stĺpcov (Hideable, kompaktný pohľad, súčtový riadok Aggregate, spoločná hlavička, záložka detailu). Predvolené zoradenie setu (napr. Datum DESC) nastaví asistent pri založení alebo úprave setu.

list_setscreate_setupdate_setdelete_setupdate_set_columnslist_set_metaset_set_meta

Akcie

Navigácia medzi setmi, editačné akcie so SQL (INSERT, UPDATE, DELETE), parametre formulára vrátane rozloženia polí a vlastností z karty Extended (šírka poľa, dĺžka textu, záložka) a výber hodnoty zo setu, kontroly pred otvorením formulára (OnBeforeEditor), nadväzujúce akcie, predvolené hodnoty počítané SQL (gettery), navigácia na kartu záznamu, metadáta akcií (plávajúce tlačidlo, export do Excelu, pripravené filtre zoznamu…) a vlastný vzhľad detailu a zoznamu (HTML pre webovú, XAML pre mobilnú ERPIO App, alias akcie). Mazanie stráži, aby nerozbilo iné akcie ani dlaždice. Poradie polí vo formulári sa dá zmeniť bez nového založenia akcie (predvolené hodnoty aj výbery zostanú). Špeciálne akcie: navigácia na adresu v mape (LocationOnMap s parametrami @BName a @BData), otvorenie alebo zdieľanie súboru či PDF, odoslanie e-mailu (@to, @subject, @body); asistent povie, ktoré parametre akcia potrebuje, a spýta sa, z ktorých stĺpcov ich vziať. Akcie zavolať, SMS a e-mail majú v poli akcie len číslo alebo adresu (alebo @Parameter), bez tel: či mailto:. Timeout akcie je v sekundách.

list_actionscreate_actioncreate_update_actionupdate_actionadd_action_paramsreorder_action_paramsbind_param_pickerbind_param_getterset_action_commandscreate_notification_actionlist_action_metalist_filtersset_filtersset_action_metadelete_action

Automatizácie a rozvrhy

Akcie, ktoré server spúšťa sám: kroky automatizácie (napríklad SQL akcie alebo rozoslanie notifikácií) a kedy bežia – každý deň v danú hodinu, alebo podľa rozvrhu (každých N minút v časovom okne). Rozvrh nejde zmazať, kým sú naň napojené automatizácie.

list_schedulesset_automationcreate_scheduledelete_schedule

Globálne parametre

Hodnota uložená pri používateľovi (zdieľaná medzi jeho zariadeniami), napríklad vybrané stredisko alebo záznam pre kartu záznamu. Definícia parametra, prehľad, ktoré akcie ho zapisujú a ktoré zdroje a akcie ho čítajú, a upozornenie na chýbajúcu definíciu alebo preklep v názve.

list_global_paramscreate_global_paramupdate_global_paramdelete_global_param

Dashboardy a dlaždice

Dashboardy a ich dlaždice napojené na sety, vrátane poradia a obrázka dlaždice (galéria workspace, nahratie nového) a kategórie dashboardu aj dlaždice (kto ich v aplikácii vidí). Kategórie asistent založí, nastaví k nim práva používateľov (čítanie, zápis, zákaz) a vie ich skopírovať z iného workspace (napríklad z produkcie do DEV). Zmazať alebo premenovať kategóriu sa dá len v administrácii ERPIO.

list_dashboardscreate_dashboardupdate_dashboarddelete_dashboardlist_dashboard_itemscreate_dashboard_itemupdate_dashboard_itemdelete_dashboard_itemlist_imagesupload_imagelist_categoriescreate_categoryset_category_permissionscopy_categories

Helios (len čítanie)

Prieskum tabuliek, stĺpcov, cudzích kľúčov, obmedzení a triggerov (jedným volaním) a dopyty SELECT cez gateway workspace, najviac 250 riadkov. Dopyty na dáta povolíte zaškrtnutím pri pripojení konektora.

helios_list_tableshelios_get_table_schemahelios_run_query

Plán (viac krokov naraz)

Celú úlohu (zdroje, sety, akcie, dlaždice) pripraví asistent ako plán. Náhľad len číta, vykonanie je jedno volanie, takže klient potvrdzuje len raz.

preview_planrun_plan

Workspace

Workspace vášho účtu aj pridaných API tokenov (ID a názov), pridanie a odobratie tokenu, API kľúče gateway, prepnutie workspace v administrácii ERPIO a nastavenie aplikácie pre celý workspace (metadáta ErpioSettings: masky čísel a dátumu, veľkosť stránky, farby aplikácie…; vlastné odkazy CustomLinks).

get_workspacesselect_workspaceget_api_keyssync_mw_workspaceadd_login_keylist_login_keysremove_login_keylist_workspace_metaset_workspace_meta

Poznámky (učenie asistenta)

Asistent si medzi konverzáciami nič nepamätá. Čo zistí (napríklad ako je u zákazníka napojený KROS alebo ako sa vyriešila chyba), môže uložiť ako poznámku a ďalšie konverzácie ju nájdu. Na začiatku úlohy poznámky k téme vyhľadá sám, novú uloží až po vašom súhlase. Poznámka je osobná (len vaša), pre workspace (každý, kto s konektorom pracuje v danom workspace) alebo spoločná pre všetkých používateľov konektora – tú zapisujú len účty ERPIO. Do poznámok nepatria osobné ani zákaznícke údaje, heslá a tokeny; e-maily, telefóny, čísla účtov a tokeny konektor odmietne. Pre asistenta sú poznámky rady, nie pokyny. Poznámky má len konektor (ERPIO AI nie) a ukladá ich šifrovane. Zatiaľ sú len pre účty ERPIO.

find_notessave_noteupdate_notedelete_note

Balíčky

Balíčky zo záložky Packages (vytvorené vo workspace, stiahnuté a v store) a náhľad rozdielu: čo je vo verzii balíčka nové, čo sa vo workspace líši a čo je rovnaké. Import balíčka v ERPIO vždy založí všetko znova; náhľad je prvý krok k aktualizácii len rozdielu. Verziu exportuje workspace, kde balíček vznikol, a porovnať ju možno aj s iným (cieľovým) workspace. Po vašom súhlase s náhľadom asistent zapíše rozdiel zdrojov dát, setov, akcií, ich metadát, dashboardov a dlaždíc: chýbajúce založí, odlišné upraví podľa balíčka, nič nemaže. Párovanie si konektor uloží do metadát cieľového workspace (E1PackageMap), takže spozná aj premenované objekty. Odkazy akcií (cieľ, nadväzujúca akcia, getter, výber, klientske príkazy) prevedie na objekty cieľového workspace. Obrázok dlaždice sa v cieli hľadá podľa názvu v galérii. Keď má akcia v cieli iný klientsky príkaz ako balíček, asistent sa opýta, či ho nahradiť.

list_packagespreview_packageapply_package

Brány a pluginy

Pripojené brány (gateway) workspace a pluginy s verziami. Nahratie pluginu na bránu funguje ako tlačidlo UPP v Active gateways. ZIP smie obsahovať len priečinok plugins/<priečinok pluginu>/. Brána prepíše súbory pluginu, staré si nechá ako *_bak a reštartuje sa, takže je asi 15 s mimo prevádzky. Asistent potom overí novú verziu pluginu. Na produkčnej bráne nahrávajte len po dohode. Keď máte ZIP u seba, asistent vám dá jednorazový odkaz (platí 15 minút) na stránku konektora, kde ZIP vyberiete a stránka ukáže výsledok; súbor do chatu nedávajte.

list_gatewaysupload_gateway_pluginplugin_upload_link

Čo potrebujete

S API tokenom konektor nepotrebuje vaše heslo do ERPIO a prístup zrušíte aj zmazaním tokenu. Token chráňte ako heslo a nevkladajte ho do konverzácie s AI.

Claude (claude.ai, desktop, mobil)

Pridanie konektora (raz za organizáciu)

  1. Owner organizácie otvorí Admin settings → Connectors a zvolí Add custom connector. Na individuálnom účte je to Settings → Connectors → Add custom connector.
  2. Názov ERPIO Workspace Control, URL https://mcp.erpio.one/mcp. Rozšírené nastavenie OAuth (Client ID, Client Secret) nechajte prázdne, Claude sa zaregistruje sám.
  3. Uložte tlačidlom Add.

Pripojenie používateľa

  1. V Claude otvorte Settings → Connectors a pri ERPIO Workspace Control kliknite na Connect.
  2. Otvorí sa prihlasovacia stránka konektora (v češtine). Vyplňte Název společnosti (názov spoločnosti, podľa neho pripojenie spoznáte v konverzácii), vložte API token a potvrďte Přihlásit a povolit. Stránka má rovnaké polia ako stránka na pridanie ďalšieho tokenu. Pod voľbou Přihlásit e-mailem a heslem môžete namiesto toho zadať e-mail, heslo a ID workspace.
  3. Konektor overí token (alebo heslo), členstvo vo workspace a administrátorské práva a vráti vás do Claude.
  4. V konverzácii zapnite konektor v ponuke nástrojov. Asistent vám na začiatku povie, v ktorom workspace pracuje. Keď má účet viac workspace, ukáže vám ich (ID a názov) a opýta sa, do ktorého má zapisovať. Voľba platí, kým ju nezmeníte („prepni na workspace 8097“).

Adresa https://mcp.erpio.one/mcp slúži aplikáciám. V prehliadači vráti invalid_token a Authentication required, to je v poriadku.

Viac workspace naraz

Jeden konektor https://mcp.erpio.one/mcp stačí na všetky workspace. Na začiatku konverzácie asistentovi povedzte, s ktorými workspace pracujete; každé volanie potom nesie ID workspace, takže v inej konverzácii môžete súčasne pracovať s inými workspace. API token platí len pre workspace, pre ktorý bol vygenerovaný; ostatné workspace toho istého účtu povolíte zaškrtnutím „Povolit i ostatní workspace účtu“ (pri pripojení konektora aj pri pridanom tokene, predvolene nezaškrtnuté). Ďalší workspace pridáte ďalším API tokenom: povedzte asistentovi „pridaj API token“ a dostanete jednorazový odkaz (platí 10 minút) na stránku konektora, kde vyplníte názov spoločnosti a vložíte token. Token nikdy nevkladajte do chatu. Pridaný token platí vo všetkých konverzáciách, kým ho neodoberiete alebo kým nevyprší v ERPIO. Odobratie: „aké mám tokeny“ vypíše pridané tokeny s názvami (list_login_keys), „odober token <názov>“ odoberie token aj jeho workspace (remove_login_key). Workspace prihlásenia konektora odoberiete len odpojením konektora v Claude. Staršia varianta s ID workspace v adrese (https://mcp.erpio.one/<ID workspace>/mcp) ďalej funguje, ale nie je potrebná.

Gemini

Gemini sa pýta „Povoliť“ pri každom zápise a konektor má aktívny len v správe, kde ho spomeniete cez @ERPIO Workspace control. Väčšiu úlohu preto zadajte jednou správou so zmienkou konektora. Asistent pripraví plán (preview_plan, bez pýtania), ukáže vám ho a vykoná ho jedným volaním run_plan, takže potvrdzujete len raz. Potvrdzujte tlačidlom Povoliť v dialógu, nie napísanou správou „Allow“. Keď pokračujete ďalšou správou, začnite ju @ERPIO Workspace control.

Claude Code

claude mcp add --transport http erpio-workspace https://mcp.erpio.one/mcp

Potom v Claude Code spustite /mcp, vyberte erpio-workspace a prihláste sa v prehliadači rovnako ako vyššie.

ERPIO AI (Open WebUI)

V ERPIO AI (brain.erpio.one) máte rovnaké nástroje ako nástroj ERPIO Admin. Pridelí vám ho administrátor ERPIO AI. Potom si v chate pri nástroji vyplníte vlastné nastavenie (UserValves):

NastavenieHodnota
ERPIO_API_TOKENAPI token (odporúčané). Workspace sa vezme z tokenu, e-mail a heslo sa nevypĺňajú.
ERPIO_API_TOKENSĎalšie API tokeny (ďalšie workspace, aj iných účtov): popisok=token, viac oddeľte bodkočiarkou. Asistent ponúkne workspace všetkých tokenov; token odoberiete zmazaním z poľa.
ERPIO_ADMIN_USER, ERPIO_ADMIN_PASSe-mail a heslo do ERPIO, len keď nepoužívate token
ERPIO_ID_CUSTOMERID workspace; pri tokene nepovinné (vyplnené musí zodpovedať tokenu), pri e-maile a hesle povinné bez ERPIO_ALL_WORKSPACES
ERPIO_ALL_WORKSPACESPovoliť aj ostatné workspace účtu. Vypnuté (predvolené) = každý API token len workspace, pre ktorý bol vygenerovaný, e-mail a heslo len ERPIO_ID_CUSTOMER; zapnuté = všetky workspace účtu s administrátorskými právami.
ERPIO_HELIOS_GATEWAYnepovinné: názov alebo API kľúč gateway pre SQL na Helios (prázdne = jediná aktívna gateway workspace)
ERPIO_HELIOS_DATAzapnuté = asistent smie čítať dáta z databázy workspace (Helios alebo iná; dopyty SELECT, helios_run_query); predvolene vypnuté, asistent potom vidí len štruktúru tabuliek. Administrátor workspace môže rozhodnúť za všetkých (Workspace metadata, MCPConfig).

ERPIO AI pracuje vo workspace z ERPIO_ID_CUSTOMER, alebo vo workspace, ktorý si vyberiete v konverzácii (len z povolených, pozri ERPIO_ALL_WORKSPACES; asistent vám ukáže ID a názvy a zavolá select_workspace; platí do reštartu ERPIO AI, trvalo ho nastavíte v ERPIO_ID_CUSTOMER). Bez nastavenia sa jediný dostupný workspace vyberie sám a „Workspace“ sa neponúka. Zápis do iného workspace len pre jedno volanie vždy potvrdzujete v dialógu.

Iní MCP klienti

Konektor funguje s každým klientom, ktorý podporuje:

Klienti, ktorí vedia len pevný API kľúč v hlavičke, sa pripojiť nemôžu.

Nástroje majú MCP anotácie: čítacie sú označené readOnlyHint, takže ich klienti ako Claude alebo Gemini spúšťajú bez pýtania. Zakladanie je nedeštruktívny zápis, úpravy a mazanie existujúcich objektov sú označené ako deštruktívne (destructiveHint) a klient sa pred nimi opýta. Po aktualizácii konektora ho v klientovi pripojte znova, aby načítal nové definície nástrojov.

Príklady zadaní

Pred SQL nad Heliosom si asistent najprv prejde štruktúru tabuliek. Výsledok vždy skontrolujte v ERPIO.

Prihlásenie a bezpečnosť

Zápisy idú priamo do ERPIO a nedajú sa vrátiť. Nové veci skúšajte najprv v testovacom workspace a pri nástrojoch, ktoré zapisujú, nechajte v Claude zapnuté schvaľovanie. Pred zmazaním setu alebo data source si nechajte vypísať, čo od nich závisí.

Riešenie problémov

Hlásenia prihlasovacej stránky sú v češtine, chyby nástrojov bez diakritiky.

„Neplatný API token (zrušený, vypršel nebo neúplný).“
Vložte token celý, bez medzier. Ak bol zmazaný alebo mu vypršala platnosť, vygenerujte v ERPIO nový.
„API token patří k workspace …“
Token je z iného workspace, než ste zadali (v ERPIO AI v ERPIO_ID_CUSTOMER). Použite token z toho workspace, alebo opravte ID.
„Nesprávný e-mail nebo heslo do ERPIO.“
Použite rovnaké údaje ako do administrácie ERPIO.
„Účet nemá přístup do workspace …“
Účet nie je členom workspace s týmto ID. Skontrolujte číslo v hlavičke administrácie ERPIO.
„Účet nemá administrátorská práva ve workspace …“
Konektor potrebuje administrátorské práva. Požiadajte o ne správcu workspace.
„Příliš mnoho neúspěšných pokusů.“
Počkajte 15 minút a prihláste sa znova.
„Přihlášení vypršelo nebo je neplatné.“
Prihlasovacia stránka platí 15 minút. V Claude kliknite na Connect znova.
Ulozene prihlaseni do ERPIO uz neplati
API token bol zrušený alebo vypršal, alebo sa v ERPIO zmenilo heslo. Konektor v Claude odpojte a pripojte znova s novým tokenom alebo heslom.
Prihlaseni ke konektoru uz neplati
Konektor v Claude odpojte a pripojte znova.
MW session uctu je ve workspace …
Session ERPIO bola v inom workspace. Konektor si ho pri ďalšom volaní nastaví sám, operáciu zopakujte; prípadne povedzte asistentovi „zavolaj sync_mw_workspace“. Pozri Workspace a MW session.
Nelze vybrat gateway pro SQL
Workspace má viac aktívnych gateway (alebo žiadnu) a nie je jasné, ktorú použiť. V ERPIO AI vyplňte ERPIO_HELIOS_GATEWAY, pri konektore v Claude sa obráťte na správcu konektora.
SQL chyba: …
Chyba v dopyte, napríklad neexistujúci stĺpec. Asistent ju vidí a dopyt opraví.
Set nie je vidieť v prehľade setov alebo nenačítava dáta
Data source alebo set nemá API kľúč gateway. Povedzte asistentovi, nech kľúče skontroluje a doplní.
V prehliadači na adrese konektora vidím invalid_token
To je v poriadku. Adresa slúži aplikáciám, nie prehliadaču.
Plugin sa na bránu nenahral, brána sa nereštartovala
Brána si ZIP sťahuje sama a vie len TLS 1.0, ktoré má novší Windows vypnuté. Na počítači brány nastavte v registri SchUseStrongCrypto a SystemDefaultTlsVersions na 1 (kľúč HKLM\SOFTWARE\Microsoft\.NETFramework\v4.0.30319 aj rovnaký pod WOW6432Node), reštartujte len službu tejto brány a nahrajte plugin znova. Záznam CANCELED#timeout1 v EventLogu brány sa objaví aj pri úspešnom nahratí, to nie je chyba.

Pre správcov a implementátorov

Workspace a MW session

Konektor pracuje vo workspace, ktorý asistent uvedie v parametri workspace každého volania. Výber platí pre konverzáciu; server konverzácie nerozlišuje, preto si ho nepamätá. Ak má pripojenie len jeden dostupný workspace, použije sa sám; pri viacerých workspace nástroj bez parametra nič neurobí a vráti zoznam. Dostupné sú workspace prihlásenia a všetkých pridaných tokenov (add_login_key), každý cez svoj token a vlastnú session ERPIO. Každé prihlásenie smie len do svojho workspace (API token do workspace, pre ktorý bol vygenerovaný, heslo do zadaného workspace); so zaškrtnutím „Povolit i ostatní workspace účtu“ do všetkých workspace účtu. Je to pravidlo konektora, ERPIO samo token na workspace neobmedzuje. Workspace pomenované „Workspace“ sa neponúkajú, len tie, kde máte administrátorské práva.

Väčšina nástrojov volá REST API ERPIO s ID workspace. Editory administrácie (akcie, sety, dlaždice), synchronizácia stĺpcov a SQL na Helios však bežia vo workspace, ktorý máte vybraný vo svojom účte ERPIO (číslo v hlavičke administrácie). Keď sa líši, konektor operáciu odmietne skôr, než by sa čokoľvek uložilo inam:

MW session uctu je ve workspace 1234, nastroj pracuje ve workspace 5678 - ...
Zavolej sync_mw_workspace() (prepne vybrany workspace uctu) a zkus to znovu.

Konektor (Claude, Gemini) aj ERPIO AI si workspace v ERPIO session nastavujú samy pri každom prihlásení do ERPIO, takže v administrácii v prehliadači môžete mať otvorený iný workspace. ERPIO však voľbu ukladá k účtu: pri ďalšom prihlásení do administrácie sa vám otvorí workspace, ktorý naposledy použil konektor. Ak by hlásenie predsa prišlo, operáciu zopakujte, prípadne povedzte asistentovi „zavolaj sync_mw_workspace“.

Čo nástroje strážia samy

Nástroje dodržiavajú konvencie ERPIO, aby výsledok fungoval rovnako, ako keby ho niekto naklikal v administrácii:

Rozdiel oproti ERPIO One MCP

ERPIO Workspace ControlERPIO One MCP
Adresahttps://mcp.erpio.oneclientmcp.erpio.one
Na čoadministrácia workspace: data sources, sety, akcie, dashboardy, dopyty do Heliosuvybrané metódy klientského API (napr. zákazky, aktivity)
PrihlásenieAPI token používateľa, alebo e-mail, heslo a ID workspace do ERPIOkľúč e1key
Pre kohoimplementátori a správcovia ERPIOpoužívatelia ERPIO One

Prevádzka