scobees-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SCOBEES_PASSWORD | No | Your scobees password for password-based login. | |
| SCOBEES_USERNAME | No | Your scobees username for password-based login. | |
| SCOBEES_REFRESH_TOKEN | No | A 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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 |
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
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.
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.
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.
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.