Visão Geral do MCP
O GitScrum MCP Server oferece aos assistentes de IA acesso operacional completo à sua stack de gerenciamento de projetos através do Model Context Protocol.
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.
O GitScrum MCP Server conecta assistentes de IA ao seu workspace GitScrum através do Model Context Protocol. Ele expõe 29 ferramentas com mais de 160 operações em 6 categorias, dando ao seu assistente de IA as mesmas capacidades operacionais que sua equipe usa diariamente na aplicação web GitScrum — gerenciamento de tarefas, planejamento de sprints, controle de tempo, CRM, analytics e mais.
Tudo o que sua equipe faz na aplicação web GitScrum, seu assistente de IA agora pode fazer através de conversas em linguagem natural.
O que é o Model Context Protocol?
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA interajam com ferramentas externas e fontes de dados de forma estruturada e segura. Em vez de copiar e colar dados entre sua ferramenta de gerenciamento de projetos e seu assistente de IA, o MCP cria uma ponte direta.
Com o GitScrum MCP Server em execução, seu assistente de IA pode:
- Consultar seus workspaces, projetos e tarefas em tempo real
- Criar e atualizar tarefas, sprints, user stories e epics
- Rastrear tempo, gerar relatórios de standup e revisar analytics
- Gerenciar clientes, faturas e propostas pelo ClientFlow CRM
- Pesquisar em toda a sua stack de gerenciamento de projetos
Tudo isso acontece através de linguagem natural. Você faz uma pergunta ou dá uma instrução ao seu assistente de IA, e ele chama as ferramentas MCP apropriadas do GitScrum nos bastidores.
Por que Usar MCP para Gerenciamento de Projetos
O gerenciamento de projetos tradicional exige troca constante de contexto — abrindo abas do navegador, navegando por dashboards, preenchendo formulários. O MCP elimina essa fricção permitindo que seu assistente de IA cuide do trabalho operacional enquanto você mantém o foco no que importa.
Operações em linguagem natural. Em vez de navegar por menus para criar uma tarefa, diga "Crie um bug de alta prioridade no projeto Auth para o problema de timeout no login" e o assistente de IA cuida do mapeamento de campos, seleção de projeto e criação da tarefa.
Inteligência entre ferramentas. Seu assistente de IA pode correlacionar dados entre ferramentas. Pergunte "Quais projetos estão acima do orçamento e têm tarefas atrasadas?" e ele consulta acompanhamento de orçamento, filtros de tarefas e dados de sprint em uma única conversa.
Automação sem scripts. Fluxos de trabalho complexos que exigiriam scripts de API tornam-se conversacionais. "Crie um sprint para a próxima semana, adicione os 5 principais itens do backlog e atribua-os à equipe de frontend" executa múltiplas operações sequencialmente.
Visibilidade para toda a equipe. Qualquer membro da equipe com um cliente compatível com MCP pode interagir com os mesmos dados do projeto. Desenvolvedores, gerentes e stakeholders se beneficiam do acesso conversacional à stack de gerenciamento de projetos.
Categorias de Ferramentas
O GitScrum MCP Server organiza suas 29 ferramentas em seis categorias. Cada ferramenta usa um parâmetro consolidado action, reduzindo os tokens de contexto do LLM em aproximadamente 80% em comparação com definições individuais de ferramentas.
Core
As ferramentas fundamentais para operações diárias de gerenciamento de projetos.
| Ferramenta | Ações Principais | Propósito |
|---|---|---|
task | my today get create update complete subtasks filter by_code duplicate move notifications | Gerenciamento completo do ciclo de vida de tarefas |
sprint | list all get kpis create update stats reports progress metrics | Planejamento e acompanhamento de sprints |
workspace | list get | Navegação entre workspaces |
project | list get stats tasks workflows types efforts labels members | Configuração e dados do projeto |
time | active start stop logs analytics team reports productivity timeline | Controle de tempo e produtividade |
Planejamento
Ferramentas para refinamento de backlog, mapeamento de histórias e configuração de workflows.
| Ferramenta | Ações Principais | Propósito |
|---|---|---|
user_story | list get create update all | Gerenciamento de user stories |
epic | list create update | Planejamento em nível de epic |
label | list create update attach detach toggle | Taxonomia de labels |
task_type | list create update assign | Configuração de tipos de tarefa |
workflow | create update | Estágios do workflow Kanban |
Colaboração
Ferramentas para comunicação da equipe, documentação e gestão de conhecimento.
| Ferramenta | Ações Principais | Propósito |
|---|---|---|
discussion | all channels channel messages send search unread markread createchannel update_channel | Mensagens e canais da equipe |
comment | list add update | Comentários em tarefas e itens |
wiki | list get create update search | Documentação do projeto |
note | list get create update share revisions | Notas pessoais e compartilhadas |
note_folder | list create update move | Organização de notas |
search | — | Pesquisa full-text em todos os dados |
ClientFlow CRM
Ferramentas de gerenciamento de relacionamento com clientes, faturamento e propostas.
| Ferramenta | Ações Principais | Propósito |
|---|---|---|
client | list get create update contacts interactions add_interaction | Gerenciamento de clientes |
invoice | list get stats create update issue send mark_paid | Ciclo de vida de faturas |
proposal | list get stats create update send approve reject convert | Gerenciamento de propostas |
clientflow_dashboard | 8 relatórios | Analytics e relatórios de CRM |
clientflowcrossworkspace | 4 relatórios | Dados de CRM entre workspaces |
Insights PRO
Analytics avançado, automação de standup e monitoramento de orçamento.
| Ferramenta | Ações Principais | Propósito |
|---|---|---|
standup | summary completed blockers team stuck digest contributors | Relatórios automatizados de standup |
analytics | 10 relatórios | Analytics do dashboard gerencial |
activity | feed userfeed notifications activities taskworkflow | Feed de atividades e trilha de auditoria |
budget | projectsatrisk overview consumption burn_down alerts events | Acompanhamento e alertas de orçamento |
Autenticação
Ferramentas de gerenciamento de sessão segura.
| Ferramenta | Descrição |
|---|---|
auth_login | Iniciar fluxo de código de dispositivo OAuth 2.0 |
auth_complete | Completar autorização no navegador |
auth_status | Verificar sessão atual e validade do token |
auth_logout | Limpar credenciais armazenadas localmente |
Clientes Suportados
O GitScrum MCP Server funciona com qualquer cliente que implemente o Model Context Protocol. Clientes testados e verificados:
| Cliente | Plataforma | Configuração |
|---|---|---|
| Claude Desktop | macOS, Windows | claudedesktopconfig.json |
| GitHub Copilot | VS Code | .vscode/mcp.json |
| Cursor | macOS, Windows, Linux | Configurações MCP do Cursor |
| Windsurf | macOS, Windows, Linux | Configurações MCP do Windsurf |
| Continue | VS Code, JetBrains | Configuração do Continue |
Todos os clientes usam o mesmo binário do MCP Server. A única diferença é a localização e o formato do arquivo de configuração de cada cliente.
Modelo de Segurança
O GitScrum MCP Server é projetado em torno do princípio de menor privilégio com múltiplas camadas de proteção.
| Camada | Proteção |
|---|---|
| Operações | Apenas CREATE, READ, UPDATE. DELETE é bloqueado nas camadas MCP e API. |
| Autenticação | OAuth 2.0 Device Grant (RFC 8628) — credenciais nunca tocam o servidor MCP. |
| Transporte | Comunicação exclusivamente HTTPS com TLS 1.2 no mínimo. |
| Armazenamento de tokens | Sistema de arquivos local (~/.gitscrum/auth.json) com permissões restritas. |
| Rate limiting | Bloqueio automático após tentativas de autenticação falhas. |
Sem operações DELETE. Esta é uma decisão de design deliberada. Assistentes de IA não devem ser capazes de destruir permanentemente dados de projetos. Todas as operações destrutivas devem ser realizadas pela aplicação web GitScrum Studio, onde confirmação humana é necessária.
Exemplos de Conversas
Aqui estão exemplos práticos do que você pode realizar através de linguagem natural:
Você: "O que tenho para hoje?"
IA: Busca suas tarefas com vencimento hoje em todos os projetos.
Você: "Crie um sprint para a próxima semana com os 5 principais itens do backlog"
IA: Cria o sprint, atribui tarefas e define o cronograma.
Você: "Mostre quais projetos estão acima do orçamento"
IA: Retorna dados de burn-down e sinaliza projetos em risco.
Você: "Envie a proposta do Q1 para a Acme Corp"
IA: Cria a proposta, vincula o cliente e envia.
Você: "O que a equipe entregou esta semana?"
IA: Gera um resumo de standup com trabalho concluído e bloqueios.Arquitetura
O MCP Server roda como um processo local na sua máquina. Ele se comunica com clientes de IA via Model Context Protocol (transporte stdio) e com a API do GitScrum via HTTPS.
┌────────────────┐ MCP (stdio) ┌──────────────┐ HTTPS ┌─────────────┐
│ Assistente IA │ ◄──────────────────► │ MCP Server │ ◄───────────► │ GitScrum API │
│ (Claude, etc) │ │ (local) │ │ (cloud) │
└────────────────┘ └──────────────┘ └─────────────┘- Assistente IA envia chamadas de ferramentas pelo protocolo MCP
- MCP Server valida requisições, gerencia autenticação e encaminha para a API do GitScrum
- API do GitScrum processa a requisição com controle de acesso completo e retorna dados estruturados
O servidor é stateless entre sessões, exceto pelo token de autenticação armazenado localmente. Nenhum dado de projeto é cacheado ou armazenado em disco.
Requisitos
| Requisito | Mínimo |
|---|---|
| Node.js | 18.0.0 ou superior |
| npm | 8.0.0 ou superior |
| Conta GitScrum | Plano gratuito ou pago |
| Cliente MCP | Qualquer cliente compatível com MCP |
Próximos Passos
- Início Rápido: Instale e autentique em menos de 5 minutos.
- Configuração: Configuração detalhada para Claude Desktop, GitHub Copilot, Cursor e outros clientes.
- Autenticação: Aprofundamento no fluxo OAuth 2.0 Device Grant.
- Segurança: Modelo de segurança enterprise, tratamento de erros e boas práticas.