Workflows

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 workflow fornece 2 ações para inspecionar a configuração de workflow Kanban do seu projeto — a estrutura de colunas que define como as tarefas se movem de "a fazer" por "em progresso" até "concluído." Embora as colunas de workflow sejam configuradas na aplicação web GitScrum, o MCP Server dá ao seu assistente de IA acesso de leitura à estrutura completa do workflow, o que é essencial para criar tarefas na coluna correta, mover tarefas entre estágios e entender o processo da sua equipe.

Workflows no GitScrum definem os estágios visuais e lógicos do seu quadro Kanban. Cada coluna tem um id único (o workflow_id), um título, uma posição e uma cor. O MCP Server expõe esses metadados para que seu assistente de IA possa referenciar colunas por nome e resolvê-las para os IDs numéricos corretos que a ferramenta task requer.

Visão Geral das Ações

Listando Colunas de Workflow

A ação list retorna todas as colunas Kanban configuradas para um projeto específico, em sua ordem de exibição. Cada coluna na resposta inclui seu id (usado como workflow_id em operações de tarefa), uuid, título, posição e cor. Esta é a fonte definitiva de verdade para a estrutura de workflow do seu projeto.

Seu assistente de IA tipicamente chama esta ação como parte da fase de coleta de contexto — antes de criar tarefas ou movê-las entre colunas, ele precisa saber quais colunas existem e quais são seus IDs.

Parâmetros Obrigatórios

Estrutura da Resposta

Cada coluna de workflow na resposta inclui:

Exemplos de Prompts

Você:  "Mostrar todas as colunas de workflow no projeto Backend"
IA:    Chama workflow action=list → retorna colunas com IDs, títulos e posições

Você:  "Quais colunas Kanban estão disponíveis?"
IA:    Chama workflow action=list → apresenta a estrutura do quadro: Backlog → To Do →
      In Progress → Code Review → QA → Done

Você:  "Listar os estágios de workflow do projeto Frontend"
IA:    Chama workflow action=list → retorna a configuração de colunas

Você:  "Como nosso quadro Kanban está estruturado?"
IA:    Chama workflow action=list → descreve o fluxo de colunas da esquerda para a direita

Obtendo Detalhes da Coluna

A ação get retorna os detalhes completos de uma coluna de workflow específica, incluindo todos os metadados e propriedades de configuração. Isso é útil quando você precisa de informações detalhadas sobre um estágio particular do seu workflow.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Mostrar detalhes da coluna 'In Progress'"
IA:    Encontra a coluna via list → chama workflow action=get → retorna detalhes completos

Você:  "Qual é a configuração da coluna Code Review?"
IA:    Chama workflow action=get com o UUID da coluna → retorna metadados completos

Como Workflows se Conectam a Tarefas

Os IDs das colunas de workflow são a base para posicionamento de tarefas no quadro Kanban. Entender esta conexão é essencial para gerenciamento eficaz de projetos via MCP.

Criando tarefas em uma coluna específica

Ao criar uma tarefa, você pode posicioná-la em uma coluna específica usando:

• column (string): O nome da coluna (ex: "In Progress"). O servidor MCP resolve isso para o workflow_id correto automaticamente.
• workflow_id (number): O ID numérico da coluna da lista de workflows. Use quando já tiver o ID de uma chamada anterior de workflow action=list.

O parâmetro column é recomendado para a maioria dos casos de uso porque é mais natural na conversa. O servidor MCP lida com a resolução de nome para ID nos bastidores.

Você:  "Criar uma tarefa 'Corrigir validação de login' na coluna In Progress"
IA:    Chama task action=create com column="In Progress"
      → servidor MCP resolve para workflow_id automaticamente

Você:  "Adicionar uma tarefa à coluna Code Review"
IA:    Chama task action=create com column="Code Review"

Movendo tarefas entre colunas

Ao atualizar a coluna de uma tarefa, você pode usar o mesmo parâmetro column:

Você:  "Mover tarefa GS-123 para Done"
IA:    Chama task action=update com column="Done"
      → servidor MCP resolve o nome da coluna para workflow_id

Você:  "Mover a correção de login para Code Review"
IA:    Chama task action=update com column="Code Review"

Transferindo tarefas entre projetos

Ao mover uma tarefa para um projeto diferente usando task action=move, você precisa do newworkflowid do projeto de destino. Projetos diferentes podem ter configurações de workflow diferentes, então o assistente de IA precisa listar os workflows do projeto de destino primeiro:

Você:  "Mover tarefa GS-123 para o Backlog do projeto Frontend"
IA:    1. Chama workflow action=list para o projeto Frontend
      2. Encontra o ID da coluna "Backlog"
      3. Chama task action=move com new_project_slug e new_workflow_id

Resolução Inteligente de Colunas

O MCP Server inclui resolução integrada de nomes de colunas — uma funcionalidade que economiza uma chamada extra de API ao seu assistente de IA em muitos cenários. Quando você passa um parâmetro column por nome para as ações create ou update da ferramenta task, o servidor:

1. Busca a configuração de workflow do projeto
2. Encontra o nome da coluna correspondente (sem distinção entre maiúsculas e minúsculas)
3. Resolve para o workflow_id numérico
4. Executa a operação de tarefa com o ID correto

Se o nome da coluna não corresponder a nenhuma coluna existente, o servidor retorna uma mensagem de erro que inclui a lista de nomes de colunas disponíveis. Isso permite que o assistente de IA sugira o nome correto para você:

Você:  "Mover a tarefa para Review"
IA:    Tenta column="Review" → servidor retorna "Coluna não encontrada. Colunas disponíveis:
      Backlog, To Do, In Progress, Code Review, QA, Done"
IA:    "Não encontrei uma coluna 'Review'. Você quis dizer 'Code Review'?"

Gerenciamento de Tarefas Baseado em Colunas

Colunas de workflow possibilitam consultas e operações poderosas de tarefas. Combinando conhecimento de workflow com a ação filter da ferramenta task, seu assistente de IA pode responder perguntas no nível do quadro:

Verificando conteúdo das colunas

Você:  "Quais tarefas estão na coluna In Progress?"
IA:    Chama task action=filter com workflow="In Progress"
      → retorna todas as tarefas atualmente nessa coluna

Você:  "Quantas tarefas estão em Code Review?"
IA:    Chama task action=filter com workflow="Code Review"
      → conta e reporta os resultados

Você:  "Mostrar o Backlog"
IA:    Chama task action=filter com workflow="Backlog"
      → retorna todas as tarefas na coluna Backlog

Identificando gargalos

Você:  "Qual coluna tem mais tarefas?"
IA:    Chama workflow action=list → para cada coluna, chama task action=filter
      → identifica a coluna com maior contagem de tarefas

Você:  "Existem gargalos no nosso workflow?"
IA:    Analisa contagem de tarefas por coluna → sinaliza colunas com contagem
      desproporcionalmente alta de tarefas em relação às outras

Você:  "Há quanto tempo as tarefas estão paradas em Code Review?"
IA:    Chama task action=filter com workflow="Code Review"
      → analisa datas de criação e tempo na coluna

Consultas para standup diário

Você:  "Dar um resumo de standup: o que moveu ontem, o que está em progresso,
       e o que está bloqueado?"
IA:    Filtra tarefas por coluna e atividade recente → gera relatório estruturado
      de standup cobrindo Done (ontem), In Progress (hoje) e itens bloqueados

Configurações Típicas de Workflow

Embora cada equipe configure seu quadro de forma diferente, estes são padrões comuns de workflow que você encontrará:

Workflow simples

Backlog → In Progress → Done

Workflow de desenvolvimento

Backlog → To Do → In Progress → Code Review → QA → Done

Workflow de agência

Brief → Design → Development → Review → Client Approval → Done

Workflow de suporte

New → Triaged → In Progress → Resolved → Closed

O MCP Server funciona com qualquer configuração — seu assistente de IA se adapta a quaisquer colunas que seu projeto use lendo a estrutura do workflow no início da conversa.

Resolução Automática de Contexto

A ferramenta de workflow suporta resolução automática de contexto. Se o assistente de IA já conhece seu workspace e projeto de uma chamada anterior na conversa, ele mantém esse contexto. Além disso, quando a resolução inteligente de colunas da ferramenta task é usada, a busca de workflow acontece automaticamente — você não precisa chamar explicitamente workflow action=list antes de cada operação de tarefa.

Próximos Passos

• Tarefas: Crie e mova tarefas entre colunas de workflow.
• Tipos de Tarefa: Configure tipos de tarefa para categorizar trabalho dentro das colunas.
• Sprints: Acompanhe como as tarefas fluem pelas colunas durante um sprint.
• Projetos: Gerencie as configurações do projeto que incluem configuração de workflow.
• Início Rápido: Configure o servidor MCP se ainda não o fez.