Vai al contenuto

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

StrumentoCosa faRuolo minimoTipo
get_downloads_space_settingsLa modalità, l'approvazione e le categorie di uno spazio DownloadChiunque veda lo spazioSolo lettura
update_downloads_space_settingsCambia la modalità, l'approvazione e l'elenco delle categorieAdminModifica
list_download_itemsGli elementi dello spazio, con filtriChiunque veda lo spazioSolo lettura
get_download_itemUn elemento, con file e prodottoChiunque veda lo spazioSolo lettura
create_download_itemCrea un elemento (bozza) con il suo prodottoChi lo spazio lascia creareModifica
update_download_itemModifica l'elemento, il timbro, la copertina e pubblicaAutore o teamModifica
delete_download_itemElimina l'elemento e i fileAutore o teamChiede conferma
upload_download_fileCarica (o sostituisce) un file, tramite link o base64Autore o teamModifica
remove_download_fileRimuove un fileAutore o teamChiede conferma
reorder_download_filesCambia l'ordine dei fileAutore o teamModifica
get_download_urlIl link di 5 minuti di un fileChiunque abbia accessoSolo lettura
list_my_downloadsCiò che puoi scaricareQualsiasiSolo lettura
get_download_statsQuanti download ha avuto ogni fileModeratore o finanzaSolo 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.

ParametroTipoObbligatorioDescrizione
spaceid o linkSì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.

ParametroTipoObbligatorioDescrizione
spaceid o linkSì
modemulti o singleNosingle viene rifiutato finché ci sono 2 o più elementi o file
require_approvalvero o falsoNoGli elementi dei membri attendono il team
categorieselencoNoL'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.

ParametroTipoObbligatorioDescrizione
spaceid o linkSì
category_ididNoFiltra per categoria
statustestoNoLo stato dell'elemento
minevero o falsoNoSolo quelli che hai creato tu
searchtestoNoCerca nel titolo
page, limitnumeriNoPaginazione

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.

ParametroTipoObbligatorioDescrizione
item_ididSì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).

ParametroTipoObbligatorioDescrizione
spaceid o linkSì
titletestoSì
descriptionMarkdownNo
category_ididNoDa get_downloads_space_settings
stamp_pdfvero o falsoNoTimbra i PDF di chi scarica (predefinito: falso). Vedi Timbrare i PDF
image_url o image_base64 (+ image_type)link o fileNoLa 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.

ParametroTipoObbligatorioDescrizione
item_ididSì
title, description, category_id, status, stamp_pdfNoCome in create_download_item
remove_coververoNoToglie la copertina
image_url o image_base64 (+ image_type)link o fileNoLa 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.

ParametroTipoObbligatorioDescrizione
item_ididSì

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.

ParametroTipoObbligatorioDescrizione
item_ididSì
file_urlindirizzo webNoIl link del file. Fino a 200 MB
file_base64testoNoIl file in base64, fino a circa 7 MB; oltre, usa il link
mime_typetestoNoEs.: application/pdf; facoltativo quando il link o il nome lo indicano
nametestoNoIl nome con l'estensione. Predefinito: quello del link
replace_file_ididNoIl 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.

ParametroTipoObbligatorioDescrizione
item_ididSì
file_ididSì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.

ParametroTipoObbligatorioDescrizione
item_ididSì
file_idselenco di idSì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.

ParametroTipoObbligatorioDescrizione
file_ididSì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.

ParametroTipoObbligatorioDescrizione
page, limitnumeriNoPaginazione

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).

ParametroTipoObbligatorioDescrizione
item_ididSì

Correlati