Cosa fa
Propose *how* you intend to tackle a task before doing the work, and wait for a human to approve it. Posts your plan (markdown) as a comment and sets status to plan_proposed, which drops the task out of your ready queue (list_my_tasks) until a human approves (→ back to in_progress, with plan_approved_at stamped as your go-ahead) or rejects (→ back to not_started, with feedback to re-plan) it in the app. Use this for substantial or ambiguous work where the human should sign off on the approach before you spend effort — the pre-execution counterpart to propose_completion. Pass steps to materialize the plan as real subtasks right away (same mechanism as decompose_task) instead of leaving it as prose only a human has to manually turn into tasks later — render_plan and the app both read these subtasks, so this is what makes the checklist/progress view work. A step's assignee defaults to unset (nobody's queue) even if you write "I'll do this" in the plan text — set assignee:"claude" explicitly on the steps you intend to execute yourself, otherwise get_task/list_my_tasks won't know they're yours.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
id | string | Obbligatorio | |
plan | string | Obbligatorio | The plan (markdown) — the approach, steps, and anything you need the human to confirm |
steps | object[] | Facoltativo | Optional concrete action steps — created as real subtasks under this task immediately, so the human can review the actual breakdown (not just prose) before approving.
|
steps[].title | string | Obbligatorio |
|
steps[].assignee | string | Facoltativo | Set to claude if you'll execute this step yourself; omit for a step that's on the human. Valori ammessi claude |
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:
“Prima di iniziare la migrazione, proponi un piano e aspetta il mio via libera.”
Collega Done al tuo assistente
Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client: