Quadro de tarefas para o Claude Code: configuração real em dois minutos com MCP

Para dar um quadro de tarefas ao Claude Code, corra um comando, claude mcp add --transport http weft https://letsweft.com/api/mcp, e depois inicie sessão no Weft no navegador da primeira vez que o Claude Code se ligar. Não há nenhuma chave para copiar nem nada para colar num ficheiro de configuração. A partir daí, um bloco curto no CLAUDE.md faz com que o Claude Code assuma uma tarefa antes de editar código, reporte o progresso enquanto trabalha e deixe um comprovativo quando termina.

Nós fazemos o Weft. Os factos sobre outros produtos vêm das respetivas páginas oficiais, verificadas a 27 de outubro de 2026.

O que dá um quadro ao Claude Code que o terminal não dá?

O Claude Code conhece o repositório que tem à frente, mas não sabe quem mais está a trabalhar nem que tarefa uma sessão que falhou tinha começado. Um quadro guarda esse estado fora de qualquer sessão, para que uma pessoa, uma segunda janela do Claude Code e uma conversa no ChatGPT vejam a mesma coisa.

Não precisa de um para cada repositório. Uma pessoa, uma sessão curta e uma lista de TODO muitas vezes chegam. O quadro começa a compensar quando o trabalho se estende por várias sessões ou vários agentes, ou quando uma pessoa tem de ver os resultados antes de contarem.

Como ligar o Claude Code ao Weft em dois minutos?

1. Crie uma conta gratuita em letsweft.com. Um quadro novo começa com quatro colunas: Backlog, Todo, Doing e Done.
2. No terminal, corra claude mcp add --transport http weft https://letsweft.com/api/mcp. O Claude Code guarda o servidor para o projeto atual; acrescente --scope user se o quiser em todos os projetos (veja a documentação MCP do Claude Code, da Anthropic).
3. Inicie o claude. Da primeira vez que o Weft é usado, abre-se uma janela do navegador para o OAuth. Se não abrir, escreva /mcp, escolha weft e autentique-se a partir daí.
4. No ecrã de consentimento do Weft, escolha o que esta ligação pode fazer: total, escrita (tudo exceto as três ferramentas destrutivas) ou leitura. Pode alterá-lo mais tarde em Definições → Clientes de IA ligados.
5. De volta ao Claude Code, pergunte: "O que tenho no meu quadro?"

O endpoint fala MCP sobre Streamable HTTP e expõe 32 ferramentas. O Weft emite refresh tokens, por isso o cliente renova a sessão sozinho. Se usar um cliente que não suporta OAuth, um token de acesso pessoal também funciona, mas o Claude Code não precisa de nenhum. A página de configuração completa está em letsweft.com/claude-code.

Como confirmar que funciona sem o deixar alterar nada?

Faça com que o primeiro pedido seja só de leitura. Isso diz-lhe que as ferramentas estão carregadas e que o início de sessão chegou ao workspace certo, e nada no quadro se mexe:

Mostra o meu quadro do Weft: as colunas, o que está em Doing e o que está à minha espera.
Não alteres nada.

O Claude Code deve chamar get_board_state ou get_my_work. Ambas são ferramentas só de leitura. Se quiser uma margem de segurança enquanto se habitua, defina a ligação como leitura no ecrã de consentimento: as chamadas de escrita passam a ser recusadas, e as chamadas recusadas não contam para a sua quota mensal.

Um custo, com honestidade: as definições das 32 ferramentas ocupam cerca de 18 000 tokens do contexto do Claude Code.

Como é uma tarefa assumida, do princípio ao fim?

Ponha uma tarefa pequena e real em Todo, por exemplo "corrigir o teste de datas instável", e peça ao Claude Code que pegue nela. Uma boa execução corre assim:

1. get_my_work devolve o que já pertence a este cliente, o que está à sua espera e se há espaço para começar alguma coisa.
2. start_task assume a tarefa, move-a para Doing e devolve um runId e um leaseToken. A resposta também diz ao agente para renovar a cada 300 segundos.
3. O Claude Code trabalha no repositório como de costume. De poucos em poucos minutos chama report_progress, que renova o lease.
4. Se chegar a uma decisão que só o utilizador pode tomar, chama request_input com opções. O Claude Code mostra a pergunta com os seus cartões de opções nativos; a resposta volta através de submit_answer.
5. complete_task fecha a execução com um resultado, artefactos como o hash do commit e o resultado dos testes, e o que não fez.

Por omissão, uma tarefa concluída vai diretamente para Done. Em vez disso, para na sua Caixa de entrada quando a tarefa precisa de revisão ou quando uma verificação falha. Aí escolhe Aceitar, Retrabalhar, Depois ou Descartar. Se o agente indicou um nextStep, como "fazer merge do PR #12", Aceitar aprova exatamente esse passo, que volta ao agente para ser executado.

O ciclo completo, com todas as recusas e campos, está no guia do ciclo de assumir tarefas.

O que devo pôr no CLAUDE.md?

As descrições das ferramentas já trazem estas regras; algumas linhas no CLAUDE.md fazem delas um hábito do repositório. Cole e ajuste:

## Quadro de tarefas do Weft

O Weft (servidor MCP "weft") é o quadro partilhado deste repositório. Outros
clientes de IA e pessoas também o leem, por isso mantém-no fiel à realidade.

- No início de uma sessão, chama get_my_work. Trabalha no que ele devolver;
  não escolhas tarefas de memória.
- Antes de alterares qualquer ficheiro para uma tarefa, chama start_task com o id dela.
  Guarda o runId e o leaseToken que devolve.
  - already_claimed: outra pessoa ou agente tem a tarefa. Não dupliques; escolhe outra.
  - attention_queue_full: não tentes de novo. Faz o que a resposta sugere
    (terminar ou esclarecer trabalho existente).
- Enquanto trabalhas, chama report_progress com runId e leaseToken mais ou menos
  a cada 5 minutos, e em cada marco real (testes a verde, PR aberto).
- Chama request_input só para decisões que cabem à pessoa: qualquer coisa
  irreversível (produção, dinheiro, publicação, eliminar dados) ou uma bifurcação
  real sem opção por omissão sensata. Dá opções. Nunca peças licença para continuar.
- Quando terminares, chama complete_task com:
  - outcome: uma ou duas frases sobre o que mudou
  - artifacts: hash do commit, URL do PR, comando de testes e o seu resultado
  - notDone: o que saltaste ou deixaste para depois
  - unknowns: o que não conseguiste verificar
  - nextStep: o único passo que darias se a pessoa aceitar
- Se parares sem terminar, di-lo e deixa a tarefa em Doing.

Os artefactos transformam "feito" em algo que pode verificar. A chamada nunca falha por falta de provas, porque perder trabalho terminado é pior do que registá-lo sem verificação.

O que acontece quando uma sessão do Claude Code morre a meio de uma tarefa?

Ninguém tem de limpar depois dela. Assumir uma tarefa é um lease, não uma marca. start_task concede 20 minutos, e cada report_progress renova-os. Uma sessão que falha, perde a rede ou é fechada não consegue reportar, por isso o silêncio é o sinal.

• Ao fim de 20 minutos sem sinal de vida, a execução é marcada como inativa, o token do lease é apagado e a tarefa volta a ficar sem responsável.
• Uma varredura corre a cada 10 minutos, e a tarefa também é libertada de imediato quando outro cliente tenta assumi-la.
• Uma execução que está à espera da sua resposta mantém a tarefa assumida durante 60 minutos. Depois disso o lease cai, mas a pergunta continua aberta na sua Caixa de entrada.
• É a base de dados que decide quem assume, por isso duas janelas do Claude Code a disputar a mesma tarefa não podem ganhar ambas. A que perde recebe already_claimed com o id e o título da tarefa.

Pôr vários agentes a trabalhar ao mesmo tempo é o tema de vários agentes de IA num só quadro.

Posso ver o mesmo quadro a partir do ChatGPT ou do telemóvel?

Sim. É um só quadro atrás de um só endpoint. O Weft é uma app publicada no ChatGPT em todos os planos, incluindo o Free (configuração), por isso pode perguntar ao ChatGPT o que o Claude Code terminou durante a noite. O Cursor instala-se com um clique (configuração) e o Codex usa uma entrada de configuração mais codex mcp login weft (configuração). No claude.ai e no Claude Desktop, o Weft é adicionado como conector personalizado.

O Weft também tem apps para iOS e Android. Quando uma tarefa chega à sua fila, o telemóvel recebe uma notificação push, no máximo uma por workspace a cada 10 minutos, para que uma pergunta do Claude Code lhe chegue mesmo longe da secretária. Cada cliente OAuth é um ator próprio, e o quadro mostra o nome com que se registou.

Para rever o que um agente fez, veja o que fez o meu agente de IA?

O que pode correr mal, e como resolver?

Sessão não iniciada

Se o Claude Code disser que o weft precisa de autenticação, escreva /mcp, selecione weft e autentique-se. Se desligou o cliente no Weft em Definições → Clientes de IA ligados, os tokens antigos são recusados na chamada seguinte, por isso inicie sessão de novo da mesma forma.

As ferramentas do Weft não aparecem

Corra claude mcp list e confirme que o weft lá está com o URL https://letsweft.com/api/mcp. O servidor é por projeto, a menos que o tenha adicionado com --scope user, por isso noutra pasta pode não estar.

already_claimed

Isto é uma resposta, não um erro. Outro cliente tem um lease ativo sobre essa tarefa. O agente deve escolher outro trabalho. Se sabe que a outra sessão morreu, espere: o lease expira em menos de 20 minutos e a tarefa é libertada.

attention_queue_full

Há demasiado trabalho terminado ou bloqueado à sua espera: 5 itens num workspace de uma pessoa ou 10 numa equipa, ou 45 minutos de revisão estimada, o que chegar primeiro. As perguntas também contam. start_task recusa até esvaziar parte da Caixa de entrada. A resposta lista o que o agente ainda pode fazer (report_progress, get_my_work, get_board_state, search), para que possa terminar ou arrumar em vez de começar mais coisas.

As chamadas param no plano Grátis

O plano Grátis inclui 200 chamadas de IA por mês, e as primeiras 48 horas após o registo não contam. Uma sessão longa com um sinal de vida a cada cinco minutos gasta chamadas a um ritmo constante. O Pro elimina o limite; veja os preços.

Como se compara com um TODO.md, com as GitHub Issues ou com o Hypertask?

Os factos sobre o GitHub têm ligação para a documentação e a página de preços do GitHub; os factos sobre o Hypertask, para a documentação dele. Para uma tabela mais ampla, veja gestores de tarefas MCP comparados.

Um TODO.md é a resposta certa para um programador num repositório: versionado com o código, sem conta, sem autenticação. Deixa de servir quando duas sessões o editam, ou quando quer responder a uma pergunta a partir do telemóvel.

As GitHub Issues são o sítio natural quando o seu trabalho já são issues e pull requests e toda a equipa vive no GitHub. O Weft não tem integração com o GitHub, por isso as ligações para commits e PRs viajam como artefactos no comprovativo, e não por sincronização.

O Hypertask é a melhor escolha se quer uma CLI para hooks e CI, uma API REST, agentes como contas de serviço com identidade própria, funcionalidades de IA incorporadas, registo de tempo ou uma app pensada para o teclado. O Weft não tem CLI, nem API pública, nem registo de tempo. Onde o Weft difere é que assumir a tarefa, o sinal de vida e a pergunta à pessoa são ferramentas MCP que o Claude Code chama diretamente, o início de sessão é OAuth com renovação, e o mesmo quadro está no ChatGPT e nas duas lojas de apps para telemóvel. Mais na nossa comparação com o Hypertask.

Preciso de uma chave de API para o Claude Code?

Não. O Claude Code inicia sessão com OAuth no navegador, e o Weft emite refresh tokens para que o cliente renove a sessão sozinho. Existem tokens de acesso pessoais para clientes que não suportam OAuth, mas o Claude Code não precisa de nenhum.

O Claude Code vai marcar as minhas tarefas como Done sem mim?

Por omissão, sim: complete_task move a tarefa para Done com o respetivo comprovativo. Uma tarefa que precisa de revisão, ou cuja verificação falha, para em vez disso na sua Caixa de entrada, à espera de Aceitar, Retrabalhar, Depois ou Descartar.

Posso impedir o Claude Code de eliminar coisas?

Defina a ligação como escrita no ecrã de consentimento, ou mais tarde em Definições → Clientes de IA ligados. A escrita permite tudo exceto as três ferramentas destrutivas (trash_task, archive_done_tasks, complete_sprint). A leitura permite apenas as 11 ferramentas só de leitura. Em qualquer caso, os agentes não conseguem eliminar tarefas de vez; a reciclagem guarda-as durante 30 dias, e restaurar da reciclagem é uma funcionalidade Pro.

O Weft cobra pela IA além do Claude?

Não. O Weft não tem créditos de IA: o raciocínio acontece no Claude Code, no seu próprio plano do Claude. O Weft conta chamadas de ferramentas: 200 por mês no Grátis, ilimitadas no Pro, a 8,00 € por lugar por mês ou 67,65 € por ano. Veja os preços.

E se já tiver as tarefas no Linear, Jira, Notion ou Trello?

A importação é gratuita em todos os planos: exportações CSV do Linear, Jira ou Notion, ou um quadro do Trello em JSON. O Claude Code também pode criar muitas tarefas de uma vez com bulk_create_tasks.

O Weft funciona com outros agentes de programação além do Claude Code?

Sim. Há páginas de configuração para 33 clientes, incluindo o Cursor, o Codex e o ChatGPT. Todos chegam ao mesmo quadro pelo mesmo endpoint.