# Strumenti · Download

> Strumenti MCP per il modulo Download: configurare lo spazio, creare elementi, caricare, sostituire, rimuovere e riordinare file, pubblicare, ottenere il link di 5 minuti, vedere i tuoi download e i contatori del team.

Il modulo [Download](/espacos/downloads) tramite l'assistente: configurare lo spazio (archivio o un solo file, categorie, approvazione), creare l'elemento, caricare i file tramite link o file, pubblicare, vedere ciò che puoi scaricare e i contatori del team.

Ogni strumento ha un'etichetta: <span class="tool-kind tool-kind-read">Solo lettura</span> non cambia nulla, <span class="tool-kind tool-kind-write">Modifica</span> crea o cambia qualcosa subito, e <span class="tool-kind tool-kind-confirm">Chiede conferma</span> agisce solo dopo il tuo sì a un riepilogo. Vedi [Denaro e conferma](/mcp/dinheiro-e-confirmacao).

## In sintesi

| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
| [`get_downloads_space_settings`](#get-downloads-space-settings) | La modalità, l'approvazione e le categorie di uno spazio Download | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`update_downloads_space_settings`](#update-downloads-space-settings) | Cambia la modalità, l'approvazione e l'elenco delle categorie | Admin | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`list_download_items`](#list-download-items) | Gli elementi dello spazio, con filtri | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_download_item`](#get-download-item) | Un elemento, con file e prodotto | Chiunque veda lo spazio | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`create_download_item`](#create-download-item) | Crea un elemento (bozza) con il suo prodotto | Chi lo spazio lascia creare | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`update_download_item`](#update-download-item) | Modifica l'elemento, il timbro, la copertina e pubblica | Autore o team | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`delete_download_item`](#delete-download-item) | Elimina l'elemento e i file | Autore o team | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`upload_download_file`](#upload-download-file) | Carica (o sostituisce) un file, tramite link o base64 | Autore o team | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`remove_download_file`](#remove-download-file) | Rimuove un file | Autore o team | <span class="tool-kind tool-kind-confirm">Chiede conferma</span> |
| [`reorder_download_files`](#reorder-download-files) | Cambia l'ordine dei file | Autore o team | <span class="tool-kind tool-kind-write">Modifica</span> |
| [`get_download_url`](#get-download-url) | Il link di 5 minuti di un file | Chiunque abbia accesso | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`list_my_downloads`](#list-my-downloads) | Ciò che puoi scaricare | Qualsiasi | <span class="tool-kind tool-kind-read">Solo lettura</span> |
| [`get_download_stats`](#get-download-stats) | Quanti download ha avuto ogni file | Moderatore o finanza | <span class="tool-kind tool-kind-read">Solo lettura</span> |

Lo spazio si crea con [`create_space`](/mcp/ferramentas-comunidade#create-space) e `module: "downloads"`. Chi può caricare è definito da **Chi può pubblicare** dello spazio ([`update_space_access`](/mcp/ferramentas-comunidade#update-space-access)): per impostazione predefinita, solo il team. Il prezzo dell'elemento si imposta nel prodotto che nasce con esso (`update_product`, `update_price`, `publish_product`; vedi [Vendite e piani](/mcp/ferramentas-vendas)).

## `get_downloads_space_settings`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Configurazione dello spazio.** La modalità (`multi`, archivio; `single`, un solo file), se gli elementi dei membri attendono l'approvazione e le categorie (id, nome e quanti elementi). *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | Lo spazio Download |

**Chiedi così:** *"Com'è configurato lo spazio Materiali?"*

## `update_downloads_space_settings`

<span class="tool-kind tool-kind-write">Modifica</span>

**Configurare lo spazio.** Cambia la modalità, l'approvazione e le categorie. Cambia solo ciò che invii. *Ruolo minimo: Admin.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | |
| `mode` | `multi` o `single` | No | `single` viene rifiutato finché ci sono 2 o più elementi o file |
| `require_approval` | vero o falso | No | Gli elementi dei membri attendono il team |
| `categories` | elenco | No | L'elenco **completo**, in ordine: una voce con `id` rinomina e riordina, senza `id` crea, ciò che manca dall'elenco viene rimosso (rifiutato finché la categoria ha elementi; il messaggio dice quanti) |

Leggi prima [`get_downloads_space_settings`](#get-downloads-space-settings), per prendere gli id.

**Chiedi così:** *"Nello spazio Materiali, crea le categorie Fogli di calcolo ed E-book e chiedi l'approvazione per ciò che inviano i membri."*

## `list_download_items`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Elementi dello spazio.** Dal più recente al più vecchio: titolo, categoria, file e stato. Il team e l'autore vedono anche bozze ed elementi in revisione. Un elemento a pagamento che la persona non ha acquistato arriva **bloccato**: mostra il prezzo e il prodotto, senza file. *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | |
| `category_id` | id | No | Filtra per categoria |
| `status` | testo | No | Lo stato dell'elemento |
| `mine` | vero o falso | No | Solo quelli che hai creato tu |
| `search` | testo | No | Cerca nel titolo |
| `page`, `limit` | numeri | No | Paginazione |

## `get_download_item`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Un elemento.** Descrizione, categoria, file (id, nome, tipo, dimensione e, per il team, quanti download), stato e il prodotto (prezzo, se è gratuito, se è esaurito e il tuo posto nella lista d'attesa). Un elemento bloccato non mostra i file. *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | Da `list_download_items` |

## `create_download_item`

<span class="tool-kind tool-kind-write">Modifica</span>

**Creare un elemento.** Crea l'elemento in **bozza**, con il suo prodotto (tipo Download, gratuito, in bozza), restituito in `product`. Poi: carica i file con [`upload_download_file`](#upload-download-file), imposta il prezzo con `update_product` e pubblica con [`update_download_item`](#update-download-item). *Ruolo: chi è consentito da Chi può pubblicare dello spazio; per impostazione predefinita, il team (il membro riceve 403).*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `space` | id o link | Sì | |
| `title` | testo | Sì | |
| `description` | Markdown | No | |
| `category_id` | id | No | Da `get_downloads_space_settings` |
| `stamp_pdf` | vero o falso | No | Timbra i PDF di chi scarica (predefinito: falso). Vedi [Timbrare i PDF](/espacos/downloads#timbrare-i-pdf) |
| `image_url` o `image_base64` (+ `image_type`) | link o file | No | La copertina: link fino a 10 MB, file fino a 5 MB. Vedi [Immagini](/mcp/ferramentas#immagini) |

In uno spazio in modalità `single`, un secondo elemento viene rifiutato (409). Gli elementi dei membri attendono l'approvazione quando lo spazio la richiede.

**Chiedi così:** *"Crea nello spazio Materiali l'elemento Foglio del flusso di cassa, nella categoria Fogli di calcolo."*

## `update_download_item`

<span class="tool-kind tool-kind-write">Modifica</span>

**Modificare e pubblicare.** Cambia titolo, descrizione, categoria, `stamp_pdf`, la copertina (`remove_cover` la toglie) e lo stato (`status`: `draft` o `published`; pubblicare richiede almeno un file). Cambia solo ciò che invii. *Ruolo: l'autore e il team.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |
| `title`, `description`, `category_id`, `status`, `stamp_pdf` | | No | Come in `create_download_item` |
| `remove_cover` | vero | No | Toglie la copertina |
| `image_url` o `image_base64` (+ `image_type`) | link o file | No | La nuova copertina |

**Chiedi così:** *"Pubblica l'elemento Foglio del flusso di cassa e attiva il timbro sui PDF."*

## `delete_download_item`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Eliminare l'elemento.** Elimina l'elemento e i file; il suo prodotto viene archiviato. Viene rifiutato (409) finché un acquisto pagato dà ancora accesso: rimborsa prima. *Ruolo: l'autore e il team.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |

**Restituisce:** alla prima chiamata, il riepilogo di ciò che verrà eliminato e il codice di conferma.

## `upload_download_file`

<span class="tool-kind tool-kind-write">Modifica</span>

**Caricare un file.** Aggiunge un file all'elemento, tramite **link** pubblico o tramite **base64**. Accetta immagini (PNG, JPG, WEBP, GIF), fogli di calcolo (XLS, XLSX, ODS, CSV), PDF, documenti (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) e ZIP, mai eseguibili; il nome deve mantenere l'estensione e il contenuto deve corrispondere al tipo (controllato dai primi byte), come nel browser. *Ruolo: l'autore e il team.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |
| `file_url` | indirizzo web | No | Il link del file. Fino a **200 MB** |
| `file_base64` | testo | No | Il file in base64, fino a circa **7 MB**; oltre, usa il link |
| `mime_type` | testo | No | Es.: `application/pdf`; facoltativo quando il link o il nome lo indicano |
| `name` | testo | No | Il nome con l'estensione. Predefinito: quello del link |
| `replace_file_id` | id | No | Il file che questo sostituisce |

In modalità `single`, l'elemento conserva un solo file: per caricarlo di nuovo, passa `replace_file_id`. L'avviso di uso dello spazio di archiviazione avvisa soltanto.

**Chiedi così:** *"Carica https://esempio.memberfy.net/flusso.xlsx nell'elemento Foglio del flusso di cassa."*

## `remove_download_file`

<span class="tool-kind tool-kind-confirm">Chiede conferma</span>

**Rimuovere un file.** Il file viene eliminato e lo spazio torna disponibile. Se era l'ultimo di un elemento pubblicato, l'elemento torna in bozza. *Ruolo: l'autore e il team.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |
| `file_id` | id | Sì | Da `get_download_item` |

## `reorder_download_files`

<span class="tool-kind tool-kind-write">Modifica</span>

**Riordinare i file.** `file_ids` è l'elenco completo, dal primo all'ultimo. *Ruolo: l'autore e il team.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |
| `file_ids` | elenco di id | Sì | Il nuovo ordine |

## `get_download_url`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Il link di un file.** Un link valido **5 minuti**. Chiedilo solo quando la persona vuole davvero il file; non conservarlo né inoltrarlo. Il team e l'autore lo ricevono sempre; gli altri devono avere accesso (elemento gratis, acquisto attivo o piano che include il prodotto; averlo scaricato prima non basta). *Ruolo minimo: chiunque veda lo spazio.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `file_id` | id | Sì | Da `get_download_item` |

**Restituisce:** il link e `stamped`: `true` quando è la copia con il [timbro](/espacos/downloads#timbrare-i-pdf) (solo per chi non è del team), `false` quando è l'originale. Ogni download di un membro entra nei contatori.

Un elemento a pagamento che la persona non ha risponde `403`, con il prezzo (l'acquisto si fa nell'app); un elemento esaurito risponde `409`, e l'assistente suggerisce [`join_waitlist`](/mcp/ferramentas-cursos#join-waitlist).

## `list_my_downloads`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**I tuoi download.** Gli elementi che puoi aprire, con l'origine dell'accesso (`purchase`, `plan`, `open`, `team`), il tuo ultimo download e, per un acquisto, la data e la fine dell'accesso. *Ruolo minimo: qualsiasi.*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `page`, `limit` | numeri | No | Paginazione |

## `get_download_stats`

<span class="tool-kind tool-kind-read">Solo lettura</span>

**Contatori dell'elemento.** Quante volte è stato scaricato ogni file, in totale e da persone diverse. Solo numeri, mai chi. *Ruolo minimo: moderatore (o finanza).*

| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `item_id` | id | Sì | |

## Correlati

- [Download](/espacos/downloads)
- [Strumenti](/mcp/ferramentas)
- [Denaro e conferma](/mcp/dinheiro-e-confirmacao)