AI asistent a MCP server

eŽÁKOVSKÁ nabízí server MCP (Model Context Protocol). Učitelé, vedení školy, žáci i rodiče si díky němu mohou připojit AI asistenta – například Claude – a ptát se ho na rozvrh, suplování, akce, úkoly nebo souhrny třídy. Vedení školy přes něj čte i statistiky, zprávy, výchovná opatření, přijímací řízení, maturitu, sestavy, stravování, souhlasy, uživatele, hospitace nebo rozpočet – vždy jen to, co vidí v aplikaci, a se stejnými čísly. Pedagogové nechají AI připravit koncepty oznámení, akcí, zpráv, výchovných opatření a anket; zveřejní, zapíše nebo aktivuje je až člověk.

Adresa serveru

Jak připojit v Claude

1. V Claude otevřete Nastavení → Konektory a zvolte Přidat vlastní konektor.
2. Zadejte název eŽÁKOVSKÁ a URL https://www.ezakovska.cz/api/mcp.
3. Klikněte na Připojit. Otevře se přihlášení do eŽÁKOVSKÉ – přihlaste se e-mailem a kódem.
4. Vyberte školu (pokud jich máte víc) a oprávnění, která chcete AI dát, a potvrďte.
5. V konverzaci konektor zapněte. Zkuste: „Co mám zítra v rozvrhu?“ nebo „Připrav koncept oznámení o třídních schůzkách.“

Připojené aplikace najdete a kdykoli odvoláte v Nastavení → AI a MCP.

Oprávnění (scopes)

• read – čtení: vše, co vidíte v aplikaci, ale bez kontaktů. Mají všechny role.
• drafts – koncepty: AI může uložit koncept oznámení, akce, zprávy, výchovného opatření nebo pochvaly, ankety, opatření Kvalitní školy, pozorování talentu a poznatku nebo importu kariérního poradce. Nic se samo nezveřejní ani neodešle. Výchovné opatření zapíše pedagog v aplikaci (Výchovná opatření a pochvaly → Koncepty výchovných opatření od AI → Zapsat) – teprve tím odejde oznámení žákovi a rodičům; anketu aktivuje autor v aplikaci. Jen pedagogové a vedení.
• write – zápis: zveřejnění konceptu oznámení, akce nebo zprávy, schválení omluvenky, splnění povinnosti z kalendáře Ředitelny a potvrzení importu kariérního poradce. Jen ředitel, zástupce a učitel. Známky, docházku, uživatele ani výchovná opatření přes AI zapisovat nelze.

Pro vedení školy

• Statistiky školy, přehled třídy a souhrn žáka se stejnými čísly jako stránky Statistiky, Docházka dítěte a Známky (absence celkem a z toho neomluvená, celkový průměr jako průměr průměrů předmětů), známky a vysvědčení žáka, rozvrh podle platné verze.
• Zprávy (doručené, odeslané, archiv, detail se stavem doručení), výchovná opatření a podklad pro pedagogickou radu, konzultace s rodiči a okna poradců (jen souhrn).
• Potvrzení o studiu, přijímací řízení (přehled, uchazeči, výsledková listina), maturita (přihlášky, komise, výsledky), opravné zkoušky, hospitace, akce se souhlasy, zápis žáků a učebny.
• Sestavy jako data, stravování (jídelníček, porce, kredity), kroužky, ankety s výsledky, testy, výukové materiály, volitelné předměty, přítomní ve škole a inventář.
• Souhlasy GDPR po typech, uživatelé a funkce, nastavení „Co vidí rodiče a žáci“, změny rozvrhu a suplování po třídách, tematické plány, probrané učivo a audit log (jen ředitel).
• Ředitelna: povinnosti, výkazy, výroční zpráva, směrnice, zřizovatel, Kvalitní škola, faktury a objednávky a rozpočet.

Co přes AI záměrně nejde

• Zápisy do evidence – známky, docházka, správa uživatelů, funkcí a nastavení, mazání. Patří do aplikace, kde je vidět kontext a kdo zapisuje.
• Úkony s právními účinky – vydání a zneplatnění potvrzení o studiu, rozhodnutí v přijímacím řízení, zápis výsledků maturity a opravných zkoušek, schvalování faktur a objednávek (finanční kontrola podle zák. č. 320/2001 Sb.) a zápis výchovného opatření.
• Citlivé údaje – podpůrná opatření a poradenství, obsah schránky důvěry a bezpečí, wellbeing, zdravotní údaje a důvody nepřítomnosti, mzdové údaje, rodná čísla a exporty s nimi (matrika pro MŠMT, CERTIS, ISIC/ITIC).
• Správa školy – import dat, nový školní rok a generátor rozvrhu.
• Rozesílání – AI sama nepošle e-mail ani push. Zprávu odešle jen nástroj publish_draft po vašem výslovném potvrzení (ukázkovým účtům se ani tak nic nepošle).

Nástroje

Bezpečnost

• Přihlášení přes OAuth 2.1 s PKCE. AI aplikace nikdy nevidí váš přihlašovací kód.
• Každé volání běží vaším jménem a ve zvolené škole se stejnými kontrolami oprávnění jako aplikace: učitel vidí jen svou školu, rodič jen své dítě, přehled třídy jen vedení a vyučující.
• Přístupový token platí 1 hodinu, obnovovací 30 dní a při každém obnovení se mění. Opakované použití starého obnovovacího tokenu přístup okamžitě zruší.
• Tokeny ukládáme jen jako otisk (SHA-256), ne v čitelné podobě.
• Každé volání nástroje se zapisuje do auditního logu školy (kdo, aplikace, nástroj) – bez obsahu parametrů.
• Odvolání v Nastavení zneplatní všechny tokeny dané aplikace okamžitě.

Ochrana osobních údajů (GDPR)

• Přes MCP se nikdy nevydávají rodná čísla, data narození, adresy, telefony, e-maily, zdravotní údaje (včetně alergií strávníků a důvodů nepřítomnosti), údaje o podpůrných opatřeních (SVP) a poradenství, obsah schránky důvěry, mzdové údaje, ověřovací kódy potvrzení ani důvody omluvenek. Přílohy jen názvem – soubory se stahují v aplikaci.
• U žáků se vrací jen jméno, třída a souhrny (průměry, docházka, úkoly) – a jen tomu, kdo je smí vidět i v aplikaci.
• Data, která AI asistent dostane, zpracovává poskytovatel AI podle svých podmínek. Škola by měla připojení AI zahrnout do svých pravidel zpracování osobních údajů a připojovat jen služby, se kterými má smluvně ošetřené zpracování.
• Připojení je dobrovolné a lze ho kdykoli odvolat.

Limity

• 2 000 čtení a 200 zápisů (koncepty, zveřejnění, schválení) denně na jedno připojení. Limit se obnovuje o půlnoci UTC.
• Seznamy jsou omezené (obvykle nejvýš 200–500 řádků v jedné odpovědi; zkrácený seznam má příznak truncated).

Pro vývojáře

• MCP: POST /api/mcp (Streamable HTTP, bezstavový, JSON odpovědi)
• /.well-known/oauth-protected-resource (RFC 9728)
• /.well-known/oauth-authorization-server (RFC 8414)
• POST /api/oauth/register (RFC 7591), /oauth/authorize, POST /api/oauth/token, POST /api/oauth/revoke

Zpět na eŽÁKOVSKÁ.cz