O MCP do WiseWork
Compatível com dr3.4.25
Com o MCP do WiseWork, o Claude Code passa a enxergar e atualizar o seu trabalho na plataforma sem você sair do terminal. A task que você vai implementar, a feature de que ela faz parte, o status e os comentários ficam ao alcance da mesma sessão em que você programa. Você pede em linguagem natural:
- “Planeje a #0042”: o
/dr:plan:workforce #0042busca a task, a feature dela e as tasks irmãs e monta o plano a partir disso, sem você copiar a descrição. - “Mova a #0042 para revisão”: o status muda no WiseWork na hora, e ao concluir ou cancelar o motivo fica registrado.
- “Anexe o plano e os prints à task”: arquivos da sua máquina vão direto para a task, e quem abrir a task na plataforma lê o plano sem acesso ao seu computador.
- “Liste minhas tasks abertas”: aparecem as suas tasks, inclusive de outros projetos, sem abrir a plataforma.
Outras vantagens:
- O Claude já chega sabendo usar. O plugin carrega em toda sessão as regras de uso do MCP: buscar pelo número do ticket, conferir os status válidos do projeto antes de mudar um, concluir com motivo, anexar evidências em vez de colar o conteúdo no comentário e mostrar o link de cada item.
- Sabe em que projeto e quem é você. Ele reconhece o projeto pelo repositório git da pasta, e o plugin entrega projeto e identidade ao Claude logo no início da sessão. Você não repete nada a cada pedido.
- Sem pedido de permissão a cada chamada. O plugin libera as ferramentas do MCP nas permissões do projeto.
- Funciona em qualquer conversa. Os comandos
/dr:*:workforceusam o MCP por baixo, mas você pode pedir direto, no meio de qualquer tarefa. - Responde com links. Cada task, sprint, feature ou relatório citado vem com um link para abrir na plataforma.
- Respeita quem você é. Tudo é feito com o seu acesso pessoal, e o autor de cada task ou comentário é você.
Os comandos do /dr que usam o MCP
Seção intitulada “Os comandos do /dr que usam o MCP”Três comandos partem de um item do WiseWork, e não de um texto livre. Todos aceitam o número do ticket (#0042 ou 42), o identificador ou parte do título de uma task ou feature.
| Comando | O que faz |
|---|---|
/dr:plan:workforce | Busca a task (com a feature e as tasks irmãs) ou a feature (com as tasks filhas), explora o código para preencher o que falta e só pergunta a você o que é decisão de produto. Gera o plano e o checklist em .dr_ai/tasks/ e não altera código |
/dr:execute:workforce | Faz o mesmo planejamento e segue até o código pronto: implementa com subagentes, revisa a qualidade e o style guide, atualiza a documentação e gera as instruções de deploy |
/dr:fast-execute:workforce | A variante rápida: planeja e implementa, sem as etapas de revisão, documentação e deploy |
No fim, os três devolvem o resultado ao WiseWork, sempre depois de mostrar a você o comentário, os arquivos e o status de destino e pedir confirmação. Numa task, anexam o plano (e, nos comandos de execução, as instruções de deploy e os prints de teste), comentam e mudam o status: “em andamento” no planejamento e “em revisão” na execução, por padrão. Numa feature, que não tem comentários, atualizam o status e as notas.
Se o item já foi planejado antes nesta máquina, os comandos de execução reaproveitam esse plano. Para planejar de novo, use --replan. Os subagentes que escrevem o código não falam com o WiseWork: tudo o que eles precisam vai para os arquivos da task.
O que cada comando faz em detalhe está no catálogo de comandos.
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: cada projeto define os seus, e o Claude consulta a lista do projeto antes de mudar um status.
Como ele é instalado
Seção intitulada “Como ele é instalado”O MCP é registrado pelo mesmo comando que instala o plugin, 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 instalar o plugin sem mexer no MCP, use --skip-mcp.
Para registrar à mão, abra a página Acesso ao MCP da plataforma (/profile/mcp, no menu do usuário). Ela mostra as duas linhas do ~/.npmrc, com a credencial já preenchida, e a entrada workforce para colar no bloco mcpServers do ~/.claude.json, com BASE_URL e FRONTEND_URL já preenchidas. Falta só o seu token wf_, gerado na página de tokens de acesso e exibido uma única vez.
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, o mesmo arquivo de configurações do plugin (veja O diretório .dr_ai).
| 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.
Você não precisa chamar nada disso à mão. Os comandos /dr:*:workforce começam por workforce_whoami, que já fixa você e, se o repositório bater, o projeto. Para fixar outro projeto, peça ao Claude (“fixe o projeto X do WiseWork”), e ele usa workforce_context_set.
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. O autor de uma task ou de um comentário é gravado pelo backend a partir do token, nunca pelo que a chamada envia.
O que o plugin acrescenta
Seção intitulada “O que o plugin acrescenta”O MCP é o mesmo servidor em qualquer plugin. O /dr acrescenta três coisas para que ele funcione bem nas suas sessões:
| O quê | Onde | Efeito |
|---|---|---|
| Regras de uso | ~/.claude/MCP.md, importado pelo ~/.claude/CLAUDE.md | O inventário das ferramentas, o modelo de autenticação e as regras de uso entram em toda sessão. O instalador copia o arquivo, e o hook de início o atualiza quando a versão do plugin muda |
| Contexto da sessão | Hook de início de sessão (módulo load_context) | Lê o bloco workforce do .dr_ai/settings.json e entrega ao Claude projeto, ID do projeto, membro, ID do membro e e-mail fixados. É isso que permite “minhas tasks” sem consultar o contexto antes |
| Permissão | .claude/settings.local.json do projeto | O hook de início acrescenta mcp__workforce a permissions.allow, liberando todas as ferramentas do servidor. Com preferences.manage_project_settings: false no .dr_ai/settings.json, o plugin não mexe nesse arquivo |
Conferir a versão e diagnosticar
Seção intitulada “Conferir a versão e diagnosticar”| Para saber | Como |
|---|---|
| Se o servidor e o token funcionam | Pergunte ao Claude “Quem sou eu no WiseWork?”. A resposta de workforce_whoami traz o seu nome e e-mail |
| 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 um comando /dr:*:workforce não consegue se identificar, ele para e diz o motivo, em vez de seguir sem o WiseWork.
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 |
Os comandos /dr:*:workforce usam um subconjunto dessas ferramentas: identidade, leitura de tasks, features e backlog, status do projeto, comentários, anexos e mudança de status.