Qué hace
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
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Obligatorio | Task id |
edits | object[] | Obligatorio | One entry per field. Proposing the value a field already has is dropped rather than queued.
|
edits[].field | string | Obligatorio | 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. |
Anotaciones
Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.
- Solo lectura
readOnlyHint: false - Cambia datos de tu cuenta de Done.
- Destructiva
destructiveHint: false - Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
- Idempotente
idempotentHint: false - Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
- Mundo abierto
openWorldHint: false - Solo toca tu propia cuenta de Done.
Qué tokens pueden llamarla
Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.
- Acceso completoPermitido
- Token de solo lecturaRechazado
- Token de un proyectoRechazado
- Token de un espacio de trabajoPermitido
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“Sugiere un título más claro y una fecha límite para la tarea del sitio web, pero déjame aprobar el cambio.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: