ERPIO Workspace Control – dokumentace

Konektor ERPIO Workspace Control zpřístupňuje administraci workspace ERPIO One jako nástroje pro AI asistenty – Claude a další klienty s podporou MCP. Asistent pak podle vašeho zadání založí data source se SQL nad Heliosem, postaví nad ním set, přidá akce s parametry a dlaždice na dashboard. Pracuje pod vaším ERPIO účtem a ve vašem workspace.

Adresa konektoruhttps://mcp.erpio.one/mcp

Pro uživatele

Co konektor umí

Asistent volá nástroje sám podle toho, co po něm chcete. Jejich názvy znát nemusíte, hodí se ale při řešení problémů.

čtení jen čte, klient ho spustí bez ptaní · zápis mění workspace nebo nastavení účtu, klient se může ptát

Datové zdroje (data sources)

SQL dotazy nad databází gateway. Synchronizace načte sloupce z výsledku dotazu.

list_datasourcescreate_datasourceupdate_datasourcedelete_datasourcesync_datasource_schemacreate_converter

Sloupce

Popisky, typy a vlastnosti sloupců data source: Key (jediný jednoznačný identifikátor řádku) a Hidden (systémová hodnota, třeba ID z číselníku, která není vidět v přehledu ani v detailu, ale akce ji použijí).

list_columnscreate_columnupdate_columnupdate_datasource_columnsdelete_column

Sety

Přehledy (gridy) nad data source, které uživatelé otevírají v ERPIO, včetně vlastností sloupců (Hideable, kompaktní pohled, součtový řádek Aggregate, společná hlavička, záložka detailu). Výchozí řazení setu (třeba Datum DESC) nastaví asistent při založení nebo úpravě setu.

list_setscreate_setupdate_setdelete_setupdate_set_columnslist_set_metaset_set_meta

Akce

Navigace mezi sety, editační akce se SQL (INSERT, UPDATE, DELETE), parametry formuláře včetně rozvržení polí a vlastností z karty Extended (šířka pole, délka textu, záložka) a výběr hodnoty ze setu, kontroly před otevřením formuláře (OnBeforeEditor), navazující akce, výchozí hodnoty počítané SQL (gettery), navigace na kartu záznamu, metadata akcí (plovoucí tlačítko, export do Excelu, připravené filtry seznamu…) a vlastní vzhled detailu a seznamu (HTML pro webovou, XAML pro mobilní ERPIO App, alias akce). Mazání hlídá, aby nerozbilo jiné akce ani dlaždice. Pořadí polí ve formuláři jde změnit bez nového založení akce (výchozí hodnoty i výběry zůstanou). Zvláštní akce: navigace na adresu v mapě (LocationOnMap s parametry @BName a @BData), otevření nebo sdílení souboru či PDF, odeslání e-mailu (@to, @subject, @body); asistent řekne, které parametry akce potřebuje, a zeptá se, ze kterých sloupců je vzít. Akce zavolat, SMS a e-mail mají v poli akce jen číslo nebo adresu (nebo @Parametr), bez tel: či mailto:. Timeout akce 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

Automatizace a rozvrhy

Akce, které server spouští sám: kroky automatizace (třeba SQL akce nebo rozeslání notifikací) a kdy běží – každý den v danou hodinu, nebo podle rozvrhu (každých N minut v časovém okně). Rozvrh nejde smazat, dokud jsou na něm napojené automatizace.

list_schedulesset_automationcreate_scheduledelete_schedule

Globální parametry

Hodnota uložená u uživatele (sdílená mezi jeho zařízeními), třeba vybrané středisko nebo záznam pro kartu záznamu. Definice parametru, přehled, které akce ho zapisují a které zdroje a akce ho čtou, a upozornění na chybějící definici nebo překlep v názvu.

list_global_paramscreate_global_paramupdate_global_paramdelete_global_param

Dashboardy a dlaždice

Dashboardy a jejich dlaždice napojené na sety, včetně pořadí a obrázku dlaždice (galerie workspace, nahrání nového) a kategorie dashboardu i dlaždice (kdo je v aplikaci vidí). Kategorie asistent založí, nastaví k nim práva uživatelů (čtení, zápis, zákaz) a umí je zkopírovat z jiného workspace (třeba z produkce do DEV). Smazat nebo přejmenovat kategorii jde jen v administraci ERPIO.

list_dashboardscreate_dashboardupdate_dashboarddelete_dashboardlist_dashboard_itemscreate_dashboard_itemupdate_dashboard_itemdelete_dashboard_itemlist_imagesupload_imagelist_categoriescreate_categoryset_category_permissionscopy_categories

Helios (jen čtení)

Průzkum tabulek, sloupců, cizích klíčů, omezení a triggerů (jedním voláním) a dotazy SELECT přes gateway workspace, nejvýš 250 řádků. Dotazy na data povolíte zaškrtnutím při připojení konektoru.

helios_list_tableshelios_get_table_schemahelios_run_query

Plán (víc kroků najednou)

Celý úkol (zdroje, sety, akce, dlaždice) připraví asistent jako plán. Náhled jen čte, provedení je jedno volání, takže klient potvrzuje jen jednou.

preview_planrun_plan

Workspace

Workspace vašeho účtu i přidaných API tokenů (ID a název), přidání a odebrání tokenu, API klíče gateway, přepnutí workspace v administraci ERPIO a nastavení aplikace pro celý workspace (metadata ErpioSettings: masky čísel a data, velikost stránky, barvy aplikace…; vlastní odkazy CustomLinks).

get_workspacesselect_workspaceget_api_keyssync_mw_workspaceadd_login_keylist_login_keysremove_login_keylist_workspace_metaset_workspace_meta

Poznámky (učení asistenta)

Asistent si mezi konverzacemi nic nepamatuje. Co zjistí (třeba jak je u zákazníka napojený KROS nebo jak se vyřešila chyba), může uložit jako poznámku a další konverzace ji najdou. Na začátku úkolu poznámky k tématu vyhledá sám, novou uloží až po vašem souhlasu. Poznámka je osobní (jen vaše), pro workspace (každý, kdo s konektorem pracuje v daném workspace) nebo společná pro všechny uživatele konektoru – tu zapisují jen účty ERPIO. Do poznámek nepatří osobní ani zákaznické údaje, hesla a tokeny; e-maily, telefony, čísla účtů a tokeny konektor odmítne. Pro asistenta jsou poznámky rady, ne pokyny. Poznámky má jen konektor (ERPIO AI ne) a ukládá je šifrovaně. Zatím jsou jen pro účty ERPIO.

find_notessave_noteupdate_notedelete_note

Balíčky

Balíčky ze záložky Packages (vytvořené ve workspace, stažené a ve store) a náhled rozdílu: co je ve verzi balíčku nové, co se ve workspace liší a co je stejné. Import balíčku v ERPIO vždy založí všechno znovu; náhled je první krok k aktualizaci jen rozdílu. Verzi exportuje workspace, kde balíček vznikl, a porovnat ji jde i s jiným (cílovým) workspace. Po vašem souhlasu s náhledem asistent zapíše rozdíl zdrojů dat, setů, akcí, jejich metadat, dashboardů a dlaždic: chybějící založí, odlišné upraví podle balíčku, nic nemaže. Párování si konektor uloží do metadat cílového workspace (E1PackageMap), takže pozná i přejmenované objekty. Odkazy akcí (cíl, navazující akce, getter, výběr, klientské příkazy) převede na objekty cílového workspace. Obrázek dlaždice se v cíli hledá podle názvu v galerii. Když má akce v cíli jiný klientský příkaz než balíček, asistent se zeptá, zda ho nahradit.

list_packagespreview_packageapply_package

Brány a pluginy

Připojené brány (gateway) workspace a pluginy s verzemi. Nahrání pluginu na bránu funguje jako tlačítko UPP v Active gateways. ZIP smí obsahovat jen složku plugins/<složka pluginu>/. Brána přepíše soubory pluginu, staré si nechá jako *_bak a restartuje se, takže je asi 15 s mimo provoz. Asistent potom ověří novou verzi pluginu. Na produkční bráně nahrávejte jen po dohodě. Když máte ZIP u sebe, asistent vám dá jednorázový odkaz (platí 15 minut) na stránku konektoru, kde ZIP vyberete a stránka ukáže výsledek; soubor do chatu nedávejte.

list_gatewaysupload_gateway_pluginplugin_upload_link

Co potřebujete

API token vašeho uživatele z administrace ERPIO (Oprávnění → uživatel → API Token access). Token patří k jednomu uživateli a workspace a konektor podle něj pozná obojí. Při generování se volí jeho platnost ve dnech.
Ve workspace musíte mít administrátorská práva.
Místo tokenu můžete zadat e-mail a heslo do administrace ERPIO a ID workspace – číslo v hlavičce administrace vedle ikony věže (např. 1234).
Claude (claude.ai, aplikace pro desktop a mobil, Claude Code) nebo jiný klient s podporou MCP a OAuth. V organizaci Claude musí konektor nejdřív přidat Owner.

S API tokenem konektor nepotřebuje vaše heslo do ERPIO a přístup zrušíte i smazáním tokenu. Token chraňte jako heslo a nevkládejte ho do konverzace s AI.

Claude (claude.ai, desktop, mobil)

Přidání konektoru (jednou za organizaci)

Owner organizace otevře Admin settings → Connectors a zvolí Add custom connector. Na individuálním účtu je to Settings → Connectors → Add custom connector.
Název ERPIO Workspace Control, URL https://mcp.erpio.one/mcp. Rozšířené nastavení OAuth (Client ID, Client Secret) nechte prázdné, Claude se zaregistruje sám.
Uložte tlačítkem Add.

Připojení uživatele

V Claude otevřete Settings → Connectors a u ERPIO Workspace Control klikněte na Connect.
Otevře se přihlašovací stránka konektoru. Vyplňte Název společnosti (podle něj připojení poznáte v konverzaci), vložte API token a potvrďte Přihlásit a povolit. Stránka má stejná pole jako stránka pro přidání dalšího tokenu. Pod volbou Přihlásit e-mailem a heslem můžete místo toho zadat e-mail, heslo a ID workspace.
Konektor ověří token (nebo heslo), členství ve workspace a administrátorská práva a vrátí vás do Claude.
V konverzaci zapněte konektor v nabídce nástrojů. Asistent vám na začátku řekne, ve kterém workspace pracuje. Když má účet víc workspace, ukáže vám je (ID a název) a zeptá se, do kterého má zapisovat. Volba platí, dokud ji nezměníte („přepni na workspace 8097“).

Adresa https://mcp.erpio.one/mcp slouží aplikacím. V prohlížeči vrátí invalid_token a Authentication required, to je v pořádku.

Víc workspace najednou

Jeden konektor https://mcp.erpio.one/mcp stačí na všechny workspace. Na začátku konverzace asistentovi řekněte, se kterými workspace pracujete; každé volání pak nese ID workspace, takže v jiné konverzaci můžete současně pracovat s jinými workspace. API token platí jen pro workspace, pro který byl vygenerovaný; ostatní workspace stejného účtu povolíte zaškrtnutím „Povolit i ostatní workspace účtu“ (při připojení konektoru i u přidaného tokenu, výchozí je nezaškrtnuto). Další workspace přidáte dalším API tokenem: řekněte asistentovi „přidej API token“ a dostanete jednorázový odkaz (platí 10 minut) na stránku konektoru, kde vyplníte název společnosti a vložíte token. Token nikdy nevkládejte do chatu. Přidaný token platí ve všech konverzacích, dokud ho neodeberete nebo nevyprší v ERPIO. Odebrání: „jaké mám tokeny“ vypíše přidané tokeny s názvy (list_login_keys), „odeber token <název>“ odebere token i jeho workspace (remove_login_key). Workspace přihlášení konektoru odeberete jen odpojením konektoru v Claude. Starší varianta s ID workspace v adrese (https://mcp.erpio.one/<ID workspace>/mcp) dál funguje, ale není potřeba.

Takový konektor pracuje jen v tomto workspace. Přihlašovací stránka ho ukáže a ověří, že v něm máte administrátorská práva. Přepnout na jiný workspace v konverzaci nejde.
API token jiného workspace vašeho účtu konektor přijme jen se zaškrtnutím „Povolit i ostatní workspace účtu“; bez něj musí být token vygenerovaný pro workspace z adresy. Přihlášení i souhlas se čtením dat z databáze má každý konektor svůj.
V konverzaci zapněte jen konektor workspace, ve kterém chcete pracovat, ať asistent nezapisuje jinam, než čekáte.

Gemini

Gemini se ptá „Povolit“ u každého zápisu a konektor má aktivní jen ve zprávě, kde ho zmíníte přes @ERPIO Workspace control. Větší úkol proto zadejte jednou zprávou se zmínkou konektoru. Asistent připraví plán (preview_plan, bez ptaní), ukáže vám ho a provede ho jedním voláním run_plan, takže potvrzujete jen jednou. Potvrzujte tlačítkem Povolit v dialogu, ne napsanou zprávou „Allow“. Když pokračujete další zprávou, začněte ji @ERPIO Workspace control.

Claude Code

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

Potom v Claude Code spusťte /mcp, vyberte erpio-workspace a přihlaste se v prohlížeči stejně jako výše.

ERPIO AI (Open WebUI)

V ERPIO AI (brain.erpio.one) máte stejné nástroje jako nástroj ERPIO Admin. Přidělí vám ho administrátor ERPIO AI. Potom si v chatu u nástroje vyplníte vlastní nastavení (UserValves):

Nastavení	Hodnota
`ERPIO_API_TOKEN`	API token (doporučeno). Workspace se vezme z tokenu, e-mail a heslo se nevyplňují.
`ERPIO_API_TOKENS`	Další API tokeny (další workspace, i jiných účtů): `popisek=token`, více oddělte středníkem. Asistent nabídne workspace všech tokenů; token odeberete smazáním z pole.
`ERPIO_ADMIN_USER`, `ERPIO_ADMIN_PASS`	e-mail a heslo do ERPIO, jen když nepoužíváte token
`ERPIO_ID_CUSTOMER`	ID workspace; u tokenu nepovinné (vyplněné musí odpovídat tokenu), u e-mailu a hesla povinné bez `ERPIO_ALL_WORKSPACES`
`ERPIO_ALL_WORKSPACES`	Povolit i ostatní workspace účtu. Vypnuto (výchozí) = každý API token jen workspace, pro který byl vygenerovaný, e-mail a heslo jen `ERPIO_ID_CUSTOMER`; zapnuto = všechny workspace účtu s administrátorskými právy.
`ERPIO_HELIOS_GATEWAY`	nepovinné: název nebo API klíč gateway pro SQL na Helios (prázdné = jediná aktivní gateway workspace)
`ERPIO_HELIOS_DATA`	zapnuto = asistent smí číst data z databáze workspace (Helios nebo jiná; dotazy SELECT, `helios_run_query`); výchozí vypnuto, asistent pak vidí jen strukturu tabulek. Administrátor workspace může rozhodnout za všechny (Workspace metadata, `MCPConfig`).

ERPIO AI pracuje ve workspace z ERPIO_ID_CUSTOMER, nebo ve workspace, který si vyberete v konverzaci (jen z povolených, viz ERPIO_ALL_WORKSPACES; asistent vám ukáže ID a názvy a zavolá select_workspace; platí do restartu ERPIO AI, trvale ho nastavíte v ERPIO_ID_CUSTOMER). Bez nastavení se jediný dostupný workspace vybere sám a „Workspace“ se nenabízí. Zápis do jiného workspace jen pro jedno volání vždy potvrzujete v dialogu.

Další MCP klienti

Konektor funguje s každým klientem, který podporuje:

MCP přes Streamable HTTP na adrese https://mcp.erpio.one/mcp,
OAuth 2.1 s PKCE a dynamickou registrací klienta (DCR); vše potřebné najde v https://mcp.erpio.one/.well-known/oauth-authorization-server,
obnovu přístupu přes refresh token.

Klienti, kteří umějí jen pevný API klíč v hlavičce, se připojit nemohou.

Nástroje mají MCP anotace: čtecí jsou označené readOnlyHint, takže je klienti jako Claude nebo Gemini spouštějí bez ptaní. Zakládání je nedestruktivní zápis, úpravy a mazání existujících objektů jsou označené jako destruktivní (destructiveHint) a klient se před nimi zeptá. Po aktualizaci konektoru ho v klientovi připojte znovu, aby načetl nové definice nástrojů.

Příklady zadání

„Vypiš data sources ve workspace a ukaž, které nemají nastavený API klíč.“
„Najdi v Heliosu tabulky s organizacemi a ukaž mi sloupce TabCisOrg.“
„Založ data source Organizace – přehled se SELECTem z TabCisOrg (Cislo, Nazev, ICO), set nad ním a dlaždici na dashboard Obchod.“
„K akci 12345 přidej povinný parametr @DatumOd typu datum s popiskem Datum od.“
„Parametr @Stredisko akce 12345 napoj na výběr ze setu Střediska, kód Cislo a popis Nazev.“
„Přidej do setu Zakázky řádkovou akci Upravit, která přes UPDATE změní poznámku zakázky.“
„Zapamatuj si pro tento workspace, jak jsme vyřešili import faktur – ať to příště víš.“

Před SQL nad Heliosem si asistent nejdřív projde strukturu tabulek. Výsledek vždy zkontrolujte v ERPIO.

Přihlášení a bezpečnost

Konektor pracuje pod vaším ERPIO účtem a s vašimi právy. Vidí a mění jen to, co vy v administraci ERPIO.
API token (nebo heslo) se ukládá šifrovaně na serveru konektoru, aby se mohl do ERPIO znovu přihlásit, když session vyprší. Přístupové tokeny konektoru jsou uložené jen jako otisk (hash).
Když API token v ERPIO smažete, přegenerujete nebo mu vyprší platnost, konektor ho přestane používat nejpozději do hodiny.
Přístupový token platí hodinu a Claude ho obnovuje sám. Když konektor 30 dní nepoužijete, připojíte se znovu.
Po 5 neúspěšných pokusech o přihlášení během 15 minut se přihlašování na 15 minut zablokuje.
Každé volání nástroje se na serveru zapisuje do auditu (uživatel, workspace, nástroj, výsledek, doba trvání).
Nástroj helios_run_query spustí jen jeden dotaz pro čtení (SELECT nebo WITH). Další příkazy a zápisová slova (INSERT, UPDATE, DELETE, EXEC, SELECT … INTO) odmítne.
Dotazy na data databáze workspace (Helios nebo jiná, helios_run_query) čtou data zákazníka, proto jdou jen s vaším souhlasem: při připojení konektoru (a u každého přidaného tokenu) zaškrtněte Povolit asistentovi číst data z databáze (výchozí je vypnuto, změníte to odpojením a novým připojením, u přidaného tokenu novým uložením pod stejným názvem). Asistent si to sám zapnout neumí. Struktura tabulek (bez dat) jde vždy. Administrátor workspace může rozhodnout za všechny v ERPIO: Workspace metadata → New, EntityIDent LTWCustomer, Prop. Name MCPConfig, Value {"helios_run_query": false} (nebo true).
Přístup zrušíte odpojením konektoru v Claude (Disconnect), u tokenu také jeho smazáním v ERPIO.

Zápisy jdou rovnou do ERPIO a nedají se vrátit. Nové věci zkoušejte nejdřív v testovacím workspace a u nástrojů, které zapisují, nechte v Claude zapnuté schvalování. Před smazáním setu nebo data source si nechte vypsat, co na nich závisí.

Řešení problémů

„Neplatný API token (zrušený, vypršel nebo neúplný).“: Vložte token celý, bez mezer. Pokud byl smazán nebo mu vypršela platnost, vygenerujte v ERPIO nový.
„API token patří k workspace …“: Token je z jiného workspace, než jste zadali (v ERPIO AI v ERPIO_ID_CUSTOMER). Použijte token z toho workspace, nebo opravte ID.
„Nesprávný e-mail nebo heslo do ERPIO.“: Použijte stejné údaje jako do administrace ERPIO.
„Účet nemá přístup do workspace …“: Účet není členem workspace s tímto ID. Zkontrolujte číslo v hlavičce administrace ERPIO.
„Účet nemá administrátorská práva ve workspace …“: Konektor potřebuje administrátorská práva. Požádejte o ně správce workspace.
„Příliš mnoho neúspěšných pokusů.“: Počkejte 15 minut a přihlaste se znovu.
„Přihlášení vypršelo nebo je neplatné.“: Přihlašovací stránka platí 15 minut. V Claude klikněte na Connect znovu.
Ulozene prihlaseni do ERPIO uz neplati: API token byl zrušen nebo vypršel, nebo se v ERPIO změnilo heslo. Konektor v Claude odpojte a připojte znovu s novým tokenem nebo heslem.
Prihlaseni ke konektoru uz neplati: Konektor v Claude odpojte a připojte znovu.
MW session uctu je ve workspace …: Session ERPIO byla v jiném workspace. Konektor si ho při dalším volání nastaví sám, operaci zopakujte; případně řekněte asistentovi „zavolej sync_mw_workspace“. Viz Workspace a MW session.
Nelze vybrat gateway pro SQL: Workspace má víc aktivních gateway (nebo žádnou) a není jasné, kterou použít. V ERPIO AI vyplňte ERPIO_HELIOS_GATEWAY, u konektoru v Claude se obraťte na správce konektoru.
SQL chyba: …: Chyba v dotazu, například neexistující sloupec. Asistent ji vidí a dotaz opraví.
Set není vidět v přehledu setů nebo nenačítá data: Data source nebo set nemá API klíč gateway. Řekněte asistentovi, ať klíče zkontroluje a doplní.
V prohlížeči na adrese konektoru vidím invalid_token: To je v pořádku. Adresa slouží aplikacím, ne prohlížeči.
Plugin se na bránu nenahrál, brána se nerestartovala: Brána si ZIP stahuje sama a umí jen TLS 1.0, které má novější Windows vypnuté. Na počítači brány nastavte v registru SchUseStrongCrypto a SystemDefaultTlsVersions na 1 (klíč HKLM\SOFTWARE\Microsoft\.NETFramework\v4.0.30319 i stejný pod WOW6432Node), restartujte jen službu této brány a nahrajte plugin znovu. Záznam CANCELED#timeout1 v EventLogu brány se objeví i při úspěšném nahrání, to není chyba.

Pro správce a implementátory

Workspace a MW session

Konektor pracuje ve workspace, který asistent uvede v parametru workspace každého volání. Výběr platí pro konverzaci; server konverzace nerozlišuje, proto si ho nepamatuje. Má-li připojení jen jeden dostupný workspace, použije se sám; při více workspace nástroj bez parametru nic neudělá a vrátí seznam. Dostupné jsou workspace přihlášení a všech přidaných tokenů (add_login_key), každý přes svůj token a vlastní session ERPIO. Každé přihlášení smí jen do svého workspace (API token do workspace, pro který byl vygenerovaný, heslo do zadaného workspace); se zaškrtnutím „Povolit i ostatní workspace účtu“ do všech workspace účtu. Je to pravidlo konektoru, ERPIO samo token na workspace neomezuje. Workspace pojmenované „Workspace“ se nenabízejí, jen ty, kde máte administrátorská práva.

Většina nástrojů volá REST API ERPIO s ID workspace. Editory administrace (akce, sety, dlaždice), synchronizace sloupců a SQL na Helios ale běží ve workspace, který máte vybraný ve svém účtu ERPIO (číslo v hlavičce administrace). Když se liší, konektor operaci odmítne dřív, než by se cokoli uložilo jinam:

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) i ERPIO AI si workspace v ERPIO session nastavují samy při každém přihlášení do ERPIO, takže v administraci v prohlížeči můžete mít otevřený jiný workspace. ERPIO ale volbu ukládá k účtu: při dalším přihlášení do administrace se vám otevře workspace, který naposledy použil konektor. Kdyby hláška přesto přišla, operaci zopakujte, případně řekněte asistentovi „zavolej sync_mw_workspace“.

Co nástroje hlídají samy

Nástroje dodržují konvence ERPIO, aby výsledek fungoval stejně, jako kdyby ho někdo naklikal v administraci:

Set dostane automaticky skrytou navigační akci sám na sebe. Používá se pro dlaždice a odkazy.
Data source se SQL se zakládá jako typ „any SQL“ s limitem 1 000 řádků. SQL musí být jediný SELECT bez ORDER BY, protože ERPIO dotaz obaluje do poddotazu. Složitější logiku dejte do inline tabulkové funkce, výchozí řazení se nastavuje na setu.
API klíč gateway musí mít data source i set, jinak set není vidět a nenačítá data. Gateway vybírejte podle názvu.
Dlaždice má typ Text, pokud neřeknete jinak, a set otevírá přes jeho skrytou navigační akci.
Editační akce (INSERT, UPDATE nebo DELETE jednoho záznamu) je typu Edit. Data repeater jen pro hromadnou úpravu více řádků.
Parametry akce: přidání nebo změna parametru zachová ostatní. Povinný parametr se nastaví příznakem Required. Zdroj hodnoty (ValName) musí být systémová hodnota, sloupec setu nebo parametr data source.
Výběr ze setu (cSET) nastaví bind_param_picker. Výběrová akce je vždy skrytá a do formuláře se doplní kód i popis.
Smazání setu smaže i akce, které na něj vedou, včetně skrytých výběrových akcí na jiných setech. Před smazáním si nechte vypsat akce (list_actions).
SQL na jednom řádku (data source, SQL akce, výchozí hodnota parametru – getter) se uloží odřádkované, aby se dalo číst v administraci. Ručně odřádkované SQL zůstane, jak je. Výpis akcí ukazuje u getteru uložené SQL.
Ikony akcí a dlaždic jen z Font Awesome Free do verze 5.15.4 (např. fa-plus, značky fab fa-android). Ikonu z verze Pro nebo 6 asistent nenastaví a navrhne náhradu, protože ERPIO App by místo ní ukázala prázdné tlačítko.
Seskupení řádků v tabulce a seznamu aplikace zapne sloupec, jehož název začíná přesně Group_ (např. Group_Stredisko). Název Group… bez podtržítka seskupení nezapne – nástroj na to upozorní a upozorní i na set, který takový sloupec zdroje nemá.
Seznamy v administraci (globální parametry, rozvrhy, pluginy) asistent čte celé, i když mají víc stránek.
Metadata workspace mění nastavení aplikace všem uživatelům workspace. Asistent zapisuje jen ErpioSettings a CustomLinks a mění jen uvedené hodnoty. MCPConfig (povolení čtení dat) nikdy nezapíše a API token vlastních odkazů (E1Key) nevypíše ani nezapíše – ten nastaví administrátor v ERPIO.
Na jednom setu smí sloupec (AtColumn – klik na hodnotu otevře akci) otevírat jen jedna akce a plovoucí tlačítko (FloatingActionButton) smí mít jen jedna akce. Obsazený sloupec nebo tlačítko nástroj odmítne a řekne, která akce ho má.
Před SQL nad Heliosem asistent nejdřív projde schéma (helios_list_tables, helios_get_table_schema).

Rozdíl oproti ERPIO One MCP

	ERPIO Workspace Control	ERPIO One MCP
Adresa	`https://mcp.erpio.one`	clientmcp.erpio.one
K čemu	administrace workspace: data sources, sety, akce, dashboardy, dotazy do Heliosu	vybrané metody klientského API (např. zakázky, aktivity)
Přihlášení	API token uživatele, nebo e-mail, heslo a ID workspace do ERPIO	klíč e1key
Pro koho	implementátoři a správci ERPIO	uživatelé ERPIO One

Provoz

Stav serveru: https://mcp.erpio.one/health
OAuth metadata: https://mcp.erpio.one/.well-known/oauth-protected-resource/mcp a https://mcp.erpio.one/.well-known/oauth-authorization-server
Tato stránka: https://mcp.erpio.one/docs, jazyk volíte parametrem ?lang=cs, sk nebo en.
Dlouhé operace (SQL přes gateway, synchronizace sloupců) mohou trvat desítky sekund.