# 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](/espacos/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: <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 |
|---|---|---|---|
| [`get_downloads_space_settings`](#get-downloads-space-settings) | Modus, Freigabe und Kategorien eines Downloads-Bereichs | Alle, die den Bereich sehen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`update_downloads_space_settings`](#update-downloads-space-settings) | Ändert Modus, Freigabe und die Liste der Kategorien | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`list_download_items`](#list-download-items) | Die Einträge des Bereichs, mit Filtern | Alle, die den Bereich sehen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_download_item`](#get-download-item) | Ein Eintrag, mit Dateien und Produkt | Alle, die den Bereich sehen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_download_item`](#create-download-item) | Legt einen Eintrag (Entwurf) mit seinem Produkt an | Wen der Bereich anlegen lässt | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_download_item`](#update-download-item) | Bearbeitet den Eintrag, den Stempel, das Titelbild und veröffentlicht | Autor oder Team | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`delete_download_item`](#delete-download-item) | Löscht den Eintrag und die Dateien | Autor oder Team | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`upload_download_file`](#upload-download-file) | Lädt eine Datei hoch (oder ersetzt sie), per Link oder Base64 | Autor oder Team | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`remove_download_file`](#remove-download-file) | Entfernt eine Datei | Autor oder Team | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`reorder_download_files`](#reorder-download-files) | Ändert die Reihenfolge der Dateien | Autor oder Team | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`get_download_url`](#get-download-url) | Der 5-Minuten-Link einer Datei | Alle mit Zugang | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_my_downloads`](#list-my-downloads) | Was du herunterladen kannst | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_download_stats`](#get-download-stats) | Wie viele Downloads jede Datei hatte | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |

Der Bereich wird mit [`create_space`](/mcp/ferramentas-comunidade#create-space) und `module: "downloads"` angelegt. Wer hochladen darf, bestimmt **Wer posten darf** des Bereichs ([`update_space_access`](/mcp/ferramentas-comunidade#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](/mcp/ferramentas-vendas)).

## `get_downloads_space_settings`

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

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

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

**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`](#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`

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

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

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

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

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

**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`](#upload-download-file) hoch, lege den Preis mit `update_product` fest und veröffentliche mit [`update_download_item`](#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](/espacos/downloads#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](/mcp/ferramentas#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`

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

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

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

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

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

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

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

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

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

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

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

**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](/espacos/downloads#pdfs-stempeln) 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`](/mcp/ferramentas-cursos#join-waitlist) vor.

## `list_my_downloads`

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

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

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

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

## Verwandte Artikel

- [Downloads](/espacos/downloads)
- [Werkzeuge](/mcp/ferramentas)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)