Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SCOBEES_PASSWORDNoYour scobees password for password-based login.
SCOBEES_USERNAMENoYour scobees username for password-based login.
SCOBEES_REFRESH_TOKENNoA refresh token used as a transitional option for accounts that sign in only via Microsoft 365 or Eduplaces and therefore cannot use password login.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Kursaufbau in scobees. Neu: scobees_list_subjects → Lehrkraft wählt das Fach → scobees_create_lernpfad → scobees_create_gliederung → scobees_create_aufgabe (Arbeitsblatt als Markdown) → scobees_upload_material. Bestehende Kurse: scobees_list_lernpfade → scobees_get_lernpfad → scobees_get_aufgabe, dann gezielt ändern: scobees_patch_arbeitsblatt für einzelne Textstellen, scobees_update_* für Felder, scobees_upload_material mit ersetzt_attachment_id bzw. scobees_delete_material für Dateien. Aufgaben aus einem anderen Lernpfad übernehmen: scobees_copy_aufgabe (kopiert Arbeitsblatt, Anhänge, Musterlösungen und Kachelbild mit) statt Lesen und Neu-Anlegen. Nach dem Schreiben zurücklesen und warnungen[] beachten. Kachelbilder (cover_image_path) nur erzeugen, wenn die Lehrkraft sie für die jeweilige Ebene wünscht. Ist ein Lernpfad bereits zugewiesen (scobees_get_lernpfad: zugewiesen=true, sonst warnung_zugewiesen im Ergebnis), sehen Lernende jede Änderung sofort – dann nur mit Zustimmung der Lehrkraft schreiben und nie Unfertiges anlegen. Zuweisung an Lerngruppen und Fächerverwaltung bleiben in der Weboberfläche; dieser Server greift nie auf Schüler- oder Personendaten zu.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
scobees_meA

Zeigt das eigene scobees-Konto (ID, Rolle, Schule), prüft die Anmeldung und vergleicht die scobees-Version mit der, für die dieser Server geprüft wurde.

scobees_list_workspacesA

Listet alle Lernbereiche (Kacheln in der Bib) mit ihren Fächern. Nur lesen – Verwaltung bleibt beim Administrator.

scobees_list_subjectsA

Listet Fächer (Kurse), optional gefiltert auf einen Lernbereich. Die Lehrkraft wählt hieraus das Fach, in dem ein Lernpfad angelegt wird.

scobees_list_tagsA

Listet Jahrgänge und Differenzierungsstufen der Schule (für create_lernpfad / create_aufgabe).

scobees_list_lernpfadeA

Listet Lernpfade eines Fachs (oder alle) mit ID, Name, Status, Jahrgängen. Zum Finden bestehender Kurse, die erweitert werden sollen.

scobees_get_lernpfadA

Lädt einen Lernpfad mit vollständigem Aufbau (Gliederungen → Aufgaben) als kompakten Baum. IDs daraus werden für Änderungen benötigt. An der Wurzel steht zugewiesen (true = Lernende arbeiten bereits damit, jede Änderung ist für sie sofort sichtbar). Je Element: typ, Status, hat_titelbild (eigenes Kachelbild gesetzt?), bei Aufgaben zusätzlich Art-Kennung, Anhänge und Arbeitsblatt-Bausteine. Die Beschreibung der Lernpfad-Wurzel kommt unverändert zurück.

scobees_get_aufgabeA

Lädt eine einzelne Aufgabe: Arbeitsblatt als Markdown, Abgabeform (art, abgabeformen), Links, Anhänge und Musterlösungen mit ihren ATT-IDs (für scobees_delete_material / ersetzt_attachment_id), Kachelbild. Vor jeder Änderung an einer bestehenden Aufgabe aufrufen.

scobees_create_lernpfadA

Legt einen neuen Lernpfad in einem Fach an (Wurzel). Danach Gliederungen und Aufgaben mit den anderen Werkzeugen hinzufügen. Der Pfad erscheint in der schuleigenen Bib (published) und hat Status INACTIVE, bis eine Lehrkraft ihn in der Weboberfläche einer Lerngruppe zuweist.

scobees_update_lernpfadB

Ändert einen bestehenden Lernpfad (Wurzel): Fach, Name, Beschreibung, Jahrgänge, Stichwörter, Titelbild, Reihenfolge. Nicht angegebene Felder bleiben erhalten. in_bib: Schalter „In schuleigener Bib veröffentlichen“. Fach bleibt beim Administrator, Zuweisung an Lerngruppen in der Weboberfläche.

scobees_create_gliederungA

Legt eine Gliederungsstruktur (Ordner/Phase) in einem Lernpfad oder einer anderen Gliederung an. Beschreibung ist HTML (h2, p, strong, em, u, a, span style=color). solve_order=after_solving sperrt jede Aufgabe der Gliederung, bis die davor abgegeben ist (Standard: frei). Optional mit eigenem Kachelbild (cover_image_path) und Farbe; ohne Bild zeigt scobees das Standardbild.

scobees_update_gliederungA

Ändert Name, Beschreibung, Kachelbild, Farbe und/oder Bearbeitungsreihenfolge (solve_order) einer Gliederungsstruktur. Nicht angegebene Felder bleiben erhalten (auch ein vorhandenes Kachelbild, die Farbe und die Reihenfolge).

scobees_create_wahlpflichtA

Legt eine Wahlpflichtaufgabe an: ein Container, aus dem Lernende eine Mindestanzahl an Unteraufgaben lösen. Unteraufgaben danach mit scobees_create_aufgabe (parent_id = diese ID) anlegen. Eine bestehende Aufgabe lässt sich ab scobees 94.6 auch mit scobees_move hineinschieben (sie verliert dabei ihren Aufgabentyp); heraus kommt eine Unteraufgabe nicht mehr.

scobees_update_wahlpflichtB

Ändert eine Wahlpflichtaufgabe (Name, Beschreibung, Mindestanzahl, Farbe, Titelbild). Nicht angegebene Felder bleiben erhalten.

scobees_upload_bildA

Lädt ein Bild (png/jpg/gif/webp/svg) für ein interaktives Arbeitsblatt hoch und liefert die URL, die im Markdown als Beschreibung verwendet wird. Das Bild liegt danach öffentlich im Medienspeicher des Serlo-Editors (wie beim Hochladen in der Weboberfläche) – keine Personenfotos oder vertraulichen Inhalte.

scobees_create_aufgabeA

Legt eine Aufgabe in einer Gliederung, einer Wahlpflichtaufgabe oder direkt im Lernpfad an. art bestimmt die Abgabe (nicht das Quiz): info, selbstkontrolle (Standard: Arbeitsblatt mit sich selbst prüfendem Quiz, keine Abgabe), abgabe_optional, abgabe_pflicht, abgabe_selbstkorrektur, abgabe_pflicht_selbstkorrektur. Das Arbeitsblatt kommt als Markdown (arbeitsblatt_markdown; Quiz-Blöcke quiz-sc, quiz-mc, quiz-input, quiz-blanks, quiz-blanks-dnd, quiz-text, dazu math, :::box, :::spoiler) oder als fertiges serlo_json. Liegt parent_id in einer Wahlpflichtaufgabe, setzt der Server den dafür nötigen Aufgabentyp selbst. Das Ergebnis kann warnungen[] enthalten (z. B. $…$ in einer Lückenantwort). Material und Musterlösungen danach mit scobees_upload_material anhängen.

scobees_update_aufgabeA

Ändert eine bestehende Aufgabe. Nur übergebene Felder werden geändert; ein vorhandenes Kachelbild bleibt erhalten. arbeitsblatt_markdown/serlo_json ersetzen das Arbeitsblatt komplett (vorher mit scobees_get_aufgabe lesen) – für einzelne Textstellen ist scobees_patch_arbeitsblatt der kürzere und sicherere Weg.

scobees_patch_arbeitsblattA

Ändert das Arbeitsblatt einer Aufgabe gezielt, statt es komplett neu zu senden: ersetzt im aktuellen Markdown jede angegebene Zeichenkette durch eine neue. Alles-oder-nichts – jede „alt“-Zeichenkette muss genau einmal vorkommen, sonst wird nichts geändert und die Meldung nennt jede fehlgeschlagene Ersetzung (nicht gefunden/mehrfach gefunden). Nur möglich, wenn das Arbeitsblatt verlustfrei als Markdown darstellbar ist (keine Bausteine wie Bild-Zuordnung ohne Markdown-Entsprechung); sonst Fehlermeldung mit Verweis auf scobees_get_aufgabe(mit_serlo_json) + scobees_update_aufgabe(serlo_json).

scobees_upload_materialA

Hängt eine lokale Datei an eine Aufgabe an – als Material (PDF, Bild, HTML-Simulation, interaktive Seite, GeoGebra-Datei …) oder als Musterlösung. ersetzt_attachment_id: nach erfolgreichem Hochladen wird dieser alte Anhang gelöscht (z. B. bei einer neuen Fassung derselben Datei); schlägt der Upload fehl, bleibt der alte unangetastet.

scobees_delete_materialA

Löscht genau einen Anhang (Material oder Musterlösung) einer Aufgabe. attachment_id aus scobees_get_aufgabe (anhaenge[].id / musterloesungen[].id). Erfordert confirm=true. Prüft, dass der Anhang wirklich zu dieser Aufgabe gehört, und warnt, wenn es das letzte PDF einer Stift-Abgabe (abgabeformen: pen) ist – ohne PDF ist dort kein Abgeben mehr möglich.

scobees_moveA

Verschiebt eine Aufgabe/Gliederung/Wahlpflicht an eine Position (sort_order, 0-basiert) – auch in eine andere Gliederung desselben Lernpfads. Eine einzelne Aufgabe lässt sich auch in eine Wahlpflichtaufgabe verschieben (ab scobees 94.6): Sie wird dabei zur Unteraufgabe, verliert ihren bisherigen Aufgabentyp (Pflicht/Extra/Training/Projekt) und kommt nicht wieder heraus – das Ergebnis nennt die Umstellung unter warnung. Unteraufgaben lassen sich nur innerhalb ihrer Wahlpflichtaufgabe umsortieren.

scobees_copy_aufgabeA

Kopiert eine bestehende Aufgabe in eine Gliederung oder direkt in einen Lernpfad – auch in einen anderen Lernpfad oder ein anderes Fach. scobees kopiert dabei Beschreibung, Arbeitsblatt, Anhänge, Musterlösungen, Kachelbild und alle Einstellungen; die Kopie ist danach unabhängig vom Original. Optional gleich anpassen: name, description_html und ersetzungen fürs Arbeitsblatt (wie scobees_patch_arbeitsblatt, alles oder nichts – passt eine Ersetzung nicht genau einmal, wird gar nicht erst kopiert). Für übernommene Aufgaben immer dieses Werkzeug nehmen statt Lesen und Neu-Anlegen: nichts wird abgeschrieben, keine Datei neu hochgeladen. Unteraufgaben einer Wahlpflichtaufgabe lassen sich nicht kopieren, und eine Wahlpflichtaufgabe ist kein Ziel (erst in die Gliederung kopieren, dann mit scobees_move hineinschieben).

scobees_deleteA

Löscht eine Aufgabe, eine leere Gliederung oder Wahlpflichtaufgabe oder einen ganzen Lernpfad. Erfordert confirm=true. Regeln von scobees: Ein ganzer Lernpfad wird mit allen Unterelementen gelöscht, aber nur solange er niemandem zugewiesen ist. Gliederungen und Wahlpflichtaufgaben lassen sich nur leer löschen (erst die Aufgaben darin löschen). Einzelne Aufgaben lassen sich auch in einem zugewiesenen Lernpfad löschen und verschwinden dann sofort bei den Lernenden, auch wenn schon Lernergebnisse abgegeben wurden – deshalb verlangt das Werkzeug dort zusätzlich auch_wenn_zugewiesen=true.

scobees_markdown_vorschauA

Wandelt Markdown testweise in das Serlo-Format um (ohne etwas zu speichern) und zeigt die erzeugten Bausteine.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.8/5.0

Scored across 23 tools

Disambiguation4/5

Each tool targets a distinct resource+action (Lernpfad, Gliederung, Wahlpflicht, Aufgabe, Material, Bild), and the descriptions explicitly disambiguate the tricky pairs (update_aufgabe vs. patch_arbeitsblatt, create_aufgabe vs. copy_aufgabe vs. move). Boundaries between move and the update tools, or between create_aufgabe/direct-in-Lernpfad and create_gliederung, take a careful read but are resolvable from the descriptions.

Naming Consistency4/5

All tools share the scobees_ prefix and a snake_case verb_noun pattern (list_lernpfade, get_aufgabe, create_gliederung, upload_material, delete_material). A few tools drop the noun and use bare generic verbs (me, move, delete, markdown_vorschau), and noun language mixes German and English, which is a minor inconsistency but still readable.

Tool Count4/5

23 tools is on the high side, but the domain (course authoring with four hierarchical entity types plus assets and metadata lookups) justifies most of them, since each resource gets its own create/update/delete coverage. A few generic tools (delete, move) consolidate what would otherwise be more tools, so the set is reasonably scoped.

Completeness4/5

The lifecycle is largely covered: create/update/delete for Lernpfad, Gliederung, Wahlpflicht and Aufgabe, plus copy, move, material upload/delete and read helpers (get_lernpfad returns the full tree). Minor gaps exist — there is no standalone get_wahlpflicht or get_gliederung detail read, no search, and Wahlpflicht copying/assignment is only handled via documented workarounds or the web UI.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues