Was es tut
Hand a task back: takes it off your queue entirely (clears the assignee and your claim, and returns it to not_started) and posts your reason to the task's thread. Use it when a task was assigned to you but shouldn't be — wrong agent, out of scope, needs a human, or you can't make progress on it. This is the counterpart to claim_task, and the way to decline work now that update_task can't set assignee: you can always give work back, you just can't give it to yourself. Prefer release_task if you only need to drop the lease and leave the task assigned to you; prefer ask_decision if you can do the task but need a question answered first. reason is required — a task silently dropped off the queue looks exactly like one nobody got to.
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | Pflicht | |
reason | string | Pflicht | Why you're handing it back. Posted as a comment. |
agent | string | Optional | Your agent id when running as part of a fleet — the one you claimed with. Declining fails while a different agent holds an active lease. |
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 lesen
readOnlyHint: false - Ändert Daten in deinem Done-Konto.
- Destruktiv
destructiveHint: false - Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
- Idempotent
idempotentHint: true - Zweimal mit denselben Argumenten aufgerufen, ergibt es dasselbe wie ein einziger Aufruf.
- Offene Welt
openWorldHint: 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:
“Die juristische Prüfung ist nicht deine Aufgabe. Gib sie zurück und sag, warum.”
Verbinde Done mit deinem Assistenten
Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client: