Ferramentas MCP

Indica o que mudou recentemente nos projetos acessíveis ao utilizador autenticado — é a ferramenta que um agente consulta periodicamente para fazer a triagem de erros criados recentemente. Devolve três secções compactas dentro de um intervalo de tempo: tarefas recém-CRIADAS, tarefas ATUALIZADAS recentemente (criadas antes do intervalo) e COMENTÁRIOS recentes nas tarefas. O âmbito limita-se aos projetos que o utilizador possui ou aos quais pertence.

É a principal ferramenta de consulta de tarefas para agentes que precisam de decidir no que trabalhar. Filtra as tarefas acessíveis ao utilizador autenticado por projeto, coluna do quadro, etiqueta, responsável, estado, intervalos de datas de criação e de vencimento e prioridade, com ordenação configurável. Utilize created_after para revelar trabalho criado recentemente. Devolve uma lista compacta, pronta para apoiar decisões. Todas as consultas ficam limitadas aos projetos que o utilizador possui ou aos quais pertence.

Obtém as tarefas atribuídas ao utilizador autenticado. Devolve os nomes das tarefas, as datas de vencimento, as prioridades, as colunas do quadro, o estado de conclusão e ligações diretas para cada tarefa.

Obtém todos os quadros e as respetivas colunas de um projeto específico. Requer que o utilizador pertença ao projeto. Indique o nome do projeto ou uma palavra-chave para localizar o projeto.

Lista os marcos de um projeto com informações de progresso. Mostra o nome, as datas, os números de tarefas e a percentagem de conclusão de cada marco. Utilize esta ferramenta para encontrar marcos existentes antes de criar novos marcos ou atribuir tarefas. Se não for especificado nenhum projeto, lista os marcos de todos os projetos acessíveis.

Obtém todos os projetos dos quais o utilizador autenticado é membro. Devolve os nomes dos projetos, os papéis do utilizador (owner, admin, member ou guest), o número de membros e o tipo de plano do owner do projeto.

Lista todos os quadros de um projeto, incluindo o id, o número de colunas e o número de tarefas de cada quadro. Requer que o utilizador pertença ao projeto. Utilize esta ferramenta para descobrir os quadros antes de criar tarefas ou um novo quadro. Indique o nome do projeto ou uma palavra-chave para localizar o projeto.

Obtém detalhes completos de uma tarefa específica, incluindo a descrição, os responsáveis, as listas de tarefas, as subtarefas, as dependências e os comentários recentes. As tarefas podem ser localizadas pelo ID ou através de uma pesquisa no nome e na descrição.

Obtém as tarefas concluídas hoje (ou numa data específica) em todos os projetos nos quais o utilizador é owner ou member. Mostra quem concluiu cada tarefa e quando. É útil para stand-ups diários, relatórios de progresso e atualizações da equipa.

Obtém as tarefas atualmente em curso de um colega de equipa específico. Pesquisa utilizadores pelo nome em todos os projetos partilhados. Se vários utilizadores corresponderem ao nome, devolve uma lista com os endereços de e-mail para esclarecimento. Mostra apenas tarefas de colunas marcadas com o tipo `"in progress"` ou `"progressing"`. Devolve os nomes das tarefas, as prioridades, as colunas do quadro e ligações diretas.

Devolve a tarefa na qual o utilizador autenticado tem atualmente um temporizador em execução (nome da tarefa, #number, started_at e tempo decorrido), ou uma mensagem clara a indicar que não existe nenhum temporizador em execução. Chame esta ferramenta antes de StartStopTimetrackTool quando precisar de conhecer o estado atual do temporizador, em vez de o deduzir a partir de uma alternância.

Devolve uma visão geral compacta de todo o quadro numa única chamada, para que um agente possa analisar o estado do quadro sem efetuar muitas chamadas. Apresenta todas as colunas pela respetiva ordem, com o tipo, o número de tarefas e até 5 tarefas abertas, terminando com os totais de tarefas abertas e concluídas. O âmbito limita-se a um projeto que o utilizador autenticado possui ou ao qual pertence.

Pesquisa tarefas por palavra-chave em todos os projetos aos quais o utilizador autenticado pertence. Procura correspondências nos nomes e nas descrições das tarefas. Devolve até 20 resultados com o contexto do projeto e informações de prioridade.

Obtém tarefas com prazos próximos dentro do número de dias especificado (7 por predefinição), incluindo tarefas em atraso. Os resultados limitam-se aos projetos aos quais o utilizador autenticado pertence.

Obtém o relatório diário de stand-up do utilizador autenticado referente a hoje, incluindo todas as tarefas associadas e os respetivos comentários. Devolve o stand-up formatado em markdown.

Verifica a conectividade com o servidor MCP do Taskavel. Devolve uma resposta pong que confirma a ligação, juntamente com o endereço de e-mail do utilizador autenticado.

Adiciona um comentário a uma tarefa. Requer o papel owner, admin ou member no projeto. Os utilizadores com o papel guest não podem comentar.

Alterna se o utilizador que efetua a chamada acompanha uma tarefa (isto é, se está subscrito às respetivas notificações). Qualquer membro do projeto pode acompanhar uma tarefa.

Atribui tarefas a um marco ou remove-as de um marco. Ações: `"assign"` (define o marco das tarefas) e `"remove"` (remove o marco das tarefas). Pode atuar sobre uma única tarefa ou várias tarefas em simultâneo. Se o marco não existir, sugere a sua criação. Requer o papel owner, admin ou member.

Atribui, substitui ou remove responsáveis de uma tarefa. A ação `"assign"` adiciona um utilizador sem remover os responsáveis existentes, `"replace"` torna o utilizador selecionado no único responsável e `"remove"` retira a atribuição ao utilizador selecionado. O utilizador de destino tem de pertencer ao projeto da tarefa, e o utilizador que executa a ação tem de ter o papel owner, admin ou member.

Atualiza um marco existente. Permite alterar o nome, a descrição, as datas e a cor. Localize-o através de milestone_id ou pesquisando pelo nome dentro de um projeto. Requer o papel owner, admin ou member.

Atualiza uma tarefa existente. Permite mudar o nome, alterar a descrição, modificar as datas de vencimento e marcar tarefas como concluídas ou não concluídas. A conclusão da tarefa é validada relativamente a subtarefas não concluídas, itens de listas de tarefas e dependências bloqueadoras. Requer o papel owner, admin ou member.

Carrega um ficheiro anexo (captura de ecrã, registo, PDF, entre outros) para uma tarefa. Envie os bytes brutos do ficheiro codificados em base64 em file_base64, juntamente com um file_name que inclua a extensão, por exemplo, `"screenshot.png"`. É aceite e removido um prefixo de URI de dados (`"data:image/png;base64,.."`). O tamanho máximo é de 10 MB por ficheiro após a descodificação; o ficheiro também é contabilizado na quota de armazenamento do owner do projeto. Extensões permitidas: imagens (jpg, jpeg, png, gif, webp, heic, svg), vídeo (mp4, mov, webm, ..), áudio (mp3, wav, ogg), documentos (pdf, txt, md, rtf, doc, docx, xls, xlsx, ppt, pptx) e arquivos comprimidos (zip, rar, tar, gz). Utilize esta ferramenta para anexar provas a uma tarefa — capturas de ecrã de um erro, um registo de falha ou um relatório gerado. Requer o papel owner, admin ou member no projeto; os utilizadores com o papel guest não podem carregar ficheiros.

Convida um utilizador para um projeto através do respetivo endereço de e-mail. Apenas os utilizadores com o papel owner ou admin podem convidar membros. Aplicam-se os limites do plano gratuito (máximo de 5 membros). Envia um e-mail de convite para o endereço indicado.

Cria uma nova etiqueta num projeto. As etiquetas têm um nome, uma cor opcional e uma descrição opcional. Requer o papel owner, admin ou member.

Cria um novo marco num projeto. Os marcos agrupam tarefas relacionadas e acompanham o progresso em direção a um objetivo. Indique, no mínimo, o projeto e o nome do marco. Requer o papel owner, admin ou member.

Cria um projeto completo numa única chamada. Forneça apenas um nome para criar um projeto com um quadro predefinido ou forneça uma estrutura completa (colunas, marcos e tarefas) que tenha concebido. Neste caso, o agente que efetua a chamada é o gerador; esta ferramenta apenas guarda a estrutura e NÃO executa o processo assíncrono pago de geração por IA. O criador torna-se owner do projeto.

Cria um novo quadro num projeto, opcionalmente preenchido a partir de um modelo. Requer o papel owner, admin ou member. Os utilizadores com o papel guest não podem criar quadros. Indique, no mínimo, o nome do projeto e o nome do quadro.

Cria uma nova tarefa num projeto. Requer o papel owner, admin ou member. Indique, no mínimo, o nome do projeto e o nome da tarefa.

Define ou remove a prioridade de uma tarefa. Utilize priority_name (por exemplo, `"High Priority"`, `"Medium Priority"` ou `"Low Priority"`) ou priority_id para definir a prioridade, ou clear=true para a remover. Requer o papel owner, admin ou member.

Duplica uma tarefa, incluindo as respetivas listas de verificação (todos), etiquetas e responsáveis. A nova tarefa recebe o nome `"(duplicated) <original name>"` e pertence ao utilizador que efetua a chamada. Requer o papel owner, admin ou member.

Gere as dependências entre duas tarefas. A ação `"add"` (predefinida) liga task_id e related_task_id de forma recíproca: uma ligação `"blocked_by"` em task_id cria uma ligação `"blocks"` correspondente em related_task_id e vice-versa. A ação `"remove"` remove a ligação em ambas as direções. Requer o papel owner, admin ou member.

Gere as etiquetas de uma tarefa. Ações: `"add"` (anexa etiquetas sem remover as existentes), `"remove"` (remove etiquetas específicas) e `"set"` (substitui todas as etiquetas). Indique tag_names ou tag_ids. Requer o papel owner, admin ou member.

Gere os lembretes de uma tarefa. Utilize action=add para agendar um lembrete, list para ler os lembretes de uma tarefa ou remove para eliminar um lembrete pelo id. Requer o papel owner, admin ou member.

Gere as listas de verificação (listas de tarefas) de uma tarefa e os respetivos itens. Uma lista de verificação agrupa itens simples que podem ser assinalados. Utilize action=create_checklist para adicionar uma lista de verificação, add_item para acrescentar um item, toggle_item para alternar um item entre concluído e não concluído e list para ler todas as listas de verificação com o respetivo progresso. Requer o papel owner, admin ou member.

Gere o relatório diário de stand-up do utilizador autenticado. Adiciona tarefas ao stand-up de hoje, define comentários por tarefa ou define um resumo. Cria o stand-up de hoje caso ainda não exista.

Gere as subtarefas de uma tarefa principal. Uma subtarefa é uma tarefa ligada à respetiva tarefa principal. Utilize action=create para adicionar uma subtarefa (opcionalmente com uma data de vencimento) ou action=list para ler as subtarefas da tarefa principal. Requer o papel owner, admin ou member.

Inicia ou para o registo de tempo numa tarefa. Passe `action: "stop"` para parar explicitamente — é uma operação segura sem efeito (nunca inicia um temporizador) se esta tarefa não tiver nenhum temporizador em execução. Passe `action: "start"` para iniciar explicitamente — é uma operação segura sem efeito se o temporizador desta tarefa já estiver em execução. Iniciar um temporizador para sempre qualquer temporizador em execução noutra tarefa deste utilizador primeiro (apenas um temporizador pode estar em execução de cada vez); a resposta indica o nome dessa outra tarefa sempre que isto acontece. Omita `action` para manter o comportamento de alternância antigo: para o temporizador se o temporizador desta tarefa estiver em execução; caso contrário, inicia um (parando primeiro qualquer outro temporizador em execução). Utilize GetRunningTimerTool primeiro se precisar de conhecer o estado atual do temporizador antes de decidir. Requer o papel owner, admin ou member.

Move uma tarefa para uma coluna diferente do quadro. É útil para alterar o estado da tarefa, por exemplo, ao movê-la de `"To Do"` para `"In Progress"` ou `"Done"`. Requer o papel owner, admin ou member.

Move várias tarefas em simultâneo para uma coluna de destino. Filtra as tarefas pelo nome de um colega de equipa, por marco ou pela coluna atual. Um admin/owner pode mover as tarefas de qualquer membro da equipa. Se a coluna de destino não for encontrada, apresenta as colunas disponíveis para o utilizador escolher. Requer o papel owner ou admin.

IMPORTANTE: utilize ESTA ferramenta quando o utilizador quiser responder a um comentário. O comment_id é o número apresentado como #xxx na interface do Taskavel. Exemplo: o utilizador diz `"reply to comment #1276"` → utilize esta ferramenta com comment_id=1276. Permite mencionar utilizadores pelo nome ou endereço de e-mail.

Arquiva uma tarefa (eliminação lógica). A tarefa deixa de aparecer nos quadros, mas pode ser restaurada posteriormente; não é eliminada de forma permanente. Requer o papel owner, admin ou member.

Elimina permanentemente uma etiqueta de um projeto e remove-a de todas as tarefas. Requer o papel owner, admin ou member. Utilize tag_id ou tag_name para identificar a etiqueta.

Elimina um marco de um projeto. As tarefas atribuídas a este marco serão desvinculadas, mas NÃO serão eliminadas. Requer o papel owner ou admin. Peça confirmação ao utilizador antes de eliminar.

Elimina permanentemente uma tarefa que JÁ ESTEJA ARQUIVADA. Esta ação é irreversível. Reproduz o fluxo lixo → esvaziar lixo da aplicação: primeiro, a tarefa tem de ser arquivada (ArchiveTaskTool); depois, pode ser removida definitivamente do arquivo através desta ferramenta. As tarefas ativas não podem ser eliminadas permanentemente num único passo. Requer confirm:true e o papel owner, admin ou member.

Remove um membro de um projeto. Apenas os utilizadores com o papel owner ou admin podem remover membros. O owner do projeto não pode ser removido.