Qué hace
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.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Obligatorio | Task id |
trace_url | string | Opcional | 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 | Opcional | 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. |
Anotaciones
Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.
- Solo lectura
readOnlyHint: false - Cambia datos de tu cuenta de Done.
- Destructiva
destructiveHint: false - Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
- Idempotente
idempotentHint: false - Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
- Mundo abierto
openWorldHint: false - Solo toca tu propia cuenta de Done.
Qué tokens pueden llamarla
Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.
- Acceso completoPermitido
- Token de solo lecturaRechazado
- Token de un proyectoRechazado
- Token de un espacio de trabajoPermitido
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“Registra una ejecución mientras trabajas en esta tarea, para que vea cuánto costó.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: