Anexos

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

  • 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

Markdown

O que permite fazer?

TipoO que leva
linkUm URL externo
pdf, video, foto, otroUm arquivo enviado
notaTexto 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 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.

Mais em /mcp/proyectos e /mcp/docs.

Funcionalidades relacionadas