Labels

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 label fornece 6 ações para gerenciar labels — o sistema de tags entre projetos que dá à sua equipe categorização flexível além de workflows fixos. Labels permitem fatiar o trabalho por área de funcionalidade, tecnologia, prioridade, equipe ou qualquer dimensão personalizada que sua organização precise. Através do MCP Server, seu assistente de IA pode criar labels, vinculá-los a tarefas, alterná-los e gerenciar toda a sua taxonomia de rotulação.

Labels no GitScrum operam no nível do workspace, o que significa que um label criado no seu workspace está disponível em todos os projetos. Isso dá a você um vocabulário consistente para categorizar trabalho, seja uma tarefa no projeto Backend, no projeto Frontend ou em qualquer outro lugar. Quando você vincula um label a uma tarefa, ele se torna uma dimensão filtrável — você pode usar a ação filter da ferramenta task para encontrar todas as tarefas com um label específico em qualquer projeto.

Visão Geral das Ações

Listando Labels

A ação list retorna todos os labels no workspace. Cada label na resposta inclui seu slug, título e cor. Como labels têm escopo de workspace, esta única chamada fornece a taxonomia completa de labels disponível em todos os projetos.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Listar todos os labels disponíveis"
IA:    Chama label action=list → retorna todos os labels do workspace com títulos e cores

Você:  "Quais labels temos configurados?"
IA:    Chama label action=list → apresenta a taxonomia completa de labels

Você:  "Mostrar as cores de labels que estamos usando"
IA:    Chama label action=list → exibe labels com suas cores associadas

Criando Labels

A ação create constrói um novo label com título e cor. Tanto o título quanto a cor são obrigatórios — todo label deve ser visualmente distinto para que membros da equipe possam identificá-los de relance no quadro Kanban.

Parâmetros Obrigatórios

Padrões Comuns de Labels

Equipes tipicamente estabelecem labels ao longo de uma ou mais dessas dimensões:

Exemplos de Prompts

Você:  "Criar um label 'bug' com cor vermelha FF0000"
IA:    Chama label action=create com title="bug", color="FF0000"

Você:  "Criar labels para nosso workflow de desenvolvimento: 'frontend' em azul,
       'backend' em verde, 'mobile' em laranja"
IA:    Chama label action=create três vezes com títulos e cores distintos

Você:  "Adicionar um label 'tech-debt' com cor roxa"
IA:    Chama label action=create com title="tech-debt", color="8B5CF6"

Você:  "Criar um label 'needs-review' em amarelo"
IA:    Chama label action=create com title="needs-review", color="F59E0B"

Atualizando Labels

A ação update modifica o título ou cor de um label existente. Isso é útil quando você precisa renomear um label para refletir melhor seu propósito ou alterar sua cor para melhor consistência visual.

Parâmetros Obrigatórios

Parâmetros Opcionais

Exemplos de Prompts

Você:  "Renomear o label 'bug' para 'defect'"
IA:    Chama label action=update com label_slug, title="defect"

Você:  "Mudar a cor do label 'urgent' para vermelho escuro"
IA:    Chama label action=update com label_slug, color="DC2626"

Você:  "Atualizar o label 'frontend' para 'client-side' e mudar a cor para teal"
IA:    Chama label action=update com title="client-side", color="14B8A6"

Vinculando Labels a Tarefas

A ação attach adiciona um label a uma tarefa específica. Uma tarefa pode ter múltiplos labels simultaneamente, permitindo categorização multidimensional. Por exemplo, uma tarefa pode ser rotulada tanto como "bug" quanto "frontend" para indicar que é um bug de front-end.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Vincular o label 'bug' à tarefa [uuid]"
IA:    Chama label action=attach com label_slug="bug", task_uuid, project_slug

Você:  "Rotular a tarefa de login como 'frontend' e 'urgent'"
IA:    Chama label action=attach duas vezes — uma para cada label

Você:  "Adicionar o label 'needs-review' a todas as tarefas na coluna Done"
IA:    Filtra tarefas por coluna de workflow → chama label action=attach para cada tarefa

Desvinculando Labels de Tarefas

A ação detach remove um label de uma tarefa específica. O label em si permanece no workspace — apenas a associação com a tarefa é removida.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Remover o label 'urgent' da tarefa [uuid]"
IA:    Chama label action=detach com label_slug="urgent", task_uuid

Você:  "O bug de login foi corrigido — remover o label 'bug'"
IA:    Encontra a tarefa → chama label action=detach com label_slug="bug"

Alternando Labels

A ação toggle é uma ação de conveniência que combina attach e detach em uma única chamada. Se o label está atualmente na tarefa, toggle o remove. Se o label não está na tarefa, toggle o adiciona. Isso é particularmente útil quando o assistente de IA não sabe o estado atual do label na tarefa — ele pode alternar sem verificar primeiro.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Alternar o label 'blocked' na tarefa [uuid]"
IA:    Chama label action=toggle → adiciona ou remove o label baseado no estado atual

Você:  "Trocar o label 'needs-review' na tarefa de deployment"
IA:    Chama label action=toggle com o label_slug e task_uuid apropriados

Estratégia de Rotulação

Uma taxonomia de labels bem projetada torna filtragem e relatórios significativamente mais poderosos. Aqui estão práticas recomendadas para equipes adotando gerenciamento de labels via MCP:

Mantenha labels planos e combináveis

Em vez de criar labels profundamente específicos como "frontend-bug-critical", crie labels independentes ("frontend", "bug", "critical") e combine-os nas tarefas. Isso dá mais flexibilidade na filtragem — encontre todos os bugs, todo o trabalho de frontend, ou especificamente bugs críticos de frontend.

Estabeleça convenções de nomenclatura

Use nomes em minúsculas separados por hífen para consistência: tech-debt, needs-review, api-v2. Isso torna os labels previsíveis ao referenciá-los em conversas com IA.

Use labels com filtragem de tarefas

Labels desbloqueiam filtragem poderosa através da ação filter da ferramenta task:

Você:  "Mostrar todas as tarefas com label 'tech-debt' no projeto Backend"
IA:    Chama task action=filter com labels="tech-debt"

Você:  "Encontrar todas as tarefas 'blocked' no sprint atual"
IA:    Chama task action=filter com labels="blocked", sprint=[sprint atual]

Você:  "Quantas tarefas 'bug' ainda estão abertas?"
IA:    Chama task action=filter com labels="bug", status="todo"
      → conta os resultados

Resolução Automática de Contexto

A ferramenta de labels suporta resolução automática de contexto. Como labels têm escopo de workspace, o assistente de IA precisa apenas do companyslug para listar e criar labels. Para operações em nível de tarefa (attach, detach, toggle), o projectslug também é necessário porque tarefas vivem dentro de projetos específicos.

Próximos Passos

• Tarefas: Vincule labels a tarefas e use filtragem baseada em labels.
• Tipos de Tarefa: Configure tipos de tarefa para categorização estrutural junto com labels.
• Sprints: Filtre tarefas do sprint por label para revisões focadas.
• Início Rápido: Configure o servidor MCP se ainda não o fez.