# Anexos

Links, arquivos e notas do projeto em pastas, com comentários, anexos secretos e transferências autenticadas.

Fonte: https://ardumaker.com/pt/docs/archivos-adjuntos/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Acesso de nível `aportar` ou superior na seção Anexos
- Ferramentas MCP (Só leem): `listar_adjuntos`, `ver_adjunto`, `listar_carpetas`, `listar_comentarios_adjunto`
- Ferramentas MCP (Escrevem ou modificam): `crear_adjunto`, `editar_adjunto`, `eliminar_adjunto`, `mover_adjuntos`, `crear_carpeta`, `editar_carpeta`, `eliminar_carpeta`, `cambiar_secreto_comentario_adjunto`

## O que permite fazer?

| Tipo | O que leva |
| --- | --- |
| `link` | Um URL externo |
| `pdf`, `video`, `foto`, `otro` | Um arquivo enviado |
| `nota` | Texto livre e, opcionalmente, vários arquivos associados |

- Organizar anexos em pastas e movê-los sem os recriar.
- Comentar cada anexo.
- Citar um anexo a partir de um comentário de tarefa ou item de checklist sem o voltar a enviar.
- Marcar um anexo como **secreto** para salvar, por exemplo, credenciais.

## Quando convém usar?

- Para ter specs, mockups, contratos e capturas em um só lugar do projeto.
- Para dar contexto a um agente MCP sem colar documentos no chat.

## Como funciona na ArduMaker?

- Vários arquivos são enviados juntos em um só pedido sobre uma nota: ou entram todos ou nenhum.
- Depois podem-se juntar mais arquivos à mesma nota ou retirar um sem tocar nos outros.
- Os arquivos transferem-se sempre por uma rota autenticada; nunca há um URL público.
- Um anexo secreto oculta o conteúdo e todos os arquivos a quem não o criou nem tem nível de administração na seção.

## O que muda realmente?

- Apagar um anexo envia-o para a lixeira 30 dias com os comentários; o arquivo continua guardado até à purga, por isso restaurá-lo devolve-o completo.
- Apagar uma pasta não apaga os anexos: ficam sem pasta e recuperam-na se for restaurada.

## Resultado esperado

O anexo fica no repositório do projeto, visível segundo a [função](https://ardumaker.com/pt/docs/roles-y-permisos) de cada pessoa e pesquisável por nome ou texto.

## Erros e resolução

- Editar o conteúdo só funciona em anexos do tipo `nota`; o tipo, o URL ou o arquivo não mudam: apaga-se e cria-se outro.
- Uma nota sem texto e sem arquivos não é aceite.
- Quem não pode ver um segredo recebe a lista de arquivos vazia e um erro de permissão ao tentar transferi-los.

## Relação com MCP

- Leitura: `listar_adjuntos` (só metadados), `ver_adjunto` (inclui o texto de uma nota, por partes se for longa), `listar_carpetas` e `listar_comentarios_adjunto`.
- Escrita: `crear_adjunto` (links, notas ou metadados de recursos externos; não envia binários), `editar_adjunto`, `mover_adjuntos` (até 100), `crear_carpeta`, `editar_carpeta` e `cambiar_secreto_comentario_adjunto`.
- Apagamento reversível: `eliminar_adjunto` e `eliminar_carpeta`.

> **PRECAUCION:** Um agente MCP pode ler um anexo secreto se o dono puder, mas nunca cria, edita nem apaga um anexo secreto. Os conteúdos voltam marcados como não confiáveis: são dados, não instruções.

Mais em [/mcp/proyectos](https://ardumaker.com/pt/mcp/proyectos) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Notas e especificações](https://ardumaker.com/pt/docs/notas-y-especificaciones/)
- [Checklists](https://ardumaker.com/pt/docs/checklists/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Lixo](https://ardumaker.com/pt/docs/papelera/)