Configuração do MCP

Use o Done no Claude Code

Adicione o Done ao Claude Code com um único claude mcp add, faça login pelo /mcp e deixe o Claude Code pegar, planejar e prestar contas das suas tarefas do Done.

Para quem é

Para desenvolvedores que usam o Claude Code no terminal ou na IDE. Funciona bem quando o trabalho da sua lista é código: o Claude Code pode pegar uma tarefa, propor um plano, fazer o trabalho no seu repositório e devolver para você aprovar.

Configure

URL do servidor MCP do Done

https://trydone.app/mcp

Adicione o servidor e faça login Login com OAuth

Rode isto uma vez no terminal. --scope user deixa o Done disponível em todos os projetos; sem ele, o Done entra só no projeto atual.
```
claude mcp add --transport http --scope user done https://trydone.app/mcp
```
Abra o Claude Code, rode /mcp, escolha done e siga o login no navegador. Num shell, claude mcp login done faz o mesmo.
Aprove o acesso no Done. O Claude Code guarda o login e renova sozinho.

Ou use um token Token MCP

No Done, abra Configurações → Acesso de agentes e gere um token MCP. Ele aparece uma única vez, então copie na hora.

Adicione o servidor com o seu token como cabeçalho:

claude mcp add --transport http --scope user done https://trydone.app/mcp \
  --header "Authorization: Bearer <your-mcp-token>"

Não adicione um servidor com token usando --scope project: isso grava o token em .mcp.json, que normalmente vai para o repositório.

Precisa de uma chave mais restrita? Em Configurações → Acesso de agentes → Tokens MCP adicionais você cria uma somente leitura, ou limitada a um projeto ou a um espaço de trabalho — e o agente nunca vê mais do que isso.

O que dizer a ele

Com o Done conectado, fale com o assistente normalmente. Cada uma destas frases corresponde a uma ferramenta real do Done:

“O que eu tenho para hoje?”

get_todays_plan

“Adicione uma tarefa: mandar a fatura para o Sam sexta p1”

quick_capture

“Pegue sua próxima tarefa do Done e proponha um plano antes de começar.”

next_task → propose_plan

“Se chegar a uma decisão que você não pode tomar, me pergunte e siga com o resto.”

ask_decision

“Quando terminar, mande para eu aprovar.”

propose_completion

Todas as ferramentas, prompts e recursos que o Done expõe estão na referência de MCP.

A aprovação obrigatória

Por padrão, um assistente não consegue concluir suas tarefas. Quando acha que uma tarefa está pronta, ele chama propose_completion, que deixa a tarefa em Aguardando aprovação até você aprovar ou devolver em Precisa de você; um trabalho grande começa com propose_plan, que espera o seu sinal verde. Uma pergunta passa por ask_decision: aquela tarefa espera sua resposta enquanto o agente segue para a próxima. O Done aplica isso no próprio servidor, então vale não importa o que o assistente tente — um agente só conclui uma tarefa diretamente se você configurou a Autonomia dessa tarefa para permitir.

Solução de problemas

done aparece como precisando de autenticação: Rode /mcp, selecione done e faça login. Para recomeçar do zero, escolha Clear authentication ali e faça login de novo.
O navegador não abriu: Copie a URL de login que o Claude Code mostra e abra você mesmo.
Um token que funcionava agora dá 401: Gerar um novo token principal revoga o anterior. Crie um token novo, rode claude mcp remove done e adicione o servidor de novo.

Perguntas frequentes

Várias sessões do Claude Code podem dividir minha fila?

Sim. next_task reserva uma tarefa de forma atômica, então duas sessões nunca pegam a mesma. Dê a cada uma o próprio token com nome para ver o trabalho delas separado na sua lista de agentes.

É a mesma coisa que o Claude na web?

Não — aquilo é um conector personalizado, configurado nas configurações do Claude. Veja Use o Done no Claude.

Existe uma chave de API compartilhada para o Done?

Não. Cada conexão pertence a uma única conta do Done: um login com OAuth ou um token MCP que você mesmo gera. Não existe chave compartilhada nem global. Cada assistente conectado aparece em Configurações → Acesso de agentes, onde você revoga com um clique.

O que o assistente consegue ver?

Só o que a sua conta vê: seus espaços de trabalho e o que foi compartilhado com você. Um token somente leitura, de um projeto ou de um espaço de trabalho restringe ainda mais.

Custa alguma coisa?

O plano Free inclui 100 chamadas de agente (MCP) por mês; Pro e Teams são ilimitados. O plano do próprio assistente é à parte.

Passos conferidos com a documentação oficial em 23 de outubro de 2026:

code.claude.com/docs/en/mcp