Cosa fa
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.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
id | string | Obbligatorio | Task id |
edits | object[] | Obbligatorio | One entry per field. Proposing the value a field already has is dropped rather than queued.
|
edits[].field | string | Obbligatorio | The task field to change, e.g. title, notes, due_date, acceptance_criteria |
edits[].value | unknown | Facoltativo | The proposed value. null proposes clearing the field. |
edits[].reason | string | Facoltativo | Why — one line. This is what the human is deciding on. |
Annotazioni
Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.
- Sola lettura
readOnlyHint: false - Modifica dati nel tuo account Done.
- Distruttivo
destructiveHint: false - Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
- Idempotente
idempotentHint: false - Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
- Mondo aperto
openWorldHint: false - Tocca solo il tuo account Done.
Quali token possono chiamarlo
Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.
- Accesso completoConsentito
- Token di sola letturaRifiutato
- Token per un progettoRifiutato
- Token per uno spazio di lavoroConsentito
Provalo
Con Done collegato, chiedi al tuo assistente qualcosa come:
“Suggerisci un titolo più chiaro e una scadenza per l’attività del sito, ma lascia che sia io ad approvare la modifica.”
Collega Done al tuo assistente
Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client: