Tarefas

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta task é a ferramenta mais abrangente do GitScrum MCP Server. Com 12 ações cobrindo todo o ciclo de vida de tarefas, ela lida com tudo, desde listas de tarefas pessoais e planejadores diários até filtragem avançada, duplicação de tarefas e movimentação entre projetos. Toda operação que sua equipe realiza no quadro Kanban, seu assistente de IA pode executar através de linguagem natural.

Esta ferramenta consolidada substitui o que seriam dezenas de endpoints de API individuais. O assistente de IA determina qual ação chamar com base na sua instrução em linguagem natural, mapeia sua intenção para os parâmetros corretos e retorna resultados estruturados nos quais você pode agir imediatamente.

Visão Geral das Ações

Visualizações de Tarefas Pessoais

As ações my e today não requerem parâmetros. O servidor MCP identifica você através da sua sessão autenticada e retorna tarefas de todos os seus projetos.

my retorna todas as tarefas atribuídas a você, independentemente do projeto ou status. Isso é o equivalente a abrir seu dashboard pessoal de tarefas na aplicação web GitScrum. Os resultados incluem título da tarefa, nome do projeto, status, prioridade, data de vencimento e responsáveis.

today restringe o escopo para tarefas que vencem hoje ou estão explicitamente agendadas para hoje. Esta é sua visualização de planejamento diário — as tarefas que precisam de atenção agora.

notifications busca suas notificações relacionadas a tarefas junto com a contagem de não lidas. Isso inclui menções, mudanças de atribuição, atualizações de status e comentários nas suas tarefas.

Você:  "O que tenho para fazer?"
IA:    Chama task action=my → retorna sua lista completa de tarefas

Você:  "O que preciso terminar hoje?"
IA:    Chama task action=today → retorna as tarefas de hoje

Você:  "Tenho alguma notificação nova?"
IA:    Chama task action=notifications → retorna notificações com contagem de não lidas

Criando Tarefas

A ação create constrói uma nova tarefa em uma única chamada. Todos os campos opcionais — sprint, user story, coluna, tipo, esforço, responsáveis, labels, datas e estimativas — podem ser definidos no momento da criação. Não há necessidade de chamadas de atualização posteriores.

Parâmetros Obrigatórios

Parâmetros Opcionais

Resolução Inteligente de Colunas

Você pode especificar colunas por nome em vez de ID numérico. Quando você passa column: "In Progress", o servidor MCP busca a configuração de workflow do projeto, encontra a coluna correspondente por nome (sem distinção entre maiúsculas e minúsculas) e resolve para o workflow_id correto. Se o nome da coluna não corresponder a nenhuma coluna existente, o servidor retorna um erro com a lista de colunas disponíveis para que o assistente de IA possa sugerir alternativas.

Exemplos de Prompts

Você:  "Criar uma tarefa 'Corrigir validação de login' no projeto backend"
IA:    Chama task action=create com title, project_slug, company_slug

Você:  "Criar um bug 'Vazamento de memória no dashboard' atribuído a @sarah no sprint atual"
IA:    Chama task action=create com title, is_bug=true, usernames=["sarah"], sprint_slug

Você:  "Adicionar uma subtarefa 'Escrever testes unitários' sob a tarefa [uuid]"
IA:    Chama task action=create com title, parent_id=[uuid]

Você:  "Criar uma tarefa de alta prioridade 'Deploy do hotfix' com vencimento amanhã e estimativa de 2 horas"
IA:    Chama task action=create com title, effort_id, due_date, estimated_minutes=120

Atualizando Tarefas

A ação update modifica qualquer campo de uma tarefa existente. Apenas os campos que você especifica são alterados — todos os outros campos permanecem inalterados.

Parâmetros Obrigatórios

Parâmetros Opcionais

Todos os parâmetros opcionais da ação create estão disponíveis em update, além de:

O servidor MCP cuida de toda a resolução de IDs necessária durante atualizações. Se você passar sprintslug, o servidor resolve para sprintid. Se passar column, resolve para workflow_id. Se passar usernames, mapeia para IDs de membros.

Exemplos de Prompts

Você:  "Mover tarefa GS-123 para a coluna Done"
IA:    Busca tarefa por código → chama task action=update com column="Done"

Você:  "Atribuir @john e @maria à tarefa de login"
IA:    Chama task action=update com usernames=["john","maria"]

Você:  "Alterar o prazo para a próxima sexta-feira"
IA:    Chama task action=update com due_date="2026-02-13"

Você:  "Marcar a tarefa de deployment como bloqueadora"
IA:    Chama task action=update com is_blocker=true

Você:  "Arquivar todas as tarefas concluídas do último sprint"
IA:    Filtra tarefas concluídas → chama update com is_archived=true para cada uma

Completando Tarefas

A ação complete marca uma tarefa como concluída. Esta é uma ação dedicada em vez de uma atualização de status porque completar uma tarefa pode disparar workflows adicionais — métricas de sprint são atualizadas, notificações são disparadas e logs de atividade registram o evento de conclusão.

Você:  "Completar tarefa [uuid]"
IA:    Chama task action=complete com uuid

Você:  "Marcar a tarefa de migração da API como concluída"
IA:    Encontra a tarefa por nome ou código → chama task action=complete

Filtrando Tarefas

A ação filter fornece pesquisa avançada multi-campo em tarefas dentro de um projeto. Combine qualquer número de critérios de filtro para restringir os resultados com precisão.

Parâmetros Obrigatórios

Parâmetros de Filtro

A ação de filtro lida com a resolução de título para ID automaticamente. Quando você passa workflow: "In Progress", o servidor busca a coluna de workflow pelo nome e filtra pelo seu ID numérico. O mesmo se aplica a labels, tipos, esforços, sprints e user stories — você passa nomes legíveis, o servidor os resolve.

Exemplos de Prompts

Você:  "Filtrar tarefas em progresso atribuídas a @john"
IA:    Chama task action=filter com status="in-progress", users="john"

Você:  "Mostrar todos os bloqueios no sprint atual"
IA:    Chama task action=filter com is_blocker=true, sprint=[slug do sprint atual]

Você:  "Encontrar bugs não atribuídos criados esta semana"
IA:    Chama task action=filter com unassigned=true, type="Bug", created_at="2026-02-02=2026-02-06"

Você:  "Listar todas as tarefas de alta prioridade com label 'frontend'"
IA:    Chama task action=filter com effort="High", labels="frontend"

Você:  "Mostrar tarefas fechadas no mês passado"
IA:    Chama task action=filter com closed_at="2026-01-01=2026-01-31"

Buscando Tarefas por Código

Toda tarefa no GitScrum tem um código legível como PROJ-123. A ação by_code recupera uma tarefa usando este código em vez do UUID. Isso é particularmente útil em conversas onde membros da equipe referenciam tarefas pelo código curto.

Você:  "Encontrar tarefa PROJ-456"
IA:    Chama task action=by_code com task_code="PROJ-456"

Você:  "Qual é o status da AUTH-89?"
IA:    Chama task action=by_code → retorna detalhes completos da tarefa incluindo status

Duplicando Tarefas

A ação duplicate clona uma tarefa com todas as suas propriedades — título, descrição, labels, tipo, esforço e posicionamento na coluna. Isso é útil para criar tarefas similares sem reinserir todos os campos, ou para configurar itens de trabalho recorrentes.

Você:  "Duplicar tarefa [uuid]"
IA:    Chama task action=duplicate → retorna a nova tarefa clonada

Você:  "Clonar a tarefa de relatório semanal para a próxima semana"
IA:    Encontra a tarefa → chama task action=duplicate

Movendo Tarefas

A ação move transfere uma tarefa para um projeto e/ou coluna de workflow diferente. Isso requer o slug do projeto de destino e o ID da coluna de workflow de destino, porque projetos diferentes podem ter configurações de workflow diferentes.

Você:  "Mover tarefa GS-123 para o projeto Frontend"
IA:    Resolve o slug do projeto + workflow → chama task action=move

Você:  "Transferir a tarefa da API para a coluna Done no projeto Backend"
IA:    Chama task action=move com new_project_slug e new_workflow_id

Subtarefas

A ação subtasks lista todas as tarefas filhas de uma tarefa pai específica. Combinada com o parâmetro parent_id da ação create, você pode construir hierarquias completas de tarefas através de linguagem natural.

Você:  "Mostrar subtarefas da tarefa de migração"
IA:    Chama task action=subtasks → retorna lista de tarefas filhas

Você:  "Dividir a tarefa de deployment em: testar staging, atualizar configs, rodar migração"
IA:    Chama task action=create três vezes com parent_id definido para o UUID da tarefa de deployment

Workflow Recomendado

Para equipes adotando gerenciamento de tarefas via MCP, este workflow maximiza a eficiência:

1. Descobrir contexto do projeto

Antes de criar tarefas, busque os metadados do projeto que seu assistente de IA precisa para operações subsequentes.

Você:  "Mostrar os workflows, tipos e esforços do projeto Backend"
IA:    Chama project action=workflows, types, efforts → armazena IDs para operações de tarefas

2. Criar tarefas com contexto completo

Use os metadados armazenados para criar tarefas totalmente configuradas em uma única chamada.

Você:  "Criar um bug de alta prioridade 'Timeout no login mobile' no projeto Backend,
       atribuir a @sarah, adicionar ao sprint atual, rotular como 'mobile' e 'auth'"
IA:    Uma única chamada create com todos os campos preenchidos

3. Acompanhar trabalho diário

Use visualizações pessoais para manter o controle da sua carga de trabalho.

Você:  "O que tenho para hoje?"
IA:    Chama task action=today → mostra sua lista diária de tarefas

4. Filtrar e revisar

Use filtragem avançada para revisões de sprint, standups da equipe ou acompanhamento de progresso.

Você:  "Mostrar todas as tarefas em progresso neste sprint"
IA:    Chama task action=filter com status e sprint

5. Completar e iterar

Marque tarefas como concluídas e verifique o progresso do sprint.

Você:  "Completar a correção do timeout de login"
IA:    Chama task action=complete → atualiza métricas do sprint

Resolução Automática de Contexto

A ferramenta de tarefas suporta resolução automática de contexto. Se o assistente de IA já conhece seu workspace e projeto de uma chamada anterior na mesma conversa, ele pode manter esse contexto. Isso significa que você não precisa repetir "no projeto Backend" para cada operação de tarefa — o assistente de IA lembra o contexto do projeto de antes na conversa.

Quando uma tarefa é criada, atualizada ou recuperada, o servidor MCP retorna metadados de contexto (companyslug, projectslug, task_uuid) que o assistente de IA usa para operações subsequentes.

Próximos Passos

• Sprints: Planeje e acompanhe sprints que contêm suas tarefas.
• Projetos: Gerencie configurações de projeto, workflows e membros da equipe.
• Controle de Tempo: Inicie cronômetros e registre tempo em tarefas.
• Início Rápido: Configure o servidor MCP se ainda não o fez.