Sprints

Gerenciamento do ciclo de vida de sprints pelo MCP. Crie, planeje, inicie, encerre e analise sprints com gerenciamento de projetos potencializado por IA.

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 sprint fornece 10 ações que cobrem o ciclo de vida completo do sprint — desde criação e planejamento de sprints até acompanhamento de progresso, análise de métricas de desempenho e revisão de relatórios detalhados. Toda operação de sprint que sua equipe realiza na aplicação web GitScrum está disponível através de conversas em linguagem natural com seu assistente de IA.

Sprints no GitScrum são iterações com tempo definido que organizam tarefas em ciclos de entrega focados. O MCP Server dá ao seu assistente de IA a capacidade de criar sprints, monitorar velocidade, revisar gráficos de burndown e gerar relatórios de desempenho — tudo sem sair da sua IDE ou cliente de IA.

Visão Geral das Ações

Ação	Propósito	Parâmetros Obrigatórios
`list`	Listar todos os sprints de um projeto	`companyslug`, `project``slug`
`all`	Listar sprints em todos os workspaces	Nenhum
`get`	Obter detalhes completos de um sprint específico	`slug`, `companyslug`, `project``slug`
`create`	Criar um novo sprint com datas e configuração	`companyslug`, `project``slug`, `title`
`update`	Modificar título, datas ou configurações do sprint	`slug`, `companyslug`, `project``slug`
`kpis`	Obter indicadores-chave de desempenho de um sprint	`slug`, `companyslug`, `project``slug`
`stats`	Obter resumo estatístico do progresso do sprint	`slug`, `companyslug`, `project``slug`
`reports`	Gerar relatórios detalhados do sprint (burndown, burnup, desempenho)	`slug`, `companyslug`, `project``slug`
`progress`	Obter progresso de conclusão do sprint em tempo real	`slug`, `companyslug`, `project``slug`
`metrics`	Obter métricas de velocidade e entrega	`slug`, `companyslug`, `project``slug`

Listando Sprints

A ação list retorna todos os sprints dentro de um projeto específico, incluindo seus slugs, títulos, intervalos de datas e status. Cada sprint na resposta inclui seu slug, que você precisa para todas as operações subsequentes de sprint.

A ação all retorna sprints de todos os seus workspaces e projetos. Isso é útil quando você precisa de uma visão entre projetos dos cronogramas de sprint ou quer encontrar um sprint sem saber a qual projeto ele pertence.

Você:  "Listar todos os sprints no projeto Backend"
IA:    Chama sprint action=list → retorna lista de sprints com slugs, datas e status

Você:  "Mostrar sprints em todos os meus projetos"
IA:    Chama sprint action=all → retorna visão geral de sprints entre workspaces

Criando Sprints

A ação create constrói um novo sprint com título, datas e configuração opcional em uma única chamada. Se você omitir as datas, o sprint padrão começa hoje com duração de 7 dias.

Parâmetros Obrigatórios

Parâmetro	Tipo	Descrição
`company_slug`	string	Identificador do workspace (da ferramenta `workspace`)
`project_slug`	string	Identificador do projeto (da ferramenta `project`)
`title`	string	Nome do sprint (ex: "v2.1 Release", "Sprint 14")

Parâmetros Opcionais

Parâmetro	Tipo	Descrição
`date_start`	string	Data de início no formato `YYYY-MM-DD` (padrão: hoje)
`date_finish`	string	Data de término no formato `YYYY-MM-DD` (padrão: hoje + 7 dias)
`description`	string	Descrição do sprint em formato Markdown
`color`	string	Cor hexadecimal sem `#` (ex: `FF5733`) para identificação visual
`is_private`	boolean	Configuração de visibilidade do sprint
`closeonfinish`	boolean	Fechar o sprint automaticamente quando a data de término for atingida

Exemplos de Prompts

Você:  "Criar um sprint 'v2.1 Release' para as próximas 2 semanas"
IA:    Chama sprint action=create com title="v2.1 Release",
      date_start=[hoje], date_finish=[hoje + 14 dias]

Você:  "Iniciar um novo sprint de 1 semana chamado 'Sprint 14' no projeto Backend"
IA:    Chama sprint action=create com title, company_slug, project_slug,
      date_start, date_finish

Você:  "Criar um sprint privado 'Auditoria de Segurança' que fecha automaticamente em 28 de fevereiro"
IA:    Chama sprint action=create com title, is_private=true,
      close_on_finish=true, date_finish="2026-02-28"

Atualizando Sprints

A ação update modifica qualquer propriedade do sprint. Apenas os campos que você especifica são alterados — todo o resto permanece inalterado. Isso é útil para estender prazos, atualizar descrições ou ajustar configurações do sprint durante o ciclo.

Parâmetros Obrigatórios

Parâmetro	Tipo	Descrição
`slug`	string	Slug do sprint (da resposta de `list` ou `get`)
`company_slug`	string	Identificador do workspace
`project_slug`	string	Identificador do projeto

Todos os parâmetros opcionais de create estão disponíveis em update.

Você:  "Estender o sprint atual em 3 dias"
IA:    Obtém sprint atual → chama sprint action=update com novo date_finish

Você:  "Renomear o sprint para 'Estabilização Q1'"
IA:    Chama sprint action=update com title="Estabilização Q1"

Você:  "Adicionar uma descrição ao sprint: 'Foco em melhorias de performance'"
IA:    Chama sprint action=update com description

Detalhes do Sprint

A ação get retorna o objeto completo do sprint, incluindo toda a configuração, datas, contagem de tarefas e metadados. Este é o ponto de partida quando você precisa de informações detalhadas sobre um sprint específico.

Você:  "Mostrar detalhes do Sprint 14"
IA:    Chama sprint action=get → retorna dados completos do sprint incluindo datas,
      contagem de tarefas e configuração

Você:  "Sobre o que é o sprint atual?"
IA:    Encontra o sprint atual/ativo → chama sprint action=get

Analytics de Sprint

A ferramenta de sprint inclui quatro ações de analytics que fornecem diferentes perspectivas sobre o desempenho do sprint. Cada uma retorna dados estruturados que o assistente de IA pode resumir, comparar ou analisar.

KPIs

A ação kpis retorna indicadores-chave de desempenho de um sprint — métricas como taxa de conclusão, velocidade, mudanças de escopo e porcentagem de entrega no prazo. Estes são os números que um gerente de projeto verifica no dashboard do sprint.

Você:  "Quais são os KPIs do sprint atual?"
IA:    Chama sprint action=kpis → retorna taxa de conclusão, velocidade, métricas de escopo

Você:  "Como o Sprint 14 está performando comparado às nossas metas?"
IA:    Chama sprint action=kpis → IA analisa as métricas contra os objetivos

Stats

A ação stats retorna um resumo estatístico — total de tarefas, tarefas concluídas, trabalho restante, distribuição por status e divisão por responsável. Estes são os dados por trás dos widgets de resumo do quadro de sprint.

Você:  "Qual é o status do sprint atual?"
IA:    Chama sprint action=stats → retorna contagem de tarefas por status, distribuição por responsável

Você:  "Quantas tarefas restam no sprint?"
IA:    Chama sprint action=stats → extrai contagem de tarefas restantes

Progresso

A ação progress retorna o progresso de conclusão em tempo real como uma porcentagem, junto com dados de movimentação de tarefas. Esta é a barra de progresso do sprint que você vê na aplicação web GitScrum, exposta como dados estruturados.

Você:  "Qual é o progresso do sprint atual?"
IA:    Chama sprint action=progress → retorna porcentagem concluída, tarefas em cada estado

Você:  "Estamos no caminho certo para terminar o sprint a tempo?"
IA:    Chama sprint action=progress → IA analisa velocidade vs trabalho restante

Métricas

A ação metrics retorna métricas de entrega incluindo velocidade (story points ou contagem de tarefas por sprint), throughput, cycle time e lead time. Estas são as métricas usadas para planejamento de capacidade e retrospectivas.

Você:  "Qual é a velocidade da nossa equipe neste sprint?"
IA:    Chama sprint action=metrics → retorna dados de velocidade

Você:  "Mostrar o cycle time do Sprint 14"
IA:    Chama sprint action=metrics → extrai métricas de cycle time

Relatórios de Sprint

A ação reports gera relatórios detalhados do sprint prontos para gráficos. Você pode solicitar tipos de relatório específicos ou obter todos os relatórios disponíveis de uma vez.

Tipos de Relatório

Relatório	Descrição
`burndown`	Tarefas ou pontos restantes ao longo do tempo. Mostra trajetória ideal vs real de burndown.
`burnup`	Trabalho concluído cumulativo ao longo do tempo. Visualiza mudanças de escopo e ritmo de entrega.
`performance`	Análise de desempenho da equipe incluindo taxas de conclusão de tarefas e tendências de velocidade.
`types`	Distribuição de tarefas por tipo (feature, bug, chore, etc.) dentro do sprint.
`efforts`	Distribuição de tarefas por nível de esforço/prioridade dentro do sprint.
`member_distribution`	Distribuição de carga de trabalho entre membros da equipe.
`tasktypedistribution`	Divisão detalhada de tipos de tarefa com status de conclusão.

Parâmetros

Parâmetro	Tipo	Descrição
`slug`	string	Slug do sprint (obrigatório)
`company_slug`	string	Identificador do workspace (obrigatório)
`project_slug`	string	Identificador do projeto (obrigatório)
`resource`	string	Tipo de relatório específico (opcional — omita para obter todos os relatórios)

Você:  "Mostrar o gráfico de burndown do sprint atual"
IA:    Chama sprint action=reports com resource="burndown" → retorna pontos de dados diários

Você:  "Gerar um relatório completo do Sprint 14"
IA:    Chama sprint action=reports sem resource → retorna todos os dados de relatório

Você:  "Como a carga de trabalho está distribuída na equipe?"
IA:    Chama sprint action=reports com resource="member_distribution"

Você:  "Mostrar os tipos de tarefas neste sprint"
IA:    Chama sprint action=reports com resource="types"

Workflow de Planejamento de Sprint

Para equipes usando gerenciamento de sprint via MCP, este workflow cobre o ciclo de vida completo do sprint:

1. Criar o sprint

Defina as fronteiras do sprint com título e intervalo de datas.

Você:  "Criar um sprint de 2 semanas chamado 'Sprint 15' começando segunda-feira"
IA:    Cria o sprint com datas de início e término calculadas

2. Revisar o backlog

Verifique as tarefas disponíveis antes de atribuir trabalho ao sprint.

Você:  "Mostrar tarefas não atribuídas no projeto Backend"
IA:    Chama task action=filter com unassigned=true → mostra trabalho disponível

3. Adicionar tarefas ao sprint

Atribua tarefas ao sprint recém-criado.

Você:  "Adicionar as 5 tarefas de maior prioridade ao Sprint 15"
IA:    Filtra por prioridade → atualiza cada tarefa com sprint_slug

4. Monitorar progresso

Acompanhe o sprint diariamente para bloqueios e progresso.

Você:  "Como está o Sprint 15?"
IA:    Chama sprint action=progress + action=stats → resume o estado atual

Você:  "Existem bloqueios no sprint?"
IA:    Chama task action=filter com is_blocker=true e sprint="Sprint 15"

5. Revisar relatórios

Analise o desempenho do sprint para retrospectivas e planejamento de capacidade.

Você:  "Gerar os dados de retrospectiva do Sprint 15"
IA:    Chama sprint action=reports → retorna dados de burndown, velocidade e distribuição

Você:  "Comparar nossa velocidade nos últimos 3 sprints"
IA:    Chama sprint action=metrics para cada sprint → IA compara tendências de velocidade

Resolução Automática de Contexto

A ferramenta de sprint suporta resolução automática de contexto. Se o assistente de IA já conhece seu workspace e projeto de uma chamada anterior na conversa, você pode omitir companyslug e projectslug — o servidor MCP os resolve a partir do contexto da conversa.

Isso significa que você pode dizer "Criar um sprint" sem especificar o projeto toda vez, desde que o assistente de IA tenha estabelecido esse contexto antes na conversa.

Sprints Entre Workspaces

A ação all fornece uma visão única de sprints entre workspaces. Isso é particularmente valioso para donos de agência e gerentes que supervisionam múltiplos projetos em diferentes workspaces. A resposta inclui identificadores de workspace e projeto para cada sprint, permitindo que o assistente de IA aprofunde em qualquer sprint específico a partir da visão agregada.

Você:  "Mostrar todos os sprints ativos em todos os meus workspaces"
IA:    Chama sprint action=all → retorna sprints de todos os projetos e workspaces

Você:  "Quais sprints estão terminando esta semana?"
IA:    Chama sprint action=all → IA filtra por date_finish na semana atual

Próximos Passos

Tarefas: Crie e gerencie as tarefas que vivem dentro dos sprints.
Projetos: Configure workflows de projeto, tipos e membros da equipe.
Controle de Tempo: Acompanhe tempo gasto em tarefas do sprint.
Início Rápido: Configure o servidor MCP se ainda não o fez.