Zum Hauptinhalt springen
Dokumentation

Dateien hochladen

Dateien reisen per URL, nicht durch den Chat

Assistenten können Dateiinhalte nicht durch ein Gespräch schicken. Die Argumente von MCP-Werkzeugen sind JSON, das das Modell selbst schreibt — eine Binärdatei müsste also base64-kodiert als generierter Text reisen: Jenseits einiger Dutzend Kilobyte ist das unmöglich, und Clients wie Claude Desktop hängen Gesprächsdateien ohnehin nie an Werkzeugaufrufe an.

Dateien gelangen deshalb per URL nach Moodle: Sie geben dem Assistenten einen öffentlichen HTTPS-Link, und Ihr eigener Moodle-Server lädt die Datei direkt herunter (bis 512 MiB, mit Moodles SSRF-Schutz). Die Datei läuft nie durch den Chat.

Eine Datei zu einem Kurs hinzufügen

  • local_mcpconnector_create_resource: fügt eine beliebige Datei (PDF, DOCX, Bild, Video …) als Datei-Ressource zu einem Kurs hinzu.
  • local_mcpconnector_create_scorm: erstellt aus einem Paket-ZIP eine SCORM-Aktivität.

Beide Werkzeuge sind seit Version 1.0 im Plugin enthalten.

Fragen Sie in normaler Sprache — „füge dieses PDF dem Biologiekurs als Ressource hinzu: https://…" — und der Assistent wählt das passende Werkzeug.

Der Link muss die Datei selbst liefern, keine Webseite darum herum:

QuelleVerwenden Sie
Google Drivehttps://drive.google.com/uc?export=download&id=DATEI_ID — der normale Freigabelink liefert eine Seite, und sehr große Dateien landen auf einer Bestätigungsseite, die der Server nicht anklicken kann
DropboxHängen Sie ?dl=1 an den Freigabelink
GitHubNutzen Sie die raw.githubusercontent.com-URL

Jede HTTPS-URL, die Ihr Moodle erreichen kann, funktioniert — auch Ihr eigener Webserver.

Dateien auf dem Rechner des Assistenten

Liegt die Datei dort, wo der Assistent läuft — ein eben gebautes SCORM, ein erzeugtes PDF —, gibt es keine öffentliche URL, die Sie angeben könnten. Nutzen Sie moodle_request_file_upload:

  1. Das Werkzeug liefert eine temporäre Upload-URL.
  2. Der Assistent lädt die Datei mit dem zurückgegebenen curl-Befehl hoch.
  3. Er übergibt die erhaltene fileUrl an create_resource oder create_scorm.

Beide URLs laufen ab, und die Datei wird nach 30 Minuten gelöscht. Es ist ein Transferkanal, kein Speicher — bewahren Sie dort nichts auf.

Wenn der Upload klemmt

  • „Datei konnte nicht heruntergeladen werden": die URL liefert HTML statt der Datei oder ist nicht öffentlich erreichbar. Testen Sie sie mit curl -IL url von außerhalb Ihres Netzes.
  • Das Werkzeug fehlt: Ihr Plugin ist veraltet. Aktualisieren Sie es in Moodle.
  • Der Assistent sagt, er könne keine Dateien hochladen: er hat das Werkzeug nicht gefunden. Bitten Sie ihn, seine Moodle-Werkzeuge nach „upload" zu durchsuchen; das löst es meist.