← Todas as ferramentas MCP

Propose plan

propose_plan
Escrita

O que faz

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.

Parâmetros

NomeTipoObrigatórioDescrição
idstringObrigatório
planstringObrigatório

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

stepsobject[]Opcional

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.

  • Até 50 itens
steps[].titlestringObrigatório
  • Até 500 caracteres
steps[].assigneestringOpcional

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

Valores permitidosclaude

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: false
Altera dados da sua conta do Done.
DestrutivadestructiveHint: false
Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: false
Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
Mundo abertoopenWorldHint: false
Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

  • Acesso totalPermitido
  • Token somente leituraRecusado
  • Token de um projetoRecusado
  • Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“Antes de começar a migração, proponha um plano e espere meu sinal verde.”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →