STUSYM MCP Server - dokumentace

STUSYM poskytuje MCP (Model Context Protocol) server, který umožňuje AI asistentům přistupovat k datům školního rozvrhu: učitelům, třídám, předmětům, učebnám a rozvrhovým událostem. Tato stránka popisuje dostupné nástroje a způsob připojení.

MCP URL: https://mcp.stusym.com
Protokol: MCP 2025-03-26, JSON-RPC 2.0, Streamable HTTP
Autentizace: OAuth 2.0 Authorization Code Flow + PKCE, pouze bearer token
Autorizační model: Otevřená registrace klientů, validace redirect_uri, oprávnění omezené na administrátora instance a OAuth scopes pro jednotlivé nástroje.

Přehled nástrojů

Nástroj Popis Typ
Systém
get_instance_infoMetadata školy, aktivní dny a časové slotyčtení
Učitelé a uživatelé
list_usersSeznam učitelů a uživatelů s filtryčtení
get_userDetail uživatelečtení
create_userVytvoření uživatele nebo učitelezápis
update_userÚprava uživatelezápis
delete_userSmazání uživateledestruktivní
Třídy
list_classesSeznam tříd s filtryčtení
get_classDetail třídyčtení
create_classVytvoření třídyzápis
update_classÚprava třídyzápis
delete_classSmazání třídydestruktivní
Předměty
list_subjectsSeznam předmětů s filtryčtení
get_subjectDetail předmětučtení
create_subjectVytvoření předmětuzápis
update_subjectÚprava předmětuzápis
delete_subjectSmazání předmětudestruktivní
Učebny
list_roomsSeznam učeben s filtryčtení
get_roomDetail učebnyčtení
create_roomVytvoření učebnyzápis
update_roomÚprava učebnyzápis
delete_roomSmazání učebnydestruktivní
Rozvrh
list_timetablesRozvrhové události s filtry podle učitele, třídy, učebny nebo dnečtení
get_timetableDetail rozvrhové událostičtení
create_timetableVytvoření události s automatickou detekcí kolizízápis
update_timetableÚprava události s automatickou detekcí kolizízápis
delete_timetableSmazání rozvrhové událostidestruktivní

Ukázky použití

Příklad 1 - čtení rozvrhu
Prompt: "Kdo učí matematiku ve třídě 2.A a kdy mají nejbližší hodinu?"
Výsledek: AI zavolá list_timetables s filtrem třídy a předmětu a vrátí jméno učitele, den a hodinu.
Příklad 2 - detekce kolize
Prompt: "Naplánuj matematiku pro 1.A v pondělí v 8:00 do učebny 101 s učitelem Novákem."
Výsledek: AI zavolá create_timetable. Server automaticky zkontroluje kolize učitele, třídy i učebny a vrátí varování, pokud kolize existuje.
Příklad 3 - správa dat
Prompt: "Založ nového učitele Petra Krále s kódem KRL a e-mailem [email protected]."
Výsledek: AI zavolá create_user s rolí učitel a vrátí potvrzení s přiděleným ID.

Dotazy k integraci: [email protected]