Cosa fa
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.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
id | string | Obbligatorio | Task id |
trace_url | string | Facoltativo | 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 | Facoltativo | 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. |
Annotazioni
Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.
- Sola lettura
readOnlyHint: false - Modifica dati nel tuo account Done.
- Distruttivo
destructiveHint: false - Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
- Idempotente
idempotentHint: false - Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
- Mondo aperto
openWorldHint: false - Tocca solo il tuo account Done.
Quali token possono chiamarlo
Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.
- Accesso completoConsentito
- Token di sola letturaRifiutato
- Token per un progettoRifiutato
- Token per uno spazio di lavoroConsentito
Provalo
Con Done collegato, chiedi al tuo assistente qualcosa come:
“Registra un’esecuzione mentre lavori a questa attività, così vedo quanto è costata.”
Collega Done al tuo assistente
Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client: