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 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: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
get_downloads_space_settings | La modalità, l'approvazione e le categorie di uno spazio Download | Chiunque veda lo spazio | Solo lettura |
update_downloads_space_settings | Cambia la modalità, l'approvazione e l'elenco delle categorie | Admin | Modifica |
list_download_items | Gli elementi dello spazio, con filtri | Chiunque veda lo spazio | Solo lettura |
get_download_item | Un elemento, con file e prodotto | Chiunque veda lo spazio | Solo lettura |
create_download_item | Crea un elemento (bozza) con il suo prodotto | Chi lo spazio lascia creare | Modifica |
update_download_item | Modifica l'elemento, il timbro, la copertina e pubblica | Autore o team | Modifica |
delete_download_item | Elimina l'elemento e i file | Autore o team | Chiede conferma |
upload_download_file | Carica (o sostituisce) un file, tramite link o base64 | Autore o team | Modifica |
remove_download_file | Rimuove un file | Autore o team | Chiede conferma |
reorder_download_files | Cambia l'ordine dei file | Autore o team | Modifica |
get_download_url | Il link di 5 minuti di un file | Chiunque abbia accesso | Solo lettura |
list_my_downloads | Ciò che puoi scaricare | Qualsiasi | Solo lettura |
get_download_stats | Quanti download ha avuto ogni file | Moderatore o finanza | Solo lettura |
Lo spazio si crea con create_space e module: "downloads". Chi può caricare è definito da Chi può pubblicare dello spazio (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).
get_downloads_space_settings
Solo lettura
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
Modifica
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, 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
Solo lettura
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
Solo lettura
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
Modifica
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, imposta il prezzo con update_product e pubblica con 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 |
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 |
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
Modifica
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
Chiede conferma
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
Modifica
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
Chiede conferma
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
Modifica
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
Solo lettura
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 (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.
list_my_downloads
Solo lettura
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
Solo lettura
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ì |