← Alle MCP-Tools

Propose plan

propose_plan
Schreiben

Was es tut

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.

Parameter

NameTypPflichtBeschreibung
idstringPflicht
planstringPflicht

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

stepsobject[]Optional

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.

  • Bis zu 50 Einträge
steps[].titlestringPflicht
  • Bis zu 500 Zeichen
steps[].assigneestringOptional

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

Erlaubte Werteclaude

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false
Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false
Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false
Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false
Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

  • Voller ZugriffErlaubt
  • Token nur zum LesenAbgelehnt
  • Token für ein ProjektAbgelehnt
  • Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Bevor du mit der Migration anfängst, schlag einen Plan vor und warte auf mein Okay.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →