Was es tut
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.
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | Pflicht | Task id |
edits | object[] | Pflicht | One entry per field. Proposing the value a field already has is dropped rather than queued.
|
edits[].field | string | Pflicht | The task field to change, e.g. title, notes, due_date, acceptance_criteria |
edits[].value | unknown | Optional | The proposed value. null proposes clearing the field. |
edits[].reason | string | Optional | Why — one line. This is what the human is deciding on. |
Annotationen
Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.
- Nur lesen
readOnlyHint: false - Ändert Daten in deinem Done-Konto.
- Destruktiv
destructiveHint: false - Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
- Idempotent
idempotentHint: false - Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
- Offene Welt
openWorldHint: false - Berührt nur dein eigenes Done-Konto.
Welche Tokens es aufrufen dürfen
Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.
- Voller ZugriffErlaubt
- Token nur zum LesenAbgelehnt
- Token für ein ProjektAbgelehnt
- Token für einen WorkspaceErlaubt
Probier es aus
Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:
“Schlag für die Website-Aufgabe einen klareren Titel und ein Fälligkeitsdatum vor, aber lass mich die Änderung freigeben.”
Verbinde Done mit deinem Assistenten
Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client: