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

Para dar ao Claude Code um quadro de tarefas, rode um comando, claude mcp add --transport http weft https://letsweft.com/api/mcp, e entre no Weft pelo navegador na primeira vez que o Claude Code se conectar. Não há chave para copiar nem nada para colar num arquivo de configuração. Depois disso, um bloco curto no CLAUDE.md faz o Claude Code assumir uma tarefa antes de editar código, reportar enquanto trabalha e deixar um comprovante quando terminar.

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

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

O Claude Code conhece o repositório à sua frente, não quem mais está trabalhando nem qual tarefa uma sessão que caiu tinha começado. Um quadro guarda esse estado fora de qualquer sessão, então uma pessoa, uma segunda janela do Claude Code e um chat do ChatGPT veem a mesma coisa.

Você não precisa de um para cada repositório. Uma pessoa, uma sessão curta e uma lista de TODO muitas vezes bastam. O quadro começa a compensar quando o trabalho se estende por várias sessões ou vários agentes, ou quando uma pessoa precisa olhar os resultados antes que eles contem.

Como conectar 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, rode claude mcp add --transport http weft https://letsweft.com/api/mcp. O Claude Code salva o servidor para o projeto atual; adicione --scope user se quiser em todos os projetos (veja a documentação de MCP do Claude Code, da Anthropic).
3. Inicie o claude. Na primeira vez que o Weft for usado, uma janela do navegador abre para o OAuth. Se não abrir, digite /mcp, escolha weft e autentique por ali.
4. Na tela de consentimento do Weft, escolha o que esta conexão pode fazer: full, write (tudo menos as três ferramentas destrutivas) ou read. Você pode mudar depois em Configurações → Clientes de IA conectados.
5. De volta ao Claude Code, pergunte: "O que tem no meu quadro?"

O endpoint fala MCP via Streamable HTTP e expõe 32 ferramentas. O Weft emite refresh tokens, então o próprio cliente renova o login. Se você usa um cliente que não faz OAuth, um token de acesso pessoal também funciona, mas o Claude Code não precisa de um. A página completa de configuração está em letsweft.com/claude-code.

Como confirmar que funciona sem deixar que ele mude nada?

Faça o primeiro prompt somente leitura. Isso mostra que as ferramentas carregaram e que o login chegou ao workspace certo, e nada no quadro se mexe:

Liste o meu quadro do Weft: colunas, o que está em Doing e o que está esperando por mim.
Não mude nada.

O Claude Code deve chamar get_board_state ou get_my_work. As duas são ferramentas somente leitura. Se quiser uma margem de segurança enquanto se acostuma, deixe a conexão em read na tela de consentimento: as chamadas de escrita passam a ser recusadas, e chamadas recusadas não contam na sua cota mensal.

Um custo, para ser honesto: as definições das 32 ferramentas ocupam cerca de 18.000 tokens do contexto do Claude Code.

Como fica uma tarefa assumida?

Coloque uma tarefa pequena e real em Todo, por exemplo "consertar o teste de data instável", e peça ao Claude Code para pegá-la. Uma boa execução é assim:

1. get_my_work retorna o que já é deste cliente, o que está esperando por você e se há espaço para começar alguma coisa.
2. start_task assume a tarefa, move-a para Doing e retorna 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 sempre. A cada poucos minutos ele chama report_progress, que renova o lease.
4. Se ele esbarrar numa decisão que só você pode tomar, chama request_input com opções. O Claude Code mostra a pergunta com os seus cartões de opção nativos; a resposta volta por submit_answer.
5. complete_task fecha a execução com um resultado, artefatos como o hash do commit e a saída dos testes, e o que ele não fez.

Por padrão, uma tarefa concluída vai direto para Done. Ela para na sua Caixa de entrada quando precisa de revisão ou quando uma verificação falha. Ali você escolhe Aceitar, Retrabalhar, Depois ou Descartar. Se o agente passou um nextStep, como "fazer merge do PR #12", Aceitar aprova exatamente esse passo, e ele volta para o agente executar.

O ciclo completo, com cada recusa e cada campo, está no guia do ciclo de claim.

O que devo colocar no CLAUDE.md?

As descrições das ferramentas já trazem essas regras; algumas linhas no CLAUDE.md as transformam em hábito do repositório. Cole e ajuste:

## Quadro de tarefas do Weft

O Weft (servidor MCP "weft") é o quadro compartilhado deste repositório. Outros
clientes de IA e pessoas também o leem, então mantenha-o fiel à realidade.

- No início de uma sessão, chame get_my_work. Trabalhe no que ele retornar;
  não escolha tarefas de memória.
- Antes de alterar qualquer arquivo para uma tarefa, chame start_task com o id dela.
  Guarde o runId e o leaseToken que ele retorna.
  - already_claimed: outra pessoa ou agente está com ela. Não duplique; pegue outra.
  - attention_queue_full: não tente de novo. Faça o que a resposta sugere
    (terminar ou esclarecer o trabalho existente).
- Enquanto trabalha, chame report_progress com runId e leaseToken mais ou menos a
  cada 5 minutos e em cada marco real (testes passando, PR aberto).
- Chame request_input só para decisões que a pessoa precisa tomar: qualquer coisa
  irreversível (produção, dinheiro, publicação, exclusão de dados) ou uma bifurcação
  real sem padrão sensato. Dê opções. Nunca peça permissão para continuar.
- Ao terminar, chame complete_task com:
  - outcome: uma ou duas frases sobre o que mudou
  - artifacts: hash do commit, URL do PR, comando de teste e o resultado
  - notDone: o que você pulou ou deixou para depois
  - unknowns: o que você não conseguiu verificar
  - nextStep: o único passo que você daria se a pessoa aceitar
- Se parar sem terminar, diga isso e deixe a tarefa em Doing.

Os artefatos transformam "pronto" em algo que você consegue conferir. A chamada nunca falha por falta de evidência, porque perder trabalho terminado é pior do que registrá-lo sem verificação.

O que acontece quando uma sessão do Claude Code morre no meio da tarefa?

Ninguém precisa limpar a bagunça. O claim é um lease, não uma flag. start_task concede 20 minutos, e cada report_progress renova esse prazo. Uma sessão que trava, perde a rede ou é fechada não consegue reportar, então o silêncio é o sinal.

• Depois de 20 minutos sem sinal de vida, a execução é marcada como parada, o lease token é apagado e a tarefa volta a ficar sem responsável.
• Uma varredura roda a cada 10 minutos, e a tarefa também é liberada na hora quando outro cliente tenta assumi-la.
• Uma execução que está esperando a sua resposta mantém o claim por 60 minutos. Depois disso o lease cai, mas a pergunta continua aberta na sua Caixa de entrada.
• Os claims são decididos pelo banco de dados, então duas janelas do Claude Code disputando a mesma tarefa não podem ganhar as duas. A que perde recebe already_claimed com o id e o título da tarefa.

Rodar vários agentes ao mesmo tempo é o assunto de vários agentes de IA num só quadro.

Dá para ver o mesmo quadro pelo ChatGPT ou pelo celular?

Dá. É um quadro só, atrás de um endpoint só. O Weft é um app publicado no ChatGPT em todos os planos, inclusive o Free (configuração), então você pode perguntar ao ChatGPT o que o Claude Code terminou durante a noite. O Cursor instala 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 cai na sua fila, o celular recebe um push, no máximo um por workspace a cada 10 minutos, então uma pergunta do Claude Code chega até você longe da mesa. Cada cliente OAuth é um ator próprio, e o quadro mostra o nome com que ele se registrou.

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

O que pode dar errado e como resolver?

Sem login

Se o Claude Code disser que o weft precisa de autenticação, digite /mcp, selecione weft e autentique. Se você desconectou o cliente em Configurações → Clientes de IA conectados, no Weft, os tokens antigos dele são recusados na próxima chamada, então entre de novo do mesmo jeito.

As ferramentas do Weft não aparecem

Rode claude mcp list e confira se o weft está lá com a URL https://letsweft.com/api/mcp. O servidor é por projeto, a menos que você o tenha adicionado com --scope user, então outra pasta pode não tê-lo.

already_claimed

Isto é uma resposta, não um erro. Outro cliente tem um lease ativo naquela tarefa. O agente deve pegar outro trabalho. Se você sabe que a outra sessão morreu, espere: o lease vence em até 20 minutos e a tarefa é liberada.

attention_queue_full

Há trabalho concluído ou bloqueado demais esperando por você: 5 itens num workspace de uma pessoa ou 10 num time, ou 45 minutos de revisão estimada, o que vier primeiro. Perguntas também contam. start_task recusa até você 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 ele termine ou organize em vez de começar mais coisas.

As chamadas param no plano Free

O Free inclui 200 chamadas de IA por mês, e as primeiras 48 horas após o cadastro não são contadas. Uma sessão longa com sinal de vida a cada cinco minutos consome chamadas sem parar. O Pro tira o limite; veja os preços.

Como isso se compara a um TODO.md, ao GitHub Issues ou ao Hypertask?

Os fatos sobre o GitHub apontam para a documentação e a página de preços do GitHub; os do Hypertask, para a documentação dele. Para uma tabela mais ampla, veja gerenciadores de tarefas com MCP comparados (em inglês).

Um TODO.md é a resposta certa para um desenvolvedor num repositório: versionado com o código, sem conta, sem autenticação. Ele desmorona quando duas sessões o editam, ou quando você quer responder a uma pergunta pelo celular.

O GitHub Issues é a casa natural quando o seu trabalho já é feito de issues e pull requests e todo mundo no time vive no GitHub. O Weft não tem integração com o GitHub, então links de commits e PRs viajam como artefatos no comprovante, e não por sincronização.

O Hypertask é a melhor escolha se você quer uma CLI para hooks e CI, uma API REST, agentes como contas de serviço com identidade própria, recursos de IA embutidos, controle de tempo ou um app pensado para o teclado. O Weft não tem CLI, nem API pública, nem controle de tempo. A diferença do Weft é que o claim, o sinal de vida e a pergunta à pessoa são ferramentas MCP que o Claude Code chama diretamente, o login é OAuth com refresh, e o mesmo quadro está no ChatGPT e nas duas lojas de apps. Mais detalhes na nossa comparação com o Hypertask.

Preciso de uma chave de API para o Claude Code?

Não. O Claude Code entra com OAuth no navegador, e o Weft emite refresh tokens, então o próprio cliente renova o login. Existem tokens de acesso pessoal para clientes que não fazem OAuth, mas o Claude Code não precisa de um.

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

Por padrão, sim: complete_task move a tarefa para Done com o comprovante. Uma tarefa que precisa de revisão, ou cuja verificação falha, para na sua Caixa de entrada para Aceitar, Retrabalhar, Depois ou Descartar.

Posso impedir o Claude Code de apagar coisas?

Deixe a conexão em write na tela de consentimento, ou depois em Configurações → Clientes de IA conectados. Write permite tudo menos as três ferramentas destrutivas (trash_task, archive_done_tasks, complete_sprint). Read permite só as 11 ferramentas somente leitura. Em nenhum caso os agentes conseguem excluir tarefas de vez; a lixeira as guarda por 30 dias, e restaurar da lixeira é um recurso do 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, dentro do seu próprio plano do Claude. O Weft conta chamadas de ferramentas: 200 por mês no Free, ilimitadas no Pro, a R$ 39 por assento por mês ou R$ 329 por ano. Veja os preços.

E se eu já guardo tarefas no Linear, no Jira, no Notion ou no Trello?

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

O Weft funciona com outros agentes de código além do Claude Code?

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