Was es tut
Open a run — one work session on a task — when you begin substantive work. Returns the run id (pass it to end_run) and the task's budget (budget_tool_calls / budget_minutes, null = uncapped) with cumulative usage so far, so you can pace yourself. Enforced: if the task has already spent its whole budget across earlier runs, start_run is refused (error budget_exceeded) — a human must raise the budget or take over. Every run leaves an auditable trace in the task's activity.
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | Pflicht | Task id |
trace_url | string | Optional | Absolute http(s) link to this run's session transcript, if you have one (any other scheme is refused). Turns the run record into something a human can open when they ask why you did what you did — especially for work that happened overnight. |
agent | string | Optional | Your agent id, recorded on the run so per-agent history is reconstructable. Ignored if your token has a name of its own — a named credential is the identity, and this argument is only the fallback for an unnamed one. |
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: false - Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
- 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:
“Protokollier einen Lauf, während du an dieser Aufgabe arbeitest, damit ich sehe, was sie gekostet hat.”
Verbinde Done mit deinem Assistenten
Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client: