O MCP do WiseWork
Compatível com ww1.14.0
Com o MCP do WiseWork, o Claude Code passa a enxergar e atualizar o seu trabalho na plataforma sem você sair do terminal. Em vez de alternar entre o editor e o navegador, você pede em linguagem natural, na mesma sessão em que está programando:
- “Liste minhas tasks abertas”: aparecem as suas tasks, inclusive de outros projetos, sem abrir a plataforma.
- “Mova a #0042 para revisão”: o status muda no WiseWork na hora, e ao concluir ou cancelar o motivo fica registrado.
- “Anexe este print à task”: prints, logs e relatórios vão da sua máquina direto para a task.
- “Crie as tasks desses itens”: vários itens de backlog, features ou tasks são criados de uma vez.
Outras vantagens:
- Funciona em qualquer conversa, não só pelos comandos
/ww. Os comandos usam o MCP por baixo, mas você pode pedir direto. - Sabe em que projeto você está: ele reconhece o projeto pelo repositório git da pasta, e você não precisa repetir o nome a cada pedido.
- Responde com links: cada task, sprint, feature ou relatório citado vem com um link para abrir na plataforma (o instalador já configura o endereço que gera esses links).
- Respeita quem você é: tudo é feito com o seu acesso pessoal, e o autor de cada task ou comentário é você.
O que dá para fazer
Seção intitulada “O que dá para fazer”| Área | O que você consegue |
|---|---|
| Tasks | Criar (também várias de uma vez), buscar pelo número do ticket (#0042), listar com filtros, editar, mudar status, concluir ou cancelar com motivo e atribuir. Ver as suas tasks abertas em todos os projetos |
| Comentários e anexos | Comentar em tasks e itens de backlog, anexar arquivos da sua máquina (até 20 MB) e baixar os anexos existentes |
| Sprints | Criar, listar, atualizar e ver o andamento de uma sprint, com estatísticas e tasks |
| Backlog e features | Criar (também em lote), consultar, listar e atualizar itens de backlog e features |
| Projetos e time | Consultar e atualizar projetos, inclusive os status válidos de cada um, e encontrar membros do time |
| Análise de código | Gravar relatórios de análise e transformar os achados em tasks |
| Regras de código | Consultar os guias de estilo da galeria do WiseWork |
| Contexto de IA | Gerenciar os trechos de contexto que o projeto usa nas gerações por IA |
Os status de task, backlog e feature são por projeto: veja Ticket × título e os três workflows de status.
Como ele é instalado
Seção intitulada “Como ele é instalado”O caminho principal é o instalador: npx -y wisework@latest install --slug=<slug>. Ele pareia a máquina com a sua conta por um código gerado na plataforma, recebe o token pessoal wf_ e registra o servidor com claude mcp add, no escopo de usuário (~/.claude.json, bloco mcpServers.workforce). O servidor não fica instalado: o Claude Code o inicia sob demanda com npx -y @digital-republic-ai/workforce-mcp, o que exige Node.js 18 ou mais novo.
O registro leva três variáveis no bloco env, com valores literais:
| Variável | Obrigatória | O que faz |
|---|---|---|
BASE_URL | Sim | Endereço da API do WiseWork da sua instância |
WORKFORCE_TOKEN | Sim | Seu token pessoal (wf_...). Identifica e autoriza você em cada chamada |
FRONTEND_URL | Não | Endereço da plataforma no navegador. Só serve para as respostas trazerem um link clicável (url) para cada task, sprint, feature, projeto ou relatório. Nunca é enviada à API; sem ela, tudo funciona igual, só que sem os links |
O pacote do servidor fica no GitHub Packages, que exige credencial para download. O instalador busca essa credencial na plataforma e a grava no ~/.npmrc. Sem ela, o npx não baixa o pacote e o servidor não sobe.
Se o MCP workforce já existe, o instalador o mantém quando o token é o mesmo e o registra de novo quando o token mudou (um novo pareamento, por exemplo). Se o registro foi feito por fora do instalador, ele pergunta antes de substituir.
Para registrar à mão, use o /ww:config:mcp. Os mesmos valores aparecem na página Acesso ao MCP da plataforma (/profile/mcp, no menu do usuário).
Identidade e projeto fixado
Seção intitulada “Identidade e projeto fixado”O token diz quem você é; o projeto em que você trabalha fica fixado num arquivo local. O servidor grava os dois no bloco workforce do .dr_ai/settings.json do diretório em que o Claude Code está rodando. Os detalhes de cada chave estão em Os dois arquivos de configuração.
| Ferramenta | O que faz |
|---|---|
workforce_whoami | Resolve o membro do time dono do token e fixa member_id, member_name, email e resolved_at (mais frontend_url, se configurada). Se nenhum projeto está fixado, fixa também o projeto cujo repositório registrado na plataforma bate com um remoto git do diretório |
workforce_context_set | Fixa um projeto padrão (project_id) e/ou o membro (member_id), validando cada um na API antes de gravar |
workforce_context_get | Lê o contexto fixado |
workforce_context_clear | Remove o que está fixado: scope project, member ou all |
Sobre a fixação pelo remoto git:
- SSH e HTTPS do mesmo repositório contam como iguais (a comparação é por
host/dono/repo). - Um projeto já fixado nunca é sobrescrito: se o repositório pertence a outro, a resposta avisa e mantém o atual.
- Nenhum projeto ou mais de um com o mesmo repositório: nada é fixado, e a resposta diz o motivo.
O /ww:init faz esse trabalho por você: chama workforce_whoami e workforce_context_set e deixa identidade e projeto prontos para os outros comandos.
Com um projeto fixado, o servidor o injeta automaticamente nas ferramentas de projeto quando a chamada não traz project_id. Um project_id explícito sempre vence. O member_id nunca é injetado: para “minhas tasks” ou “atribuir a mim”, ele precisa ir na chamada (os comandos /ww leem do contexto fixado). O autor de uma task ou de um comentário é gravado pelo backend a partir do token, nunca pelo que a chamada envia.
Conferir a versão e diagnosticar
Seção intitulada “Conferir a versão e diagnosticar”| Para saber | Como |
|---|---|
| Qual versão está rodando na sessão | Pergunte ao Claude: workforce_whoami e workforce_context_get devolvem mcp_version |
Qual versão o npx baixa | npx @digital-republic-ai/workforce-mcp --version (ou -v) no terminal. Não precisa de token |
Se o ~/.npmrc dá acesso ao pacote | npm view @digital-republic-ai/workforce-mcp version. Um 401, 403 ou 404 indica credencial ausente ou inválida: rode o instalador de novo |
| Se o servidor está registrado | npx -y wisework@latest status ou claude mcp get workforce |
| Se o token e o projeto estão certos | /ww:init, que valida a conexão ao vivo |
As mensagens de erro e o que fazer com cada uma estão em Erros comuns e como remediar.
Referência das ferramentas
Seção intitulada “Referência das ferramentas”Para quem quer os nomes técnicos: o servidor se chama workforce e registra 65 ferramentas. No Claude Code, cada uma aparece com o prefixo do servidor (workforce_tasks_list vira mcp__workforce__workforce_tasks_list nas permissões e nos logs).
| Grupo | Ferramentas | Para quê |
|---|---|---|
| Projetos | workforce_projects_* (4) | Criar, ler, listar e atualizar projetos. O get traz os status válidos de tasks, backlog e features do projeto |
| Tasks | workforce_tasks_*, workforce_task_*, workforce_my_tasks_list (17) | Criar (também em lote), buscar por id ou por ticket (#0042), listar com filtros, editar, mudar status, concluir ou cancelar com motivo, atribuir. workforce_my_tasks_list traz suas tasks abertas em todos os projetos |
| Comentários de task | workforce_task_comments_* (3) | Criar, listar e editar comentários |
| Anexos de task | workforce_task_attachments_* (3) | Anexar um arquivo local (até 20 MB), listar com link de download temporário e remover |
| Sprints | workforce_sprints_*, workforce_sprint_details (6) | Criar, listar, atualizar e detalhar sprints, com estatísticas e tasks |
| Backlog | workforce_backlog_* (5) | Criar (também em lote), ler, listar e atualizar itens de backlog |
| Comentários de backlog | workforce_backlog_comments_* (3) | Criar, listar e editar comentários em itens de backlog |
| Features | workforce_features_* (6) | Criar (também em lote), ler, listar, atualizar e excluir features |
| Entradas de IA | workforce_ai_inputs_* (4) | Gerenciar os trechos de contexto que o projeto injeta nas gerações por IA |
| Relatórios de análise | workforce_analysis_*, workforce_findings_to_tasks (5) | Gravar e consultar relatórios de análise de código e transformar achados em tasks |
| Style guides | workforce_style_guides_* (3) | Listar, ler e ver as categorias dos guias de estilo da galeria |
| Time | workforce_team_members_list, workforce_whoami (2) | Encontrar membros do time e resolver a sua identidade |
| Documentação | workforce_docs (1) | Ler a documentação da API escrita para LLMs |
| Contexto | workforce_context_* (3) | Ler, fixar e limpar o projeto e a identidade fixados |