Üzenőfüzet

Az Üzenőfüzet csak olvasható KRÉTA-integráció Claude-hoz. Két formában létezik, közös maggal — a különbség az, hol futnak a dolgok és ki kezeli az adatot:

A hosztolt vonal: Firebase Hosting (landing, tájékoztatók, szülői dashboard), Cloud Run (belépés, OAuth, MCP, KRÉTA- és Classroom-kapcsolatok), Firestore (privát gyerekprofilok, időkorlátos titkosított kapcsolatok).

Az asztali vonal egyetlen .mcpb fájl: nincs mögötte szerver, fiók vagy kiadott token, és a KRÉTA-jelszó nem hagyja el a gépet. Részletek a desktop/README.md-ben.

Adatkezelési alapelvek

Mindkét vonalra igaz:

• Kizárólag rögzített olvasási műveletek; nincs írás, törlés, sem tetszőleges KRÉTA-útvonalat lekérő tool.

A hosztolt szolgáltatásra:

• A KRÉTA-jelszó csak a belépés idejére kerül a Cloud Run folyamat memóriájába, majd azonnal eldobásra kerül.

• A lejáró KRÉTA-tokenek és Classroom refresh tokenek AES-256-GCM-mel lezárva kerülnek a privát Firestore-profilba.

• A szülő Google-belépése és a gyerekek Classroom-fiókjai külön Google-munkamenetek.

• A kapcsolat bármikor kikapcsolható és törölhető a dashboardon.

Az asztali bővítményre:

• A KRÉTA-jelszó a szülő gépén marad, AES-256-GCM-mel titkosítva; a kulcs a rendszer kulcstárolójában.

• A hozzáférési token csak a folyamat memóriájában él, a Claude bezárásáig.

• Nincs köztes szerver és nincs visszavonandó token: a törlés a gépen egy fájl törlése.

Az Üzenőfüzet független projekt, nem áll kapcsolatban az eKRÉTA Zrt.-vel, és nem hivatalos KRÉTA-termék. A részletes adatkezelési tájékoztató és felhasználási feltételek a publikus weboldalon érhetők el.

Related MCP server: Smartschool MCP Server

Fejlesztés

A repó egy npm workspace három csomaggal:

• core/ — KRÉTA-kliens, iskolakereső és a csak olvasható MCP tool-tábla; mindkét vonal ezt használja;

• server/ — a hosztolt szolgáltatás (backend + web);

• desktop/ — az asztali bővítmény és a .mcpb csomagolás.

Helyi belépési adatok a secrets/ mappában; a Git egyedül az ottani README-t követi.

npm install
npm test
npm run typecheck
npm run build
npm run pack:desktop   # dist/uzenofuzet-<verzió>.mcpb

A backend helyi indítása:

cd server
TOKEN_SEALING_KEY="$(npm run --silent keygen)" \
OAUTH_ALLOWED_REDIRECT_URIS="http://localhost:6274/oauth/callback" \
npm run dev

A szükséges környezeti változókat és az infrastruktúra részleteit a server/README.md dokumentálja.

Deploy

Firebase Hosting és Firestore-szabályok:

npm run build:web -w uzenofuzet-server
cd server && firebase deploy --project uzenofuzet --only firestore:rules,hosting

A backend Cloud Runra kerül, a repó gyökeréből — a build kontextusnak tartalmaznia kell a core/ csomagot is:

gcloud run deploy uzenofuzet --source . --region europe-west1 --project uzenofuzet
``` A production parancsot, a Secret Manager
hivatkozásokat, a Classroom OAuth-beállításokat és a scheduler konfigurációját
lásd a [`server/README.md`](server/README.md) Deploy szakaszában.

## Licenc

[Apache License 2.0](LICENSE). A szoftver „AS IS” állapotban használható; a
KRÉTA rendszeréhez, nevéhez és védjegyéhez nem biztosít jogot.