# Studio aplikacji

:::tip
Menu → Studio aplikacji

:::

  
**Studio aplikacji** pozwala zbudować własną aplikację na danych OmniMES bez programowania. Opisujesz w czacie, czego potrzebujesz — np. „tablica z OEE linii 2 z ostatniej zmiany” albo „formularz zgłaszania przyczyn przestojów” — a **Claude**, model AI firmy Anthropic, sprawdza strukturę zakładu i dane, po czym pisze gotową aplikację. Widzisz ją od razu w podglądzie obok czatu i poprawiasz kolejnymi wiadomościami.

Gotową aplikację umieszczasz w menu OmniMES — we własnych sekcjach i podmenu — i udostępniasz wszystkim użytkownikom, wybranym grupom albo konkretnym osobom. Ta sama aplikacja działa również w **Claude Desktop**, bo jest zgodna z otwartym standardem **MCP Apps**.

Pozycja **Studio aplikacji** w menu ma oznaczenie **Beta**: funkcja jest gotowa do użycia, ale wciąż rozwijana — jej możliwości i wygląd ekranów mogą się zmieniać w kolejnych wersjach (patrz *Ograniczenia wersji Beta*).

  
**Co można zbudować:**

* **tablice i ekrany na halę** — stan linii na żywo, OEE, przestoje, realizacja planu zmiany,
* **raporty i analizy** — zestawienia za wybrany okres, rankingi strat, Pareto przyczyn, wykresy,
* **formularze z zapisem do OmniMES** — np. zmiana terminu zlecenia; każdy zapis potwierdza osoba korzystająca z aplikacji,
* **kalkulatory** — koszt przestojów, potrzebne tempo produkcji, prognoza wykonania planu,
* **wspólne listy i notatki zespołu** — np. otwarte sprawy przekazywane między zmianami, komentarze do zleceń.

Gotowe przykłady opisuje sekcja *Przykładowe aplikacje na demo.omnimes.com*.


:::info
**Studio aplikacji a pulpity BI (Redash).** Pulpit BI składa się z zapytań i gotowych typów wizualizacji — sprawdza się w stałych raportach i wykresach. Aplikacja ze Studia to samodzielny ekran o dowolnym układzie i logice: łączy dane z wielu miejsc OmniMES, liczy własne wskaźniki, przyjmuje dane od użytkownika, zapamiętuje ustawienia i — po potwierdzeniu — zapisuje zmiany w OmniMES.

:::

  
**Od pomysłu do aplikacji w menu — w skrócie:**


1. Superuser wpisuje klucz API Claude w zakładce **Połączenie z Claude** (jednorazowo).
2. W zakładce **Kreator** opisujesz aplikację, a Claude ją buduje.
3. Przyciskiem **Dodaj do menu** umieszczasz aplikację w menu i wybierasz, komu ją udostępnić.
4. Użytkownicy otwierają aplikację z menu jak każdy inny ekran OmniMES.

Ekran Studia ma pięć zakładek: **Aplikacje**, **Kreator**, **Menu i udostępnianie**, **Połączenie z Claude** oraz **Dziennik** (tylko superuser).


## Dostęp i role

**Studio aplikacji** to samodzielna pozycja menu, zaraz pod **Listą zleceń**, widoczna w kontekście OmniMES i OmniEnergy. Domyślnie dostęp do niej ma tylko grupa **Administratorzy**. Innym grupom administrator przydziela ekran **Studio aplikacji** w [**Uprawnieniach dostępu**](https://docs.omnimes.com/doc/administracja-MPkdpe2PHq). Wymóg ten obowiązuje niezależnie od trybu kontroli uprawnień po stronie serwera.

| Kto | Co może |
|-----|---------|
| **Użytkownik, któremu udostępniono aplikację** | otwiera ją z menu i korzysta z niej w granicach swoich uprawnień — nie potrzebuje dostępu do ekranu Studia |
| **Grupa z ekranem Studio aplikacji** | tworzy aplikacje w Kreatorze i w Claude Desktop, zmienia i usuwa własne aplikacje, tworzy sekcje menu, udostępnia własne aplikacje, pobiera rozszerzenie dla Claude Desktop i zarządza swoimi osobistymi tokenami |
| **Superuser** (np. konto `omni`) | dodatkowo wpisuje klucz API Claude i wybiera model, widzi i może zmieniać wszystkie aplikacje i pozycje menu, nadaje aplikacjom poziom **Administracyjna** i przegląda zakładkę **Dziennik** |

Aplikację zmienia (kreator, właściwości, wersje, usuwanie) jej autor — widoczny w kolumnie **Właściciel** — oraz superuser. Aplikację o poziomie **Administracyjna** zmienia wyłącznie superuser. Pozycję menu edytuje jej autor, superuser albo członek grupy z ekranem **Uprawnienia dostępu**; przy pozycjach, których nie możesz zmieniać, widać kłódkę **Tylko do odczytu**.


### Poziomy aplikacji

* **Standardowa** — poziom domyślny. Aplikacja odczytuje dane, przechowuje własne dane i — jeśli ma taką możliwość — zapisuje zmiany w danych produkcyjnych OmniMES (np. w zleceniach).
* **Administracyjna** — pozwala dodatkowo na zmiany administracyjne (użytkownicy, grupy, uprawnienia, ustawienia, kopie zapasowe, licencja) oraz na zmianę wielu rekordów naraz. Poziom nadaje wyłącznie superuser w oknie **Właściwości aplikacji** — zawsze dla wersji, którą obejrzał. Gdy kod aplikacji administracyjnej zostanie zmieniony z czatu albo z Claude Desktop, aplikacja wraca do poziomu **Standardowa** i superuser musi zatwierdzić ją ponownie.


## Dwie drogi budowania aplikacji

|     | **W OmniMES — Kreator** | **Poza OmniMES — Claude Desktop** |
|-----|---------------------|-------------------------------|
| Gdzie pracujesz | zakładka **Kreator**: czat obok podglądu aplikacji | rozmowa w aplikacji Claude Desktop na komputerze |
| Kto płaci za Claude | firma — klucz API Claude, koszty rozlicza Claude Console | użytkownik — jego własna subskrypcja Claude |
| Co trzeba przygotować | superuser wpisuje klucz API w zakładce **Połączenie z Claude** | użytkownik pobiera w Studiu rozszerzenie **OmniMES – aplikacje** z osobistym tokenem i instaluje je w Claude Desktop |
| Co działa | tworzenie i poprawianie aplikacji, podgląd na żywo, wersje | lista i podgląd aplikacji w rozmowie, tworzenie i poprawianie aplikacji; zapis do OmniMES z aplikacji jest wyłączony |

Aplikacja zbudowana jedną drogą trafia do tej samej listy w zakładce **Aplikacje** — można ją dalej rozwijać drugą drogą.


:::info
Anthropic nie pozwala logować się subskrypcją Claude (Free, Pro, Max) w aplikacjach firm trzecich. Dlatego czat w OmniMES korzysta z klucza API firmy, a praca na własnej subskrypcji odbywa się w Claude Desktop.

:::


## Zakładka „Połączenie z Claude”


:::tip
Studio aplikacji → Połączenie z Claude

:::

  
Zakładka ma dwie części: **Claude w OmniMES (czat Studia)** — konfiguracja dla czatu w Kreatorze — oraz **Claude Desktop (Twoja subskrypcja Claude)** — rozszerzenie i osobiste tokeny.


### Claude w OmniMES (czat Studia)

Znacznik przy tytule pokazuje stan: **Skonfigurowano** albo **Brak klucza API**; pod spodem widać wybrany model. Klucz i model ustawia wyłącznie superuser — pozostali użytkownicy widzą komunikat **Klucz API i model konfiguruje superuser.**


1. Utwórz klucz API w Claude Console (link pod formularzem).
2. Wklej go w pole **Klucz API Claude**.
3. Wybierz **Model** (patrz tabela niżej).
4. Kliknij **Zapisz**, a następnie **Sprawdź połączenie**. Komunikat **Połączenie działa (model …).** potwierdza, że klucz i model są poprawne.

Zapisany klucz nie jest nigdzie wyświetlany w całości — widać tylko jego fragment (**Zapisany klucz: …**). Aby go zmienić, wpisz nowy i zapisz. **Usuń klucz** wyłącza czat Studia do czasu wpisania nowego klucza.

| Model | Kiedy wybrać |
|-------|--------------|
| **Claude Opus 5.5** | zalecany i domyślny — najlepszy stosunek jakości do ceny |
| **Claude Fable 5.2** | najwyższa jakość aplikacji; ok. 2× droższy od Opus |
| **Claude Sonnet 5.5** | szybszy i ok. 2× tańszy; wystarcza do prostych aplikacji i poprawek |
| **Claude Haiku 5.5** | najtańszy, ale za słaby do budowy aplikacji — częściej pisze kod z błędami |

Te cztery modele tworzą grupę **Sprawdzone w Studiu**. Po zapisaniu klucza OmniMES pobiera z Anthropic także pozostałe zgodne modele i pokazuje je w grupie **Z API Anthropic — niesprawdzone w Studiu** — nowe modele pojawiają się tam same, bez aktualizacji OmniMES. Można z nich korzystać, ale nie były testowane w Studiu. Model, którego nie obejmuje Twój klucz, ma dopisek **(niedostępny dla tego klucza)**.

Zmiana modelu obowiązuje w nowych rozmowach — rozpoczęta rozmowa pracuje dalej na modelu, od którego się zaczęła.


### Kredyty API w planach Max, Ultra i Team

Plany Claude Max, Ultra i Team zawierają co miesiąc kredyty API (Max 100 USD, Ultra 200 USD, Team do 500 USD). Aby wykorzystać je w Studiu:


1. Odbierz kredyty na claude.ai (**Ustawienia → Rozliczenia**).
2. Utwórz klucz API w organizacji Claude Console połączonej z subskrypcją. Dla OmniMES załóż osobny obszar roboczy (workspace) z limitem wydatków.
3. Wklej klucz w pole **Klucz API Claude** i zapisz.

Link **Zasady kredytów API** prowadzi do aktualnych zasad Anthropic.


:::warning
Działa wyłącznie zwykły klucz API z Claude Console. Token logowania subskrypcji Claude nie zadziała — OmniMES go odrzuci.

:::


### Claude Desktop (Twoja subskrypcja Claude)

Tę część widzi każdy, kto ma dostęp do Studia. Opisuje instalację rozszerzenia (patrz *Budowanie w Claude Desktop*) i zawiera:

* przycisk **Pobierz rozszerzenie dla Claude Desktop** — pobiera plik `omnimes-claude.dxt` z wpisanym Twoim osobistym tokenem; **każde pobranie tworzy nowy token**,
* pole **Adres serwera MCP OmniMES** z przyciskiem kopiowania — adres ustawia administrator w [**Konfiguracji ogólnej**](https://docs.omnimes.com/doc/konfiguracja-ogolna-RlKJVcXkdg) (zakładka **MCP (AI)**); gdy serwer jest wyłączony, pod polem pojawia się ostrzeżenie,
* tabelę **Osobiste tokeny**: **Nazwa**, **Początek**, **Utworzono**, **Ostatnio użyty** i przycisk **Odwołaj**.

Osobisty token ma Twoje uprawnienia i działa wyłącznie z aplikacjami Studia. Przycisk **Nowy token** tworzy token bez pobierania rozszerzenia — np. do ręcznego podłączenia asystenta AI, który przyjmuje adres serwera MCP i token. Token jest pokazany tylko raz: **Skopiuj token teraz — nie zobaczysz go ponownie.**

**Odwołaj** unieważnia token — rozszerzenie, które go używa, przestaje działać. Odwołuj tokeny z komputerów, których już nie używasz.


:::info
claude.ai w przeglądarce i aplikacje mobilne Claude wymagają serwera OmniMES dostępnego publicznie przez HTTPS z logowaniem. Instalacje w sieci zakładu (on-premise) tego nie spełniają — w nich korzystaj z Claude Desktop.

:::


## Kreator — budowanie aplikacji w OmniMES


:::tip
Studio aplikacji → Kreator

:::

  
 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9iMWI5NGNmOC00MmQ2LTQxOWQtOTBhOC1lNzM3NzU5MGI2YmIvc3R1ZGlvX2tyZWF0b3IucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.JzgWw7v0jAqK4DBo0GG4fKPYshZ6K0clCjJsgqRX5Xo)

  
U góry Kreatora znajduje się pole **Aplikacja** — wybór aplikacji do zmiany; puste pole oznacza nową aplikację. Pod nim ramka **Aplikację zbudujesz na dwa sposoby** pokazuje, czy czat jest gotowy (**Klucz API jest ustawiony** albo **Brak klucza API — czat jest wyłączony**), a przycisk **Połączenie z Claude** prowadzi do konfiguracji. Lewa kolumna to czat z Claude, prawa — podgląd aplikacji na żywo.


### Nowa aplikacja krok po kroku


1. W zakładce **Aplikacje** kliknij **Nowa aplikacja** (albo otwórz **Kreator** z pustym polem **Aplikacja** — „Nowa aplikacja — opisz ją w czacie”).
2. W polu **Napisz do Claude…** opisz, czego potrzebujesz, i kliknij **Wyślij** (albo **Ctrl+Enter**).
3. Claude sprawdza strukturę zakładu i potrzebne dane — każdy krok widać w czacie jako pozycję ze wskaźnikiem postępu, a tok rozumowania można rozwinąć w polu **Rozumowanie**. Następnie pisze aplikację („Claude pisze aplikację… N KB”).
4. Po zapisie w czacie pojawia się komunikat **Zapisano wersję 1 aplikacji …**, a po prawej stronie — podgląd działającej aplikacji na bieżących danych. Claude nadaje aplikacji również nazwę, opis i ikonę; można je zmienić we **Właściwościach**.
5. Sprawdź aplikację w podglądzie i napisz, co zmienić — np. „dodaj filtr po linii”, „pokaż koszty w złotych zamiast w godzinach”. Każda poprawka zapisuje się jako **nowa wersja**, a podgląd odświeża się sam.
6. Gdy aplikacja jest gotowa, kliknij **Dodaj do menu** nad podglądem (patrz *Zakładka „Menu i udostępnianie”*).

  
**Przydatne elementy Kreatora:**

* **Przerwij** — zatrzymuje bieżącą odpowiedź Claude.
* Pod polem wiadomości widać zużycie ostatniej odpowiedzi: **Ostatnia tura: … tokenów wejścia · … wyjścia**.
* Lista nad czatem zawiera Twoje wcześniejsze rozmowy o wybranej aplikacji; **Nowa rozmowa** zaczyna od zera (np. po zmianie modelu). Rozmowy są prywatne — każdy widzi tylko swoje.
* Claude pracuje po stronie serwera, więc w czasie odpowiedzi możesz przejść do innej zakładki Studia.
* Pole wersji nad podglądem (**Najnowsza (vN)** i wcześniejsze wersje) pozwala obejrzeć starszą wersję. **Odśwież** uruchamia podgląd od nowa, a **Otwórz w nowej karcie** — aplikację na całym ekranie.
* Aby zmienić istniejącą aplikację, wybierz ją w polu **Aplikacja** albo kliknij **Edytuj w kreatorze** na liście aplikacji.


:::info
W czacie Claude odczytuje dane OmniMES z uprawnieniami osoby, która z nim pisze, i nie może niczego zmienić w OmniMES — zapisuje wyłącznie kolejne wersje aplikacji.

:::


### Jak dobrze opisać aplikację

Im konkretniejszy opis, tym mniej poprawek. Napisz:

* **co aplikacja ma pokazać** — wskaźniki, tabele, wykresy; konkretne linie, maszyny albo zlecenia,
* **dla kogo jest** — operator przy linii, mistrz zmiany, kierownik produkcji, zarząd; monitor na hali czy komputer w biurze,
* **jaki okres obejmuje** — bieżąca zmiana, ostatnia doba, tydzień, miesiąc; czy użytkownik ma go wybierać,
* **jakie decyzje ma ułatwić** — co ma od razu rzucać się w oczy i co użytkownik ma zrobić dalej,
* **co ma zapamiętać albo zapisać** — np. ustawienia, komentarze, wspólną listę spraw; czy ma zmieniać dane w OmniMES (np. termin zlecenia),
* **w jakim języku** — aplikacja może mieć inny język niż interfejs OmniMES.


:::tip
Przykład: „Tablica dla mistrza zmiany: stan każdej linii na żywo, maszyny w awarii i przestoje według linii za bieżącą zmianę. Dodaj wspólną listę otwartych spraw, które można dodawać i zamykać, oraz podsumowanie dla następnej zmiany. Aplikacja po angielsku.”

:::

Lepiej zacząć od prostej wersji i rozbudowywać ją kolejnymi wiadomościami niż opisywać wszystko naraz.


### Koszt

Każda odpowiedź Claude w czacie zużywa tokeny rozliczane w Claude Console w ramach klucza API. Orientacyjnie: zbudowanie aplikacji z jedną poprawką kosztowało w naszych testach ok. 3 USD (Claude Opus 5.5). Koszt rośnie wraz z rozmiarem aplikacji i długością rozmowy; Sonnet 5.5 jest ok. 2× tańszy, a Fable 5.2 — ok. 2× droższy. Limit wydatków ustawisz w Claude Console.


## Budowanie w Claude Desktop

W Claude Desktop pracujesz na własnej subskrypcji Claude: przeglądasz i uruchamiasz aplikacje OmniMES w rozmowie, tworzysz je i poprawiasz.


1. Zainstaluj Claude Desktop (claude.ai/download) i zaloguj się swoim kontem Claude.
2. W zakładce **Połączenie z Claude** kliknij **Pobierz rozszerzenie dla Claude Desktop**.
3. Otwórz pobrany plik `.dxt` (dwuklik) albo przeciągnij go do Claude Desktop: **Ustawienia → Rozszerzenia**. Rozszerzenie nazywa się **OmniMES – aplikacje**.
4. W rozmowie poproś np. „pokaż moje aplikacje OmniMES” albo „zbuduj aplikację z OEE linii 2”. Claude wyświetla aplikacje bezpośrednio w rozmowie, tworzy nowe i poprawia istniejące; zapisane wersje widać w Studiu.


:::warning
**Wspólny konektor MCP z Konfiguracji ogólnej nie wystarczy do budowania aplikacji.** Token z [**Konfiguracji ogólnej**](https://docs.omnimes.com/doc/konfiguracja-ogolna-RlKJVcXkdg) (zakładka **MCP (AI)**) daje dostęp administracyjny do pozostałych narzędzi MCP na jednym, wspólnym koncie i nie zawiera narzędzi Studia. Do aplikacji każdy użytkownik pobiera własne rozszerzenie z osobistym tokenem i własnymi uprawnieniami. Oba rozszerzenia mogą być zainstalowane w Claude Desktop jednocześnie.

:::

  
**Ograniczenia w Claude Desktop:**

* **zapis do OmniMES z aplikacji jest wyłączony** — działa odczyt danych i własne dane aplikacji; formularze zapisujące zmiany w OmniMES uruchamiaj w OmniMES,
* aplikację otwartą w rozmowie ponad 30 dni temu albo zmienioną od tego czasu trzeba **poprosić Claude o ponowne otwarcie** — wcześniejsza kopia w rozmowie przestaje pobierać dane (w Dzienniku taki przypadek ma wynik **Do ponownego otwarcia**),
* claude.ai w przeglądarce i aplikacje mobilne nie są obsługiwane dla instalacji w sieci zakładu.


## Zakładka „Aplikacje”


:::tip
Studio aplikacji → Aplikacje

:::

  
 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi84N2UzYTllMC0wZDgzLTRmNmItOWFlMy0xYWFlYjI3NDE4Y2Uvc3R1ZGlvX2FwbGlrYWNqZS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5NDc4ODEwMCwiZXhwIjoxNzk0ODc0NTAwfQ.3FoQl5MobYoV_D-Ikt38yBtlpnI5-TMWqTjF8VYhbCU)

  
Pasek narzędzi: pole **Szukaj aplikacji** (po nazwie, opisie i właścicielu), przełącznik **Moje** / **Wszystkie dostępne**, **Odśwież** oraz **Nowa aplikacja**. **Moje** to aplikacje, których jesteś autorem; **Wszystkie dostępne** — dla superusera wszystkie aplikacje, dla pozostałych własne i udostępnione im.

Tabela zawiera kolumny **Nazwa** (z ikoną), **Opis**, **Wersja**, **Poziom** (**Standardowa** / **Administracyjna**), **Właściciel**, **Zmieniono** (data i osoba) oraz **Menu** — znacznik **w menu**, gdy aplikacja jest w menu. Akcje w wierszu:

* **Otwórz** — uruchamia aplikację na całym ekranie,
* **Edytuj w kreatorze** — otwiera aplikację w Kreatorze,
* **Właściwości**, **Wersje**, **Usuń** — opisane niżej.

Akcje inne niż **Otwórz** są widoczne tylko przy aplikacjach, które możesz zmieniać.


### Właściwości aplikacji

Okno **Właściwości aplikacji** zawiera:

* **Nazwa** i **Opis** — widoczne na liście i w nagłówku otwartej aplikacji,
* **Ikona** — wybierana z listy ok. 90 ikon pogrupowanych tematycznie (np. **Analiza i wykresy**, **Produkcja i logistyka**, **Energia i środowisko**), z wyszukiwaniem,
* **Narzędzia aplikacji** — co aplikacja może robić: **Odczyt danych OmniMES**, **Dane aplikacji** i **Zapis do OmniMES** (oznaczony jako „zapis”). Puste pole oznacza wszystkie narzędzia odczytu i danych aplikacji. **Zapis do OmniMES trzeba wybrać jawnie** — Claude dodaje go tylko wtedy, gdy aplikacja naprawdę ma zmieniać dane,
* **Poziom** — **Standardowa** albo **Administracyjna**; pole widzi i zmienia tylko superuser.

Zmiana narzędzi albo poziomu tworzy nową wersję aplikacji.


### Historia wersji

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9jZmFjNGIwYi1mN2M2LTRiODktYTg1OS1lYWExYzhjYjI1NzQvc3R1ZGlvX3dlcnNqZS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5NDc4ODEwMCwiZXhwIjoxNzk0ODc0NTAwfQ.xJudTKr-lfJbHJYt-5kcK1euX3Erb4hi--5I88vNEgw)

  
Każdy zapis kodu, narzędzi albo poziomu tworzy nową wersję. Okno **Wersje aplikacji …** pokazuje: **Wersję** (bieżąca ma znacznik **bieżąca**), **Datę**, **Autora**, **Opis zmiany**, **Poziom** i **Rozmiar**. Kliknięcie wiersza wyświetla pod tabelą **Podgląd wersji N** — tę wersję działającą na bieżących danych.

**Przywróć** zapisuje wybraną wersję jako nową bieżącą („Przywrócić wersję N? Powstanie nowa wersja z jej treścią.”). Historia pozostaje nienaruszona — można wrócić także do wersji sprzed przywrócenia.


### Usuwanie aplikacji

**Usuń** po potwierdzeniu usuwa aplikację razem ze wszystkimi pozycjami menu, które do niej prowadzą. Wpis o usunięciu trafia do Dziennika.


## Zakładka „Menu i udostępnianie”


:::tip
Studio aplikacji → Menu i udostępnianie

:::

  
 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi85YzliZmJhYi03ZjhkLTRhZTUtODhlMi0zOTg0YjZjMTE5NzQvc3R1ZGlvX21lbnUucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.y1DERB8WcP2NDVeI1M3qFooKOwEVO8p1eWMAyDml_J8)

  
Tu budujesz własne sekcje menu z podmenu i aplikacjami. Każdą pozycję widzą tylko osoby, którym ją udostępnisz. Menu ma trzy rodzaje pozycji:

* **Sekcja** — najwyższy poziom, nowa grupa w menu głównym,
* **Podmenu** — rozwijana pozycja wewnątrz sekcji,
* **Aplikacja** — pozycja otwierająca aplikację; leży w sekcji albo w podmenu.

Sekcje utworzone w Studiu pojawiają się w menu zaraz pod pozycją **Studio aplikacji**, przed **Ustawieniami systemowymi**. Sekcja albo podmenu bez widocznych dla danej osoby aplikacji nie są jej pokazywane. Rodzaju pozycji nie można zmienić po utworzeniu.

Drzewo ma kolumny **Nazwa**, **Rodzaj**, **Aplikacja**, **Kontekst**, **Udostępnienie** (**Wszyscy użytkownicy**, **Tylko autor** albo liczba grup i użytkowników) i **Kolejność**. Akcje w wierszu: **Dodaj podmenu** (przy sekcji), **Dodaj aplikację** (przy sekcji i podmenu), **Edytuj** i **Usuń**.


### Dodawanie aplikacji do menu


1. Jeśli nie masz jeszcze sekcji, kliknij **Dodaj sekcję** i nadaj jej nazwę, np. „Aplikacje zakładu”.
2. Opcjonalnie przy sekcji kliknij **Dodaj podmenu**, aby pogrupować aplikacje.
3. Przy sekcji lub podmenu kliknij **Dodaj aplikację** — albo w Kreatorze **Dodaj do menu**.
4. Wypełnij okno **Dodaj aplikację do menu** i kliknij **Zapisz**. Menu odświeża się od razu.

  
 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi8wY2RhNTIxNC01NjY1LTQwMmUtYTUzMy1mMjkwNGY2OWViYjkvc3R1ZGlvX21lbnVfd2V6ZWwucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.1maUeZLC_7CnF8gKM-vjKbanr64wzifPPZ-7YgOjGYU)


* **Sekcja lub podmenu** — miejsce w menu,
* **Aplikacja** — do wyboru są tylko aplikacje, które możesz zmieniać; cudzej aplikacji nie można umieścić w menu,
* **Nazwa (PL)** (wymagana) i **Nazwa (EN)** — nazwa pozycji w obu językach interfejsu; domyślnie nazwa aplikacji, a pusta nazwa EN przyjmuje wartość PL,
* **Ikona** — z listy, jak we właściwościach aplikacji,
* **Kolejność** — pozycje są sortowane rosnąco; puste pole dodaje pozycję na koniec,
* **Kontekst** — **OmniMES i OmniEnergy**, **OmniMES** albo **OmniEnergy**: w którym kontekście (przełącznik w prawym górnym rogu) pozycja jest widoczna,
* **Udostępnianie** — patrz niżej.


### Udostępnianie

W sekcji **Udostępnianie** zaznacz **Wszyscy użytkownicy** albo wybierz **Grupy** i konkretnych **Użytkowników**. Bez żadnego wyboru pozycję widzi tylko jej autor (**Tylko autor**) oraz superuser.


:::warning
Użytkownik zobaczy pozycję tylko wtedy, gdy widzi też sekcję (i podmenu) nad nią — udostępnij je również.

:::

Każdą pozycję drzewa udostępnia się osobno — np. sekcję „Aplikacje zakładu” wszystkim, a aplikację z kosztami tylko grupie kierowników. Udostępnienie pozwala otworzyć aplikację, ale nie zmienia uprawnień do danych (patrz *Korzystanie z aplikacji*).

**Usuń** przy sekcji lub podmenu usuwa także wszystkie pozycje pod nią. Usunięcie pozycji z aplikacją nie usuwa samej aplikacji — zostaje ona w Studiu.


## Korzystanie z aplikacji

Udostępnioną aplikację otwiera się z menu, z sekcji utworzonej w Studiu. Aplikacja zajmuje cały obszar roboczy; w nagłówku widać ikonę, nazwę, autora („autor: …”), opis, znacznik **Administracyjna** przy aplikacjach administracyjnych oraz przycisk **Odśwież aplikację**. Aplikacje korzystają ze stylu OmniMES, także w ciemnym motywie.

  
**Uprawnienia podczas pracy z aplikacją:**

* Aplikacja działa na koncie osoby, która ją otworzyła — nigdy na koncie autora. Może przy tym tylko to, na co pozwalają uprawnienia **obu** osób: otwierającej i autora. Udostępnienie aplikacji komuś z szerszymi uprawnieniami nie daje więc autorowi wglądu w dane, których sam nie widzi. Wyjątkiem jest aplikacja **Administracyjna**, zatwierdzona przez superusera — działa z uprawnieniami osoby, która ją otworzyła.
* Dwie osoby mogą zobaczyć w tej samej aplikacji różne dane — każda w granicach swoich uprawnień.
* Aplikacja nie ma dostępu do haseł ani tokenów i nigdy nie odczyta ustawień systemu, kont użytkowników, uprawnień ani kopii zapasowych.
* Gdy konto autora zostanie wyłączone albo usunięte, jego aplikacje standardowe przestają pobierać dane.


### Dane aplikacji

Aplikacja może przechowywać w OmniMES własne dane, niezależne od danych produkcyjnych:

* **wspólne** — jednakowe dla wszystkich użytkowników aplikacji, np. stawki kosztów, wspólna lista spraw, komentarze,
* **prywatne** — osobne dla każdego użytkownika, np. jego ustawienia albo zapamiętany filtr.

Zapis danych aplikacji nie zmienia danych OmniMES i nie wymaga potwierdzenia. Gdy aplikacja chce otworzyć link w nowej karcie przeglądarki, OmniMES pyta o zgodę w oknie **Otwarcie linku**.


### Zapis do OmniMES — okno „Potwierdź zapis”

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi84MzExZjk5ZC0zMGI5LTQwMmEtODQzMi02NTY0Y2ZmZGFkOWMvYXBwX3BvdHdpZXJkemVuaWUucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.i6LtyzL-dlySEtQIm6WwE722KW_u085jU_Nlx9gOSBU)

  
Aplikacja może zmienić dane OmniMES (np. termin zlecenia) tylko wtedy, gdy:


1. ma wśród narzędzi **Zapis do OmniMES**,
2. osoba, która ją otworzyła, ma w OmniMES uprawnienia do tej zmiany,
3. ta osoba potwierdzi zmianę w oknie **Potwierdź zapis**.

Okno wyświetla OmniMES, a nie aplikacja — aplikacja nie może go podrobić ani pominąć. Okno pokazuje:

* komunikat **Aplikacja „…” chce zapisać zmianę w OmniMES:** i autora aplikacji,
* rodzaj operacji — **POST** (dodanie), **PATCH** lub **PUT** (zmiana), **DELETE** (usunięcie) — oraz ścieżkę, czyli miejsce w OmniMES, które zostanie zmienione,
* opis zmiany i **Dane do zapisu**,
* przy aplikacji administracyjnej — ostrzeżenie: **To zmiana administracyjna (użytkownicy, uprawnienia, ustawienia). Sprawdź ją dokładnie, zanim zezwolisz.**

**Zezwól na zapis** wykonuje zmianę. **Anuluj** (przycisk domyślny) albo zamknięcie okna oznacza, że nic nie zostaje zapisane.

Opcja **Zezwalaj na ten zapis do zamknięcia aplikacji** sprawia, że taki sam zapis (ta sama operacja i to samo miejsce) nie wymaga ponownego potwierdzenia, dopóki nie zamkniesz albo nie odświeżysz aplikacji. Opcja nie jest dostępna przy usuwaniu — każde usunięcie trzeba potwierdzić osobno.

Każdy zapis wykonany z aplikacji i każda odmowa dostępu trafia do Dziennika.


### Komunikaty

| Komunikat | Znaczenie |
|-----------|-----------|
| **Nie masz dostępu do tej aplikacji. Poproś autora albo administratora o udostępnienie.** | aplikacja nie jest Ci udostępniona w menu |
| **Aplikacja nie istnieje albo została usunięta.** | aplikację usunięto w Studiu |
| **Aplikacja próbowała przejść na inną stronę — zatrzymano. Odśwież, aby uruchomić ją ponownie.** | OmniMES zatrzymał aplikację, która próbowała opuścić swój ekran; jeśli się to powtarza, popraw aplikację w Kreatorze |


## Dziennik


:::tip
Studio aplikacji → Dziennik (tylko superuser)

:::

  
 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi85OTllYWFkNS03MTNlLTRhMTctYTE5Yy01MzYwNGY5N2U3ODgvc3R1ZGlvX2R6aWVubmlrLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.68TngoPFfXZfJCtzFKh3nWsmYMi9JsPU16l5Se4y_YU)

  
Dziennik pokazuje ostatnie 500 wpisów. Zapisywane są:

* zmiany aplikacji — utworzenie, zapis (z listą zmienionych elementów, numerem wersji i zmianą poziomu) oraz usunięcie,
* zmiany menu i udostępniania,
* utworzenie i odwołanie osobistych tokenów, także przy pobraniu rozszerzenia dla Claude Desktop,
* zapisy danych z aplikacji do OmniMES,
* odmowy dostępu.

Odczyty danych nie są zapisywane. Hasła i tokeny w zapisanych danych są maskowane.

Filtry nad tabelą: lista aplikacji (**Wszystkie aplikacje**; usunięte mają dopisek **usunięta**), rodzaj wpisów — **Wszystko**, **Zmiany w Studiu**, **Zapisy danych**, **Odmowy** — oraz **Odśwież**. Kolumny: **Data**, **Użytkownik**, **Aplikacja**, **Zdarzenie**, **Źródło** (**OmniMES**, **Czat Studia**, **Claude Desktop**), **Wynik** (**Udane**, **Odmowa**, **Do ponownego otwarcia**, **Błąd**) i **Szczegóły**.


## Bezpieczeństwo w skrócie

* **Odizolowana ramka.** Aplikacja nie ma dostępu do Twojej sesji, tokenu logowania, haseł ani reszty ekranu OmniMES; nie łączy się z internetem ani z innymi serwerami.
* **Kontrola po stronie serwera.** Każde wywołanie OmniMES sprawdza pod kątem narzędzi aplikacji oraz uprawnień osoby, która ją otworzyła, i autora — zawsze, także gdy kontrola uprawnień w instalacji działa w trybie `audit` albo `off`.
* **Zapis tylko za zgodą.** Każda zmiana danych OmniMES wymaga potwierdzenia w oknie OmniMES.
* **Zmiany administracyjne tylko w aplikacjach zatwierdzonych przez superusera.** Zmiana kodu z czatu albo z Claude Desktop zdejmuje poziom **Administracyjna** do ponownego zatwierdzenia.
* **Claude nie rozszerzy uprawnień.** Granice są zapisane w OmniMES, nie w poleceniach dla Claude — żadna treść w danych ani w rozmowie ich nie zmieni.
* **Chronione sekrety i ślad zmian.** Klucza API nie zwraca żadna funkcja OmniMES, osobisty token jest pokazywany tylko raz i można go odwołać, a zmiany, zapisy i odmowy trafiają do Dziennika.


## Ograniczenia wersji Beta

* rozmiar aplikacji — do 120 KB (jeden plik); większą aplikację Claude musi uprościć,
* czat w Kreatorze wymaga klucza API Claude (koszty rozlicza Claude Console) — bez klucza czat jest wyłączony,
* w Claude Desktop zapis do OmniMES z aplikacji jest wyłączony,
* claude.ai w przeglądarce i aplikacje mobilne Claude działają tylko z serwerem OmniMES dostępnym publicznie — nie z instalacją w sieci zakładu,
* aplikacja nie wczytuje zasobów z internetu — wszystko, czego potrzebuje (np. logo), musi mieć w swoim pliku,
* funkcja jest rozwijana — kolejne wersje OmniMES mogą zmieniać jej możliwości i wygląd ekranów.


## Przykładowe aplikacje na demo.omnimes.com

Na demo.omnimes.com w sekcji menu **Aplikacje zakładu** znajdują się trzy aplikacje zbudowane w Studiu. Pokazują, co można osiągnąć na danych z OmniMES.


### Koszty przestojów

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi81MGNiNTkxMS0zMmQ2LTQ2ZmUtOTFmOC1lNTA2Zjk2MDU5ZTQvYXBwX2tvc3p0eS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5NDc4ODEwMCwiZXhwIjoxNzk0ODc0NTAwfQ.Bo3gkq8gL7nUa1_ODR7obpJJ01ni4_fi8Gc7CddX7Jo)

  
Aplikacja pokazuje, ile złotych linia traci na przestojach:

* koszt przestojów według stawki zł/h ustawianej w **Ustawieniach kosztów** — stawka jest wspólna dla wszystkich użytkowników aplikacji,
* prognoza miesięczna i dostępność,
* koszt według maszyn i Pareto przyczyn,
* ranking strat i plan działań naprawczych z szacowaną oszczędnością.

Przy pierwszym otwarciu aplikacja sama wybiera linię z największymi stratami z ostatniej doby.


### Realizacja zleceń

Aplikacja pokazuje, które zlecenia nie zdążą na termin:

* tempo potrzebne do terminowego zakończenia,
* wykonanie planu i braki według linii,
* koszt braków i wartość niewykonanych sztuk,
* komentarze do zleceń.

Przycisk **Przesuń termin na …** zapisuje w harmonogramie OmniMES nowy termin zakończenia zlecenia — prognozę przy obecnym tempie. Zmiana wykonuje się dopiero po potwierdzeniu w oknie **Potwierdź zapis** (zrzut w sekcji *Zapis do OmniMES — okno „Potwierdź zapis”*).


### Shift Handover Board

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi8zMDJjOGMxNS0zNGEwLTQ1MzktYTIxZS02YTg3M2UzZWI0NTUvYXBwX2hhbmRvdmVyLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.JI-1RRqwNmfqNhLe4uH1WaZw-DJzE-7trci4dBzTZ64)

  
Tablica przekazania zmiany, zbudowana po angielsku:

* stan każdej linii na żywo i maszyny w awarii,
* przestoje i postoje według linii za dziś albo za bieżącą zmianę,
* wspólna lista otwartych spraw dla zmiany — z dodawaniem i zamykaniem,
* automatyczne podsumowanie dla następnej zmiany.

Aplikacja pokazuje, że język aplikacji nie zależy od języka interfejsu OmniMES.


Studio aplikacji pozwala w ciągu jednej rozmowy z Claude zamienić potrzebę zespołu w działający ekran na danych OmniMES — z kontrolą, kto go widzi, co może zmienić i kiedy.

---

**Documents**

- [Omnimes](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnimes-k1PbFf5XE7)
- [Omnienergy](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnienergy-BWrsbBiH1j)
- [Omniplatform](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omniplatform-jARFxkuLdt)
- [FAQ](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/faq-XN4QKuFPZL)
- [Cyberbezpieczeństwo i zgodność (CRA)](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/cyberbezpieczenstwo-i-zgodnosc-cra-6dbPWZS59e)