Herramientas · Descargas
Herramientas MCP para el módulo Descargas: configurar el espacio, crear elementos, subir, cambiar, quitar y reordenar archivos, publicar, obtener el enlace de 5 minutos, ver tus descargas y las cifras del equipo.
El módulo Descargas con el asistente: configurar el espacio (repositorio o un solo archivo, categorías, aprobación), crear el elemento, subir los archivos por enlace o archivo, publicar, ver lo que puedes descargar y las cifras del equipo.
Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.
En resumen
| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
get_downloads_space_settings | El modo, la aprobación y las categorías de un espacio de Descargas | Cualquiera que vea el espacio | Solo consulta |
update_downloads_space_settings | Cambia el modo, la aprobación y la lista de categorías | Administrador | Modifica |
list_download_items | Los elementos del espacio, con filtros | Cualquiera que vea el espacio | Solo consulta |
get_download_item | Un elemento, con archivos y producto | Cualquiera que vea el espacio | Solo consulta |
create_download_item | Crea un elemento (borrador) con su producto | Quien el espacio deja crear | Modifica |
update_download_item | Edita el elemento, el sello, la portada y publica | Autor o equipo | Modifica |
delete_download_item | Borra el elemento y los archivos | Autor o equipo | Pide confirmación |
upload_download_file | Sube (o cambia) un archivo, por enlace o base64 | Autor o equipo | Modifica |
remove_download_file | Quita un archivo | Autor o equipo | Pide confirmación |
reorder_download_files | Cambia el orden de los archivos | Autor o equipo | Modifica |
get_download_url | El enlace de 5 minutos de un archivo | Cualquiera con acceso | Solo consulta |
list_my_downloads | Lo que puedes descargar | Cualquiera | Solo consulta |
get_download_stats | Cuántas descargas tuvo cada archivo | Moderador o financiero | Solo consulta |
El espacio se crea con create_space y module: "downloads". Quién puede subir es Quién puede publicar del espacio (update_space_access): por defecto, solo el equipo. El precio del elemento se define en el producto que nace con él (update_product, update_price, publish_product; ver Ventas y planes).
get_downloads_space_settings
Solo consulta
Configuración del espacio. El modo (multi, repositorio; single, un solo archivo), si los elementos de los miembros esperan aprobación y las categorías (id, nombre y cuántos elementos). Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | El espacio de Descargas |
Pídelo así: "¿Cómo está configurado el espacio Materiales?"
update_downloads_space_settings
Modifica
Configurar el espacio. Cambia el modo, la aprobación y las categorías. Solo cambia lo que envíes. Rol mínimo: administrador.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
mode | multi o single | No | single se rechaza mientras haya 2 o más elementos o archivos |
require_approval | verdadero o falso | No | Los elementos de los miembros esperan al equipo |
categories | lista | No | La lista completa, en orden: un elemento con id renombra y reordena, sin id crea, lo que falta en la lista se quita (se rechaza mientras la categoría tenga elementos; el mensaje dice cuántos) |
Lee get_downloads_space_settings antes, para obtener los ids.
Pídelo así: "En el espacio Materiales, crea las categorías Hojas de cálculo y E-books y pide aprobación para lo que suban los miembros."
list_download_items
Solo consulta
Elementos del espacio. Del más nuevo al más antiguo: título, categoría, archivos y situación. El equipo y el autor ven también los borradores y los elementos en revisión. Un elemento de pago que la persona no compró llega bloqueado: muestra el precio y el producto, sin archivos. Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
category_id | id | No | Filtra por categoría |
status | texto | No | La situación del elemento |
mine | verdadero o falso | No | Solo los que creaste |
search | texto | No | Busca en el título |
page, limit | números | No | Paginación |
get_download_item
Solo consulta
Un elemento. Descripción, categoría, archivos (id, nombre, tipo, tamaño y, para el equipo, cuántas descargas), situación y el producto (precio, si es gratuito, si se agotó y tu lugar en la lista de espera). Un elemento bloqueado no muestra archivos. Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí | De list_download_items |
create_download_item
Modifica
Crear un elemento. Crea el elemento en borrador, con su producto (tipo Descarga, gratuito, en borrador), devuelto en product. Después: sube los archivos con upload_download_file, define el precio con update_product y publica con update_download_item. Rol: quien permita Quién puede publicar del espacio; por defecto, el equipo (el miembro recibe 403).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
space | id o enlace | Sí | |
title | texto | Sí | |
description | Markdown | No | |
category_id | id | No | De get_downloads_space_settings |
stamp_pdf | verdadero o falso | No | Sella los PDF de quien descarga (predeterminado: falso). Ver Sellar PDF |
image_url o image_base64 (+ image_type) | enlace o archivo | No | La portada: enlace hasta 10 MB, archivo hasta 5 MB. Consulta Imágenes |
En un espacio en el modo single, un segundo elemento se rechaza (409). Los elementos de miembros esperan aprobación cuando el espacio lo pide.
Pídelo así: "Crea en el espacio Materiales el elemento Hoja de flujo de caja, en la categoría Hojas de cálculo."
update_download_item
Modifica
Editar y publicar. Cambia el título, la descripción, la categoría, stamp_pdf, la portada (remove_cover la quita) y la situación (status: draft o published; publicar exige al menos un archivo). Solo cambia lo que envíes. Rol: el autor y el equipo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí | |
title, description, category_id, status, stamp_pdf | No | Como en create_download_item | |
remove_cover | verdadero | No | Quita la portada |
image_url o image_base64 (+ image_type) | enlace o archivo | No | La portada nueva |
Pídelo así: "Publica el elemento Hoja de flujo de caja y activa el sello en los PDF."
delete_download_item
Pide confirmación
Borrar el elemento. Borra el elemento y los archivos; su producto se archiva. Se rechaza (409) mientras una compra pagada todavía dé acceso: reembolsa antes. Rol: el autor y el equipo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí |
Devuelve: en la primera llamada, el resumen de lo que se borrará y el código de confirmación.
upload_download_file
Modifica
Subir un archivo. Añade un archivo al elemento, por enlace público o por base64. Acepta imágenes (PNG, JPG, WEBP, GIF), hojas de cálculo (XLS, XLSX, ODS, CSV), PDF, documentos (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) y ZIP, nunca ejecutables; el nombre tiene que conservar la extensión y el contenido tiene que coincidir con el tipo (se comprueba por los primeros bytes), como en el navegador. Rol: el autor y el equipo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí | |
file_url | dirección web | No | El enlace del archivo. Hasta 200 MB |
file_base64 | texto | No | El archivo en base64, hasta unos 7 MB; por encima, usa el enlace |
mime_type | texto | No | Ej.: application/pdf; opcional cuando el enlace o el nombre lo indican |
name | texto | No | El nombre con la extensión. Por defecto: el del enlace |
replace_file_id | id | No | El archivo al que sustituye |
En el modo single, el elemento guarda un solo archivo: para subir otro, pasa replace_file_id. El aviso de uso del almacenamiento solo avisa.
Pídelo así: "Sube https://exemplo.memberfy.net/fluxo.xlsx al elemento Hoja de flujo de caja."
remove_download_file
Pide confirmación
Quitar un archivo. El archivo se borra y el espacio se recupera. Si era el último de un elemento publicado, el elemento vuelve a borrador. Rol: el autor y el equipo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí | |
file_id | id | Sí | De get_download_item |
reorder_download_files
Modifica
Reordenar los archivos. file_ids es la lista completa, del primero al último. Rol: el autor y el equipo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí | |
file_ids | lista de ids | Sí | El orden nuevo |
get_download_url
Solo consulta
El enlace de un archivo. Un enlace que vale 5 minutos. Pídelo solo cuando la persona quiera de verdad el archivo; no lo guardes ni lo compartas. El equipo y el autor siempre lo reciben; los demás necesitan acceso (elemento gratis, compra activa o plan que incluye el producto; haberlo descargado antes no basta). Rol mínimo: cualquiera que vea el espacio.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
file_id | id | Sí | De get_download_item |
Devuelve: el enlace y stamped: true cuando es la copia con el sello (solo para quien no es del equipo), false cuando es el original. Cada descarga de un miembro cuenta en las cifras.
Un elemento de pago que la persona no tiene responde 403, con el precio (la compra se hace en la app); un elemento agotado responde 409, y el asistente sugiere join_waitlist.
list_my_downloads
Solo consulta
Tus descargas. Los elementos que puedes abrir, con el origen del acceso (purchase, plan, open, team), tu última descarga y, en una compra, la fecha y el fin del acceso. Rol mínimo: cualquiera.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page, limit | números | No | Paginación |
get_download_stats
Solo consulta
Cifras del elemento. Cuántas veces se descargó cada archivo, en total y por personas distintas. Solo números, nunca quién. Rol mínimo: moderador (o financiero).
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
item_id | id | Sí |