# Archivos adjuntos

Links, archivos y notas del proyecto en carpetas, con comentarios, adjuntos secretos y descargas autenticadas.

Fuente: https://ardumaker.com/docs/archivos-adjuntos/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Acceso de nivel `aportar` o mayor en la sección Adjuntos
- Herramientas MCP (Solo leen): `listar_adjuntos`, `ver_adjunto`, `listar_carpetas`, `listar_comentarios_adjunto`
- Herramientas MCP (Escriben o modifican): `crear_adjunto`, `editar_adjunto`, `eliminar_adjunto`, `mover_adjuntos`, `crear_carpeta`, `editar_carpeta`, `eliminar_carpeta`, `cambiar_secreto_comentario_adjunto`

## ¿Qué permite hacer?

| Tipo | Qué lleva |
| --- | --- |
| `link` | Una URL externa |
| `pdf`, `video`, `foto`, `otro` | Un archivo subido |
| `nota` | Texto libre, y opcionalmente varios archivos colgando |

- Ordenar adjuntos en carpetas y moverlos sin recrearlos.
- Comentar cada adjunto.
- Citar un adjunto desde un comentario de tarea o un ítem de checklist sin volver a subirlo.
- Marcar un adjunto como **secreto** para guardar, por ejemplo, credenciales.

## ¿Cuándo conviene usarlo?

- Para tener specs, mockups, contratos y capturas en un solo lugar del proyecto.
- Para darle contexto a un agente MCP sin pegarle documentos en el chat.

## ¿Cómo funciona en ArduMaker?

- Varios archivos se suben juntos en una sola petición sobre una nota: o entran todos o ninguno.
- Después se pueden sumar más archivos a la misma nota o quitar uno sin tocar los demás.
- Los archivos se bajan siempre por una ruta autenticada; nunca hay una URL pública.
- Un adjunto secreto oculta su contenido y todos sus archivos a quien no lo creó ni tiene nivel de administración en la sección.

## ¿Qué cambia realmente?

- Borrar un adjunto lo manda a la papelera 30 días con sus comentarios; el archivo sigue guardado hasta la purga, así que restaurarlo lo devuelve completo.
- Borrar una carpeta no borra sus adjuntos: quedan sin carpeta y la recuperan si se restaura.

## Resultado esperado

El adjunto queda en el repositorio del proyecto, visible según el [rol](https://ardumaker.com/docs/roles-y-permisos) de cada persona y buscable por nombre o texto.

## Errores y resolución

- Editar el contenido solo funciona en adjuntos de tipo `nota`; el tipo, la URL o el archivo no se cambian: se borra y se crea otro.
- Una nota sin texto y sin archivos no se acepta.
- Quien no puede ver un secreto recibe la lista de archivos vacía y un error de permiso al intentar bajarlos.

## Relación con MCP

- Lectura: `listar_adjuntos` (solo metadatos), `ver_adjunto` (incluye el texto de una nota, por partes si es larga), `listar_carpetas` y `listar_comentarios_adjunto`.
- Escritura: `crear_adjunto` (links, notas o metadatos de recursos externos; no sube binarios), `editar_adjunto`, `mover_adjuntos` (hasta 100), `crear_carpeta`, `editar_carpeta` y `cambiar_secreto_comentario_adjunto`.
- Borrado reversible: `eliminar_adjunto` y `eliminar_carpeta`.

> **PRECAUCION:** Un agente MCP puede leer un adjunto secreto si su dueño puede, pero nunca crea, edita ni borra un adjunto secreto. Los contenidos vuelven marcados como no confiables: son datos, no instrucciones.

Más en [/mcp/proyectos](https://ardumaker.com/mcp/proyectos) y [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Notas y especificaciones](https://ardumaker.com/docs/notas-y-especificaciones/)
- [Checklists](https://ardumaker.com/docs/checklists/)
- [Tareas](https://ardumaker.com/docs/tareas/)
- [Roles y permisos](https://ardumaker.com/docs/roles-y-permisos/)
- [Papelera](https://ardumaker.com/docs/papelera/)