← Alle MCP-Tools

Claim task

claim_task
Schreiben

Was es tut

Claim a task: mark it in_progress, assign it to the AI agent, and post a comment so the human sees you started. Call the moment you pick up a task. Pass agent when running in a fleet — the claim takes a 30-minute lease and this call fails if another agent already holds an active lease on the task, so two agents never work the same one. Re-claiming with your own agent id (or after the lease lapses) succeeds. Release it with release_task if you stop before finishing. The task comes back with url, its link in the Done app: when you tell the human you've started, give them that link, not the id.

Parameter

NameTypPflichtBeschreibung
idstringPflicht
notestringOptional

First message posted to the activity feed

  • Bis zu 20000 Zeichen
agentstringOptional

Your agent id when running as part of a fleet (defaults to a shared claim)

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:

“Übernimm die Aufgabe mit der Rechnungserinnerung und sag mir Bescheid, dass du dran bist.”

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 →