# 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: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Kurz gesagt

| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
| [`list_courses`](#list-courses) | Kurse der Community | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_course`](#get-course) | Ein Kurs mit Modulen und Lektionen | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_course`](#create-course) | Bereich, Kurs, Module, Lektionen und Produkt auf einmal | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_course`](#update-course) | Bearbeitet Titel, Niveau, Status und Titelbild eines Kurses | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_course_module`](#create-course-module) | Fügt einem Kurs ein Modul hinzu | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`create_lesson`](#create-lesson) | Fügt einem Modul eine Lektion hinzu | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_course_module`](#update-course-module) | Benennt ein Modul um oder ändert seine Position | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_lesson`](#update-lesson) | Ändert eine Lektion oder verschiebt sie in ein anderes Modul | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_course_module`](#delete-course-module) | Löscht ein Modul samt Lektionen | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_lesson`](#delete-lesson) | Löscht eine Lektion | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`delete_course`](#delete-course) | Löscht einen Kurs | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`enroll_in_course`](#enroll-in-course) | Schreibt dich in einen veröffentlichten Kurs ein | Mitglied (nicht Finanzen) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`complete_lesson`](#complete-lesson) | Erfasst deinen Fortschritt in einer Lektion | Mitglied (nicht Finanzen) | <span class="tool-kind tool-kind-write">Ändert</span> |

## `list_courses`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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](/mcp/ferramentas-comunidade#symbole) |
| `image_url` | Link | Nein | Das Titelbild des Kurses. Siehe [Bilder](/mcp/ferramentas#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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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-course-module), [`update_lesson`](#update-lesson) und den Lösch-Tools.

## `create_course_module`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`](#update-course-module).

## `create_lesson`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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`

<span class="tool-kind tool-kind-write">Ändert</span>

**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.“*

## Verwandte Artikel

- [Werkzeuge](/mcp/ferramentas)
- [Rezepte](/mcp/receitas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)