← Todas las herramientas MCP

Propose plan

propose_plan
Escritura

Qué hace

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

NombreTipoObligatorioDescripción
idstringObligatorio
planstringObligatorio

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.

  • Hasta 50 elementos
steps[].titlestringObligatorio
  • Hasta 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

Anotaciones

Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.

Solo lecturareadOnlyHint: false
Cambia datos de tu cuenta de Done.
DestructivadestructiveHint: false
Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: false
Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
Mundo abiertoopenWorldHint: false
Solo toca tu propia cuenta de Done.

Qué tokens pueden llamarla

Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.

  • Acceso completoPermitido
  • Token de solo lecturaRechazado
  • Token de un proyectoRechazado
  • Token de un espacio de trabajoPermitido

Pruébala

Con Done conectado, pídele a tu asistente algo como:

“Antes de empezar la migración, propón un plan y espera mi visto bueno.”

Conecta Done a tu asistente

Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente:

Resumen de la configuración de MCP →