GitScrum / Docs

Atividade

Gerenciamento de feed de atividade pelo MCP. Acompanhe e monitore todas as atividades do projeto, alterações e ações da equipe em streams de atividade em tempo real.

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 activity fornece 5 ações para monitorar streams de atividade do projeto em todos os níveis — desde alterações individuais de tarefas até feeds de eventos de todo o workspace. Toda ação que sua equipe realiza no GitScrum gera um registro de atividade, e o MCP Server dá ao seu assistente de IA acesso completo a esta trilha de auditoria através de consultas em linguagem natural.

Feeds de atividade capturam atualizações de tarefas, mudanças de status, comentários, atribuições, ações de sprint e todos os outros eventos do projeto. Seja para uma verificação rápida do que aconteceu enquanto você estava ausente ou uma trilha de auditoria completa para compliance, a ferramenta de atividade fornece o escopo e a granularidade certos.


Visão Geral das Ações

AçãoPropósitoParâmetros Obrigatórios
projectFeed de atividade de um projeto específicocompanyslug, projectslug
taskHistórico de atividade de uma tarefa específicataskuuid, companyslug, project_slug
userFeed de atividade de um usuário específicocompany_slug
workspaceFeed de atividade de todo o workspacecompany_slug
feedFeed de atividade agregado com eventos combinadoscompany_slug

Atividade do Projeto

A ação project retorna o stream de atividade de um projeto específico — todas as atualizações de tarefas, mudanças de status, comentários, eventos de sprint e ações da equipe dentro daquele projeto. Os resultados são ordenados cronologicamente com a atividade mais recente primeiro.

Parâmetros

ParameterTypeDescription
company_slugstringIdentificador do workspace (obrigatório)
project_slugstringIdentificador do projeto (obrigatório)
pageintegerNúmero da página para paginação (opcional)
per_pageintegerResultados por página (opcional)
You:  "Mostre a atividade recente do projeto Backend"
AI:   Chama activity action=project → retorna feed cronológico de atividade

You:  "O que aconteceu no projeto Backend hoje?"
AI:   Chama activity action=project → AI filtra pelas entradas de hoje

You:  "Houve mudanças de status no projeto Mobile App esta semana?"
AI:   Chama activity action=project → AI filtra por eventos de mudança de status

Atividade da Tarefa

A ação task retorna o histórico completo de atividade de uma tarefa específica — cada alteração, comentário, atribuição, transição de status e atualização desde que a tarefa foi criada. Esta é a trilha de auditoria completa para um único item de trabalho.

Parâmetros

ParameterTypeDescription
task_uuidstringUUID da tarefa (obrigatório)
company_slugstringIdentificador do workspace (obrigatório)
project_slugstringIdentificador do projeto (obrigatório)
You:  "O que aconteceu na tarefa PROJ-42?"
AI:   Busca tarefa pelo código → chama activity action=task
      → retorna histórico completo da tarefa com todas as alterações

You:  "Mostre o histórico completo da tarefa de integração de pagamento"
AI:   Resolve a tarefa → chama activity action=task
      → retorna lista cronológica de todos os eventos

You:  "Quem alterou a prioridade da PROJ-42?"
AI:   Chama activity action=task → AI identifica o evento de mudança de prioridade e autor

You:  "Quando esta tarefa foi movida para Em Progresso?"
AI:   Chama activity action=task → AI encontra o evento de mudança de status com timestamp

Atividade do Usuário

A ação user retorna o feed de atividade de um membro específico da equipe — todas as ações dele em projetos dentro do workspace. Útil para entender contribuições individuais, preparar avaliações de desempenho ou acompanhar no que um colega tem trabalhado.

Parâmetros

ParameterTypeDescription
company_slugstringIdentificador do workspace (obrigatório)
usernamestringNome de usuário do alvo (opcional — padrão é o usuário atual)
pageintegerNúmero da página para paginação (opcional)
You:  "No que o John tem trabalhado?"
AI:   Chama activity action=user com username="john"
      → retorna atividade recente do John em todos os projetos

You:  "Mostre minha atividade recente"
AI:   Chama activity action=user → retorna seu próprio feed de atividade

You:  "O que a Sarah fez no projeto Backend na semana passada?"
AI:   Chama activity action=user com username="sarah"
      → AI filtra resultados para o projeto Backend e período da semana passada

Atividade do Workspace

A ação workspace retorna o feed de atividade de todo o workspace — cada evento de cada projeto. Isso fornece a visão mais ampla da atividade organizacional, útil para administradores de workspace e gerentes supervisionando múltiplos projetos.

Parâmetros

ParameterTypeDescription
company_slugstringIdentificador do workspace (obrigatório)
pageintegerNúmero da página para paginação (opcional)
per_pageintegerResultados por página (opcional)
You:  "Mostre o feed de atividade de todo o workspace"
AI:   Chama activity action=workspace → retorna stream de atividade entre projetos

You:  "O que está acontecendo em todos os projetos agora?"
AI:   Chama activity action=workspace → AI resume atividade recente por projeto

You:  "Alguma alteração crítica no workspace hoje?"
AI:   Chama activity action=workspace → AI filtra por eventos de alto impacto

Feed Agregado

A ação feed retorna um feed de atividade combinado e agregado que mescla eventos de múltiplas fontes em um stream unificado. Similar ao workspace, mas otimizado para consumo — eventos são agrupados e deduplicados para facilitar a leitura.

Parâmetros

ParameterTypeDescription
company_slugstringIdentificador do workspace (obrigatório)
You:  "Mostre o feed de atividade"
AI:   Chama activity action=feed → retorna stream de atividade agregado

You:  "Me dê um resumo do que a equipe fez hoje"
AI:   Chama activity action=feed → AI resume e agrupa por membro da equipe ou projeto

Padrões de Monitoramento de Atividade

Feeds de atividade servem diferentes propósitos dependendo do seu papel e contexto. Aqui estão padrões comuns de monitoramento:

Atualização Diária

Quando você começa o dia, use o feed de projeto ou workspace para ver o que aconteceu enquanto você estava ausente.

You:  "O que aconteceu no projeto Backend desde ontem?"
AI:   Chama activity action=project → AI filtra eventos desde ontem
      → "12 eventos: 3 tarefas completadas, 2 novas tarefas criadas, 4 comentários,
         2 mudanças de status, 1 atualização de sprint"

Investigação de Tarefa

Quando você precisa entender por que uma tarefa está no estado atual, a atividade da tarefa fornece o histórico completo.

You:  "Por que a PROJ-42 está bloqueada?"
AI:   Chama activity action=task → revisa histórico por eventos de bloqueio
      → "PROJ-42 foi movida para Bloqueada há 2 dias pela Sarah.
         Comentário: 'Aguardando credenciais de acesso à API de terceiro'"

Revisão de Desempenho da Equipe

Use feeds de atividade de usuários para preparar reuniões 1:1 ou avaliações de desempenho.

You:  "Resuma as contribuições do Mike este mês"
AI:   Chama activity action=user com username="mike"
      → AI agrega: tarefas completadas, PRs revisados, comentários adicionados

You:  "Compare os níveis de atividade da equipe esta semana"
AI:   Chama activity action=workspace → AI agrupa por usuário e conta ações

Monitoramento de Alterações

Acompanhe tipos específicos de alterações no workspace para governança ou compliance.

You:  "Alguma tarefa foi deletada esta semana?"
AI:   Chama activity action=workspace → AI filtra por eventos de exclusão

You:  "Quem fez alterações na Sprint 14?"
AI:   Chama activity action=project → AI filtra por eventos relacionados à sprint

Casos de Uso de Trilha de Auditoria

Dados de atividade servem como uma trilha de auditoria abrangente para seus projetos. Cenários comuns de auditoria:

  • Relatórios de compliance. Exporte dados de atividade para demonstrar quem alterou o quê e quando. Cada ação inclui timestamp, ator e descrição da alteração.
  • Investigação de incidentes. Quando algo dá errado, rastreie o histórico de atividade para identificar a causa raiz — o que mudou, quem mudou e quando.
  • Documentação de decisões. A atividade de tarefas captura comentários e mudanças de status que documentam o raciocínio por trás das decisões. Use activity action=task para reconstruir a linha do tempo de decisões.
  • Análise de carga de trabalho. Agregue dados de atividade de usuários para entender a distribuição de trabalho na equipe. Identifique membros sobrecarregados ou subutilizados.

Paginação

Para projetos com alto volume de atividade, os resultados são paginados. Use os parâmetros page e per_page para navegar pelos resultados. O assistente de IA lida com a paginação automaticamente quando você solicita dados abrangentes.

You:  "Mostre toda a atividade do projeto Backend este mês"
AI:   Chama activity action=project → pagina pelos resultados conforme necessário
      → retorna resumo consolidado de atividade

Próximos Passos

  • Análises: Acesse relatórios estruturados de saúde e desempenho do projeto.
  • Standup: Revise standups diários junto com feeds de atividade.
  • Orçamento: Monitore atividades financeiras e alterações de orçamento.
  • Tarefas: Gerencie as tarefas que geram eventos de atividade.