← Tutti gli strumenti MCP

Propose plan

propose_plan
Scrittura

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

NomeTipoObbligatorioDescrizione
idstringObbligatorio
planstringObbligatorio

The plan (markdown) — the approach, steps, and anything you need the human to confirm

stepsobject[]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.

  • Fino a 50 elementi
steps[].titlestringObbligatorio
  • Fino a 500 caratteri
steps[].assigneestringFacoltativo

Set to claude if you'll execute this step yourself; omit for a step that's on the human.

Valori ammessiclaude

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 letturareadOnlyHint: false
Modifica dati nel tuo account Done.
DistruttivodestructiveHint: false
Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: false
Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
Mondo apertoopenWorldHint: 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:

Panoramica della configurazione MCP →