Werkzeuge · Kurse
MCP-Tools für Kurse: Kurse mit Modulen und Lektionen auflisten und ansehen, einen ganzen Kurs mit dem Verkaufsprodukt anlegen, den Kurs bearbeiten und löschen, Module und Lektionen ergänzen, bearbeiten, verschieben und löschen, und die Seite der Lernenden: Einschreibung und Fortschritt.
Kurse aufbauen und pflegen: ein ganzer Kurs in einem Aufruf (Bereich, Module, Lektionen und das Verkaufsprodukt), Titelbild und Status, und danach die Module und Lektionen: ergänzen, umbenennen, die Reihenfolge ändern, eine Lektion in ein anderes Modul verschieben und löschen. Lernende schreiben sich im Gespräch ein und halten ihren Fortschritt fest. Den Inhalt jeder Lektion (Text, Video) trägst du weiterhin im Dashboard ein.
Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
list_courses | Kurse der Community | Alle | Nur lesen |
get_course | Ein Kurs mit Modulen und Lektionen | Alle | Nur lesen |
create_course | Bereich, Kurs, Module, Lektionen und Produkt auf einmal | Administrator | Ändert |
update_course | Bearbeitet Titel, Niveau, Status und Titelbild eines Kurses | Administrator | Ändert |
create_course_module | Fügt einem Kurs ein Modul hinzu | Administrator | Ändert |
create_lesson | Fügt einem Modul eine Lektion hinzu | Administrator | Ändert |
update_course_module | Benennt ein Modul um oder ändert seine Position | Administrator | Ändert |
update_lesson | Ändert eine Lektion oder verschiebt sie in ein anderes Modul | Administrator | Ändert |
delete_course_module | Löscht ein Modul samt Lektionen | Administrator | Mit Bestätigung |
delete_lesson | Löscht eine Lektion | Administrator | Mit Bestätigung |
delete_course | Löscht einen Kurs | Administrator | Mit Bestätigung |
enroll_in_course | Schreibt dich in einen veröffentlichten Kurs ein | Mitglied (nicht Finanzen) | Ändert |
complete_lesson | Erfasst deinen Fortschritt in einer Lektion | Mitglied (nicht Finanzen) | Ändert |
list_courses
Nur lesen
Kurse auflisten. Die Kurse der Community. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space_id | ID | Nein | Nur die Kurse eines Kurs-Bereichs |
Liefert: die Kurse mit ID, Slug, Titel, Niveau und Status.
Frag so: „Welche Kurse gibt es schon?"
get_course
Nur lesen
Kurs mit Modulen und Lektionen ansehen. Ein Kurs mit der vollständigen Struktur. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course | Text | Ja | Die ID oder der Slug des Kurses |
Liefert: den Kurs, die Module (mit der ID, die create_lesson braucht) und die Lektionen jedes Moduls.
Frag so: „Zeig mir die Struktur des Kurses Excel von Null."
create_course
Ändert
Vollständigen Kurs anlegen. Kurs-Bereich → Kurs → Module → Lektionen → (optional) das Produkt, das den Bereich freischaltet. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
title | Text, bis 255 | Ja | Der Titel des Kurses |
description | einfacher Text | Nein | Ohne Formatierung: Markdown-Zeichen werden entfernt |
level | beginner, intermediate, advanced | Nein | Standard: beginner |
space_id | ID | Nein | Ein bestehender Kurs-Bereich |
section_id | ID | Nein | Wo der Bereich angelegt wird, wenn space_id fehlt |
space_title | Text | Nein | Standard: der Titel des Kurses |
icon | eines der Symbole aus der Liste | Nein | Das Symbol des angelegten Bereichs. Siehe Symbole |
image_url | Link | Nein | Das Titelbild des Kurses. Siehe Bilder |
modules | Liste, bis 30 | Nein | Jedes mit title (Pflicht) und lessons |
sale | Objekt | Nein | Das Produkt, das den Kurs verkauft (siehe unten) |
idempotency_key | Text, bis 100 | Nein |
Jedes Modul hat title und lessons, eine Liste mit bis zu 50, und jede Lektion hat title (Pflicht), type (text, video, link, image; Standard text) und duration (z. B. 12 min).
Der Verkauf (und das Ticket bei create_event):
| Feld | Typ | Beschreibung |
|---|---|---|
price | Zahl, in Reais | Pflicht |
title | Text, 3 bis 255 | Standard: der Titel des Kurses (oder Ingresso — Titel des Events) |
type | ONE_TIME, INSTALLMENT, SUBSCRIPTION | Standard: ONE_TIME (Einzelprodukt) |
interval | MONTHLY, YEARLY | Nur bei SUBSCRIPTION |
max_installments | 1 bis 12 | Bis zu wie vielen Raten per Karte |
stock | Zahl | Verkaufsmenge |
direct_link | ja oder nein | Per Direktlink verkaufbar |
publish | ja oder nein | Sofort in den Verkauf. Standard: Entwurf |
Liefert: den Bereich (und ob er jetzt angelegt wurde), den Kurs (ID, Titel, Slug, Status), die Module mit Lektionen und das Produkt (ID, Titel, Preis, Status), falls vorhanden.
Frag so: „Lege den Kurs Excel von Null im Kurs-Bereich an, mit den Modulen Grundlagen, Formeln und Pivot-Tabellen, je 3 Video-Lektionen, und einem Produkt für R$ 297 in bis zu 10 Raten, als Entwurf."
Hinweise: Die Lektionen speichern Titel, Typ und Dauer; der Inhalt kommt über das Dashboard. Das Produkt schaltet den Kurs-Bereich für Käufer frei.
update_course
Ändert
Kurs bearbeiten. Ändert Titel, Beschreibung, Niveau, Status (draft, published, archived) und das Titelbild. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course | ID, Slug oder Link | Ja | |
title, description | Text | Nein | |
level | beginner, intermediate, advanced | Nein | |
status | draft, published, archived | Nein | |
image_url oder image_base64 | Link oder Datei | Nein | Das neue Titelbild |
Frag so: „Veröffentliche den Kurs Excel do Zero und tausch das Titelbild gegen dieses aus."
Hinweise: Module und Lektionen änderst du mit update_course_module, update_lesson und den Lösch-Tools.
create_course_module
Ändert
Modul zu einem Kurs hinzufügen. Fügt am Ende eines bestehenden Kurses ein Modul hinzu. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course_id | ID | Ja | Aus list_courses oder create_course |
title | Text | Ja |
Liefert: das angelegte Modul mit der ID, die create_lesson braucht.
Frag so: „Füge dem Kurs Excel von Null das Modul Diagramme hinzu."
Hinweise: Um es später umzubenennen oder seine Position zu ändern: update_course_module.
create_lesson
Ändert
Lektion zu einem Modul hinzufügen. Fügt am Ende eines Moduls eine Lektion hinzu. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
module_id | ID | Ja | Aus get_course |
title | Text | Ja | |
type | text, video, link, image | Nein | Standard: text |
duration | Text | Nein | Z. B. 12 min |
Liefert: die angelegte Lektion.
Frag so: „Lege im Modul Diagramme die Lektionen Liniendiagramm (8 min) und Kreisdiagramm (6 min) an, beide als Video."
Hinweise: Die Lektion speichert Titel, Typ und Dauer. Der Inhalt (Text, Video) wird über MCP noch nicht gespeichert: Er kommt über das Dashboard.
update_course_module
Ändert
Kursmodul bearbeiten. Benennt ein Modul um oder ändert seine Position. Nur, was gesendet wird, ändert sich. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
module_id | ID | Ja | Aus get_course |
title | Text, bis 255 | Nein | |
order | Zahl, ab 0 | Nein | Die Position im Kurs |
Frag so: „Benenne das Modul Formeln in Wichtige Formeln um und setz es an die zweite Stelle.“
update_lesson
Ändert
Lektion bearbeiten. Ändert Titel, Typ, Dauer oder Position einer Lektion oder verschiebt sie in ein anderes Modul desselben Kurses. Nur, was gesendet wird, ändert sich. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
lesson_id | ID | Ja | Aus get_course |
title | Text, bis 255 | Nein | |
type | text, video, link, image | Nein | |
duration | Text | Nein | Z. B.: 12 min |
order | Zahl, ab 0 | Nein | Die Position im Modul |
module_id | ID | Nein | Verschiebt die Lektion in dieses Modul (desselben Kurses). Ohne order landet sie am Ende |
Frag so: „Verschieb die Lektion Kreisdiagramm als letzte Lektion in das Modul Grundlagen.“
Hinweise: Den Inhalt der Lektion trägst du weiterhin im Dashboard ein.
delete_course_module
Mit Bestätigung
Kursmodul löschen. Löscht ein Modul und alle seine Lektionen. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
module_id | ID | Ja | Aus get_course |
course | ID, Slug oder Link | Nein | Der Kurs, damit die Zusammenfassung den Namen des Moduls und der Lektionen zeigt |
Hinweise: Der Fortschritt aller, die schon zugesehen haben, bleibt erhalten.
delete_lesson
Mit Bestätigung
Lektion löschen. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
lesson_id | ID | Ja | Aus get_course |
course | ID, Slug oder Link | Nein | Der Kurs, damit die Zusammenfassung den Namen der Lektion zeigt |
Hinweise: Der Fortschritt aller, die schon zugesehen haben, bleibt erhalten.
delete_course
Mit Bestätigung
Kurs löschen. Der Kurs wird archiviert und verschwindet aus dem Feed. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course | ID, Slug oder Link | Ja |
Liefert: beim ersten Aufruf den Titel, wie viele Module und Einschreibungen der Kurs hat, und den Bestätigungscode.
enroll_in_course
Ändert
In Kurs einschreiben. Schreibt dich in einen veröffentlichten Kurs ein. Rolle: Eigentümer, Administrator, Moderator oder Mitglied.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course | ID, Slug oder Link | Ja |
Frag so: „Schreib mich in den Kurs Excel von Null ein.“
complete_lesson
Ändert
Lektionsfortschritt erfassen. Markiert eine Lektion als abgeschlossen oder hält einen Prozentsatz fest, in einem Kurs, in den du eingeschrieben bist. Rolle: Eigentümer, Administrator, Moderator oder Mitglied.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
course | ID, Slug oder Link | Ja | |
lesson_id | ID | Ja | Aus get_course |
completed | ja oder nein | Nein | Standard: ja |
progress_percent | 0 bis 100 | Nein |
Frag so: „Markier die Lektion Grundlegende Formeln als gesehen.“