# Ferramentas · Downloads

> Ferramentas MCP para o módulo Downloads: configurar o espaço, criar itens, enviar, trocar, remover e reordenar arquivos, publicar, pegar o link de 5 minutos, ver os seus downloads e os contadores da equipe.

O módulo [Downloads](/espacos/downloads) pelo assistente: configurar o espaço (repositório ou um arquivo só, categorias, aprovação), criar o item, enviar os arquivos por link ou arquivo, publicar, ver o que você pode baixar e os contadores da equipe.

Cada ferramenta traz um selo: <span class="tool-kind tool-kind-read">Só consulta</span> não muda nada, <span class="tool-kind tool-kind-write">Altera</span> cria ou muda algo na hora, e <span class="tool-kind tool-kind-confirm">Pede confirmação</span> só age depois do seu sim a um resumo. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

## Em resumo

| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
| [`get_downloads_space_settings`](#get-downloads-space-settings) | O modo, a aprovação e as categorias de um espaço de Downloads | Qualquer que veja o espaço | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`update_downloads_space_settings`](#update-downloads-space-settings) | Muda o modo, a aprovação e a lista de categorias | Administrador | <span class="tool-kind tool-kind-write">Altera</span> |
| [`list_download_items`](#list-download-items) | Os itens do espaço, com filtros | Qualquer que veja o espaço | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`get_download_item`](#get-download-item) | Um item, com arquivos e produto | Qualquer que veja o espaço | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`create_download_item`](#create-download-item) | Cria um item (rascunho) com o seu produto | Quem o espaço deixa criar | <span class="tool-kind tool-kind-write">Altera</span> |
| [`update_download_item`](#update-download-item) | Edita o item, o carimbo, a capa e publica | Autor ou equipe | <span class="tool-kind tool-kind-write">Altera</span> |
| [`delete_download_item`](#delete-download-item) | Apaga o item e os arquivos | Autor ou equipe | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`upload_download_file`](#upload-download-file) | Envia (ou troca) um arquivo, por link ou base64 | Autor ou equipe | <span class="tool-kind tool-kind-write">Altera</span> |
| [`remove_download_file`](#remove-download-file) | Remove um arquivo | Autor ou equipe | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> |
| [`reorder_download_files`](#reorder-download-files) | Muda a ordem dos arquivos | Autor ou equipe | <span class="tool-kind tool-kind-write">Altera</span> |
| [`get_download_url`](#get-download-url) | O link de 5 minutos de um arquivo | Qualquer com acesso | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`list_my_downloads`](#list-my-downloads) | O que você pode baixar | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> |
| [`get_download_stats`](#get-download-stats) | Quantos downloads cada arquivo teve | Moderador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> |

O espaço se cria com [`create_space`](/mcp/ferramentas-comunidade#create-space) e `module: "downloads"`. Quem pode enviar é o **Quem pode postar** do espaço ([`update_space_access`](/mcp/ferramentas-comunidade#update-space-access)): por padrão, só a equipe. O preço do item se define no produto que nasce com ele (`update_product`, `update_price`, `publish_product`; ver [Vendas e planos](/mcp/ferramentas-vendas)).

## `get_downloads_space_settings`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Configuração do espaço.** O modo (`multi`, repositório; `single`, um arquivo só), se os itens dos membros esperam aprovação e as categorias (id, nome e quantos itens). *Papel mínimo: qualquer que veja o espaço.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | O espaço de Downloads |

**Peça assim:** *"Como está configurado o espaço Materiais?"*

## `update_downloads_space_settings`

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

**Configurar o espaço.** Muda o modo, a aprovação e as categorias. Só o que você mandar muda. *Papel mínimo: administrador.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | |
| `mode` | `multi` ou `single` | Não | `single` é recusado enquanto houver 2 ou mais itens ou arquivos |
| `require_approval` | verdadeiro ou falso | Não | Os itens dos membros esperam a equipe |
| `categories` | lista | Não | A lista **completa**, em ordem: item com `id` renomeia e reordena, sem `id` cria, o que falta na lista é removido (recusado enquanto a categoria tem itens; a mensagem diz quantos) |

Leia [`get_downloads_space_settings`](#get-downloads-space-settings) antes, para pegar os ids.

**Peça assim:** *"No espaço Materiais, crie as categorias Planilhas e E-books e peça aprovação para o que os membros enviarem."*

## `list_download_items`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Itens do espaço.** Do mais novo ao mais antigo: título, categoria, arquivos e situação. A equipe e o autor veem também rascunhos e itens em análise. Um item pago que a pessoa não comprou vem **travado**: mostra o preço e o produto, sem arquivos. *Papel mínimo: qualquer que veja o espaço.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | |
| `category_id` | id | Não | Filtra por categoria |
| `status` | texto | Não | A situação do item |
| `mine` | verdadeiro ou falso | Não | Só os que você criou |
| `search` | texto | Não | Procura no título |
| `page`, `limit` | números | Não | Paginação |

## `get_download_item`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Um item.** Descrição, categoria, arquivos (id, nome, tipo, tamanho e, para a equipe, quantos downloads), situação e o produto (preço, se é gratuito, se esgotou e o seu lugar na lista de espera). Item travado não mostra arquivos. *Papel mínimo: qualquer que veja o espaço.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | De `list_download_items` |

## `create_download_item`

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

**Criar um item.** Cria o item em **rascunho**, com o seu produto (tipo Download, gratuito, em rascunho), devolvido em `product`. Depois: envie os arquivos com [`upload_download_file`](#upload-download-file), defina o preço com `update_product` e publique com [`update_download_item`](#update-download-item). *Papel: quem o Quem pode postar do espaço permite; por padrão, a equipe (o membro recebe 403).*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `space` | id ou link | Sim | |
| `title` | texto | Sim | |
| `description` | Markdown | Não | |
| `category_id` | id | Não | De `get_downloads_space_settings` |
| `stamp_pdf` | verdadeiro ou falso | Não | Carimba os PDFs de quem baixa (padrão: falso). Ver [Carimbar PDFs](/espacos/downloads#carimbar-pdfs) |
| `image_url` ou `image_base64` (+ `image_type`) | link ou arquivo | Não | A capa: link até 10 MB, arquivo até 5 MB. Ver [Imagens](/mcp/ferramentas#imagens) |

Num espaço no modo `single`, um segundo item é recusado (409). Itens de membros esperam aprovação quando o espaço pede.

**Peça assim:** *"Crie no espaço Materiais o item Planilha de fluxo de caixa, na categoria Planilhas."*

## `update_download_item`

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

**Editar e publicar.** Muda título, descrição, categoria, `stamp_pdf`, a capa (`remove_cover` a tira) e a situação (`status`: `draft` ou `published`; publicar exige pelo menos um arquivo). Só o que você mandar muda. *Papel: o autor e a equipe.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |
| `title`, `description`, `category_id`, `status`, `stamp_pdf` | | Não | Como em `create_download_item` |
| `remove_cover` | verdadeiro | Não | Tira a capa |
| `image_url` ou `image_base64` (+ `image_type`) | link ou arquivo | Não | A capa nova |

**Peça assim:** *"Publique o item Planilha de fluxo de caixa e ligue o carimbo nos PDFs."*

## `delete_download_item`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Apagar o item.** Apaga o item e os arquivos; o produto dele é arquivado. É recusado (409) enquanto uma compra paga ainda dá acesso: reembolse antes. *Papel: o autor e a equipe.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |

**Devolve:** na primeira chamada, o resumo do que será apagado e o código de confirmação.

## `upload_download_file`

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

**Enviar um arquivo.** Acrescenta um arquivo ao item, por **link** público ou por **base64**. Aceita imagens (PNG, JPG, WEBP, GIF), planilhas (XLS, XLSX, ODS, CSV), PDF, documentos (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) e ZIP, nunca executáveis; o nome precisa manter a extensão e o conteúdo precisa bater com o tipo (conferido pelos primeiros bytes), como no navegador. *Papel: o autor e a equipe.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |
| `file_url` | endereço web | Não | O link do arquivo. Até **200 MB** |
| `file_base64` | texto | Não | O arquivo em base64, até cerca de **7 MB**; acima disso, use o link |
| `mime_type` | texto | Não | Ex.: `application/pdf`; opcional quando o link ou o nome dizem |
| `name` | texto | Não | O nome com a extensão. Padrão: o do link |
| `replace_file_id` | id | Não | O arquivo que este substitui |

No modo `single`, o item guarda um arquivo só: para enviar de novo, passe `replace_file_id`. O aviso de uso do armazenamento só avisa.

**Peça assim:** *"Envie https://exemplo.memberfy.net/fluxo.xlsx para o item Planilha de fluxo de caixa."*

## `remove_download_file`

<span class="tool-kind tool-kind-confirm">Pede confirmação</span>

**Remover um arquivo.** O arquivo é apagado e o espaço volta. Se era o último de um item publicado, o item volta a rascunho. *Papel: o autor e a equipe.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |
| `file_id` | id | Sim | De `get_download_item` |

## `reorder_download_files`

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

**Reordenar os arquivos.** `file_ids` é a lista completa, do primeiro ao último. *Papel: o autor e a equipe.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |
| `file_ids` | lista de ids | Sim | A ordem nova |

## `get_download_url`

<span class="tool-kind tool-kind-read">Só consulta</span>

**O link de um arquivo.** Um link que vale **5 minutos**. Peça só quando a pessoa quiser mesmo o arquivo; não guarde nem repasse. A equipe e o autor sempre recebem; os outros precisam de acesso (item grátis, compra ativa ou plano que inclui o produto; ter baixado antes não basta). *Papel mínimo: qualquer que veja o espaço.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `file_id` | id | Sim | De `get_download_item` |

**Devolve:** o link e `stamped`: `true` quando é a cópia com o [carimbo](/espacos/downloads#carimbar-pdfs) (só para quem não é da equipe), `false` quando é o original. Cada download de membro entra nos contadores.

Item pago que a pessoa não tem responde `403`, com o preço (a compra é feita no app); item esgotado responde `409`, e o assistente sugere [`join_waitlist`](/mcp/ferramentas-cursos#join-waitlist).

## `list_my_downloads`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Os seus downloads.** Os itens que você pode abrir, com a origem do acesso (`purchase`, `plan`, `open`, `team`), o seu último download e, em compra, a data e o fim do acesso. *Papel mínimo: qualquer.*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `page`, `limit` | números | Não | Paginação |

## `get_download_stats`

<span class="tool-kind tool-kind-read">Só consulta</span>

**Contadores do item.** Quantas vezes cada arquivo foi baixado, no total e por pessoas diferentes. Só números, nunca quem. *Papel mínimo: moderador (ou financeiro).*

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `item_id` | id | Sim | |

## Relacionados

- [Downloads](/espacos/downloads)
- [Ferramentas](/mcp/ferramentas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)