O que faz
Propose changes to a task's fields WITHOUT making them: a diff a human reads as current-vs-proposed and accepts or dismisses one field at a time. Use it when you would otherwise call update_task on something a human is likely to want a say in — retitling their task, moving a date they set, rewriting their acceptance criteria. Nothing changes until a person accepts, and they can take the three edits that were right and drop the one that wasn't, instead of rejecting the lot and making you redo all four. Each edit carries a reason, which is what the person is actually deciding on. You may only propose fields you could already set yourself: a field that is refused to you is not yours to propose either. A proposal records the field's current value, so if somebody edits that same field before your proposal is read, accepting it is refused rather than quietly overwriting their work — re-read the task and propose again.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Obrigatório | Task id |
edits | object[] | Obrigatório | One entry per field. Proposing the value a field already has is dropped rather than queued.
|
edits[].field | string | Obrigatório | The task field to change, e.g. title, notes, due_date, acceptance_criteria |
edits[].value | unknown | Opcional | The proposed value. null proposes clearing the field. |
edits[].reason | string | Opcional | Why — one line. This is what the human is deciding on. |
Anotações
As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.
- Somente leitura
readOnlyHint: false - Altera dados da sua conta do Done.
- Destrutiva
destructiveHint: false - Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
- Idempotente
idempotentHint: false - Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
- Mundo aberto
openWorldHint: false - Só mexe na sua própria conta do Done.
Quais tokens podem chamá-la
Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.
- Acesso totalPermitido
- Token somente leituraRecusado
- Token de um projetoRecusado
- Token de um espaço de trabalhoPermitido
Experimente
Com o Done conectado, peça ao seu assistente algo como:
“Sugira um título mais claro e um prazo para a tarefa do site, mas me deixe aprovar a mudança.”
Conecte o Done ao seu assistente
Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente: