Werkzeuge · Downloads
MCP-Tools für das Modul Downloads: den Bereich konfigurieren, Einträge anlegen, Dateien hochladen, ersetzen, entfernen und neu ordnen, veröffentlichen, den 5-Minuten-Link holen, deine Downloads und die Zähler des Teams sehen.
Das Modul Downloads über den Assistenten: den Bereich konfigurieren (Archiv oder nur eine Datei, Kategorien, Freigabe), den Eintrag anlegen, die Dateien per Link oder Datei hochladen, veröffentlichen, sehen, was du herunterladen kannst, und die Zähler des Teams.
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 |
|---|---|---|---|
get_downloads_space_settings | Modus, Freigabe und Kategorien eines Downloads-Bereichs | Alle, die den Bereich sehen | Nur lesen |
update_downloads_space_settings | Ändert Modus, Freigabe und die Liste der Kategorien | Administrator | Ändert |
list_download_items | Die Einträge des Bereichs, mit Filtern | Alle, die den Bereich sehen | Nur lesen |
get_download_item | Ein Eintrag, mit Dateien und Produkt | Alle, die den Bereich sehen | Nur lesen |
create_download_item | Legt einen Eintrag (Entwurf) mit seinem Produkt an | Wen der Bereich anlegen lässt | Ändert |
update_download_item | Bearbeitet den Eintrag, den Stempel, das Titelbild und veröffentlicht | Autor oder Team | Ändert |
delete_download_item | Löscht den Eintrag und die Dateien | Autor oder Team | Mit Bestätigung |
upload_download_file | Lädt eine Datei hoch (oder ersetzt sie), per Link oder Base64 | Autor oder Team | Ändert |
remove_download_file | Entfernt eine Datei | Autor oder Team | Mit Bestätigung |
reorder_download_files | Ändert die Reihenfolge der Dateien | Autor oder Team | Ändert |
get_download_url | Der 5-Minuten-Link einer Datei | Alle mit Zugang | Nur lesen |
list_my_downloads | Was du herunterladen kannst | Alle | Nur lesen |
get_download_stats | Wie viele Downloads jede Datei hatte | Moderator oder Finanzen | Nur lesen |
Der Bereich wird mit create_space und module: "downloads" angelegt. Wer hochladen darf, bestimmt Wer posten darf des Bereichs (update_space_access): standardmäßig nur das Team. Der Preis des Eintrags wird im Produkt festgelegt, das mit ihm entsteht (update_product, update_price, publish_product; siehe Verkauf und Pläne).
get_downloads_space_settings
Nur lesen
Konfiguration des Bereichs. Der Modus (multi, Archiv; single, nur eine Datei), ob die Einträge der Mitglieder auf Freigabe warten, und die Kategorien (ID, Name und wie viele Einträge). Mindestrolle: alle, die den Bereich sehen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Downloads-Bereich |
Frag so: „Wie ist der Bereich Materialien konfiguriert?“
update_downloads_space_settings
Ändert
Den Bereich konfigurieren. Ändert Modus, Freigabe und Kategorien. Nur, was du sendest, ändert sich. Mindestrolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
mode | multi oder single | Nein | single wird abgelehnt, solange es 2 oder mehr Einträge oder Dateien gibt |
require_approval | ja oder nein | Nein | Die Einträge der Mitglieder warten auf das Team |
categories | Liste | Nein | Die vollständige Liste, in Reihenfolge: Ein Element mit id benennt um und ordnet neu, ohne id legt es an, was in der Liste fehlt, wird entfernt (abgelehnt, solange die Kategorie Einträge hat; die Meldung sagt, wie viele) |
Lies vorher get_downloads_space_settings, um die IDs zu holen.
Frag so: „Leg im Bereich Materialien die Kategorien Tabellen und E-Books an und verlange eine Freigabe für das, was Mitglieder hochladen.“
list_download_items
Nur lesen
Einträge des Bereichs. Vom neuesten zum ältesten: Titel, Kategorie, Dateien und Status. Das Team und die Autorin oder der Autor sehen auch Entwürfe und Einträge in Prüfung. Ein kostenpflichtiger Eintrag, den die Person nicht gekauft hat, kommt gesperrt: Er zeigt Preis und Produkt, ohne Dateien. Mindestrolle: alle, die den Bereich sehen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
category_id | ID | Nein | Filtert nach Kategorie |
status | Text | Nein | Der Status des Eintrags |
mine | ja oder nein | Nein | Nur die, die du angelegt hast |
search | Text | Nein | Sucht im Titel |
page, limit | Zahlen | Nein | Seitenweise Abfrage |
get_download_item
Nur lesen
Ein Eintrag. Beschreibung, Kategorie, Dateien (ID, Name, Typ, Größe und, für das Team, wie viele Downloads), Status und das Produkt (Preis, ob kostenlos, ob ausverkauft und dein Platz auf der Warteliste). Ein gesperrter Eintrag zeigt keine Dateien. Mindestrolle: alle, die den Bereich sehen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja | Aus list_download_items |
create_download_item
Ändert
Einen Eintrag anlegen. Legt den Eintrag als Entwurf an, mit seinem Produkt (Art Download, kostenlos, als Entwurf), geliefert in product. Danach: Lade die Dateien mit upload_download_file hoch, lege den Preis mit update_product fest und veröffentliche mit update_download_item. Rolle: wen „Wer posten darf“ des Bereichs zulässt; standardmäßig das Team (ein Mitglied erhält 403).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | |
title | Text | Ja | |
description | Markdown | Nein | |
category_id | ID | Nein | Aus get_downloads_space_settings |
stamp_pdf | ja oder nein | Nein | Stempelt die PDFs aller, die herunterladen (Standard: nein). Siehe PDFs stempeln |
image_url oder image_base64 (+ image_type) | Link oder Datei | Nein | Das Titelbild: Link bis 10 MB, Datei bis 5 MB. Siehe Bilder |
In einem Bereich im Modus single wird ein zweiter Eintrag abgelehnt (409). Einträge von Mitgliedern warten auf Freigabe, wenn der Bereich das verlangt.
Frag so: „Leg im Bereich Materialien den Eintrag Cashflow-Tabelle in der Kategorie Tabellen an.“
update_download_item
Ändert
Bearbeiten und veröffentlichen. Ändert Titel, Beschreibung, Kategorie, stamp_pdf, das Titelbild (remove_cover entfernt es) und den Status (status: draft oder published; veröffentlichen verlangt mindestens eine Datei). Nur, was du sendest, ändert sich. Rolle: die Autorin oder der Autor und das Team.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja | |
title, description, category_id, status, stamp_pdf | Nein | Wie bei create_download_item | |
remove_cover | ja | Nein | Entfernt das Titelbild |
image_url oder image_base64 (+ image_type) | Link oder Datei | Nein | Das neue Titelbild |
Frag so: „Veröffentliche den Eintrag Cashflow-Tabelle und schalte den Stempel für die PDFs ein.“
delete_download_item
Mit Bestätigung
Den Eintrag löschen. Löscht den Eintrag und die Dateien; sein Produkt wird archiviert. Wird abgelehnt (409), solange ein bezahlter Kauf noch Zugang gibt: Erstatte vorher. Rolle: die Autorin oder der Autor und das Team.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja |
Liefert: beim ersten Aufruf die Zusammenfassung dessen, was gelöscht wird, und den Bestätigungscode.
upload_download_file
Ändert
Eine Datei hochladen. Fügt dem Eintrag eine Datei hinzu, per öffentlichem Link oder per Base64. Akzeptiert Bilder (PNG, JPG, WEBP, GIF), Tabellen (XLS, XLSX, ODS, CSV), PDF, Dokumente (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) und ZIP, nie ausführbare Dateien; der Name muss die Endung behalten, und der Inhalt muss zum Typ passen (geprüft anhand der ersten Bytes), wie im Browser. Rolle: die Autorin oder der Autor und das Team.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja | |
file_url | Webadresse | Nein | Der Link zur Datei. Bis zu 200 MB |
file_base64 | Text | Nein | Die Datei in Base64, bis etwa 7 MB; darüber nutze den Link |
mime_type | Text | Nein | Z. B. application/pdf; optional, wenn Link oder Name es verraten |
name | Text | Nein | Der Name mit Endung. Standard: der aus dem Link |
replace_file_id | ID | Nein | Die Datei, die diese ersetzt |
Im Modus single enthält der Eintrag nur eine Datei: Um erneut hochzuladen, übergib replace_file_id. Der Hinweis zur Speichernutzung warnt nur.
Frag so: „Lade https://exemplo.memberfy.net/fluxo.xlsx in den Eintrag Cashflow-Tabelle hoch.“
remove_download_file
Mit Bestätigung
Eine Datei entfernen. Die Datei wird gelöscht, und der Speicherplatz wird frei. War es die letzte eines veröffentlichten Eintrags, wird der Eintrag wieder zum Entwurf. Rolle: die Autorin oder der Autor und das Team.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja | |
file_id | ID | Ja | Aus get_download_item |
reorder_download_files
Ändert
Die Dateien neu ordnen. file_ids ist die vollständige Liste, von der ersten bis zur letzten. Rolle: die Autorin oder der Autor und das Team.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja | |
file_ids | Liste von IDs | Ja | Die neue Reihenfolge |
get_download_url
Nur lesen
Der Link zu einer Datei. Ein Link, der 5 Minuten gilt. Fordere ihn nur an, wenn die Person die Datei wirklich will; speichere ihn nicht und gib ihn nicht weiter. Das Team und die Autorin oder der Autor erhalten ihn immer; alle anderen brauchen Zugang (kostenloser Eintrag, aktiver Kauf oder ein Plan, der das Produkt enthält; früher heruntergeladen zu haben reicht nicht). Mindestrolle: alle, die den Bereich sehen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
file_id | ID | Ja | Aus get_download_item |
Liefert: den Link und stamped: true, wenn es die Kopie mit dem Stempel ist (nur für alle außerhalb des Teams), false, wenn es das Original ist. Jeder Download eines Mitglieds fließt in die Zähler ein.
Ein kostenpflichtiger Eintrag, den die Person nicht hat, antwortet 403, mit dem Preis (gekauft wird in der App); ein ausverkaufter Eintrag antwortet 409, und der Assistent schlägt join_waitlist vor.
list_my_downloads
Nur lesen
Deine Downloads. Die Einträge, die du öffnen kannst, mit der Herkunft des Zugangs (purchase, plan, open, team), deinem letzten Download und, bei einem Kauf, dem Datum und dem Ende des Zugangs. Mindestrolle: alle.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
page, limit | Zahlen | Nein | Seitenweise Abfrage |
get_download_stats
Nur lesen
Zähler des Eintrags. Wie oft jede Datei heruntergeladen wurde, insgesamt und nach verschiedenen Personen. Nur Zahlen, nie wer. Mindestrolle: Moderator (oder Finanzen).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
item_id | ID | Ja |