O que faz
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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Obrigatório | 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. |
Anotações
As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.
- Somente leitura
readOnlyHint: false - Altera dados da sua conta do Done.
- Destrutiva
destructiveHint: false - Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
- Idempotente
idempotentHint: false - Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
- Mundo aberto
openWorldHint: false - Só mexe na sua própria conta do Done.
Quais tokens podem chamá-la
Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.
- Acesso totalPermitido
- Token somente leituraRecusado
- Token de um projetoRecusado
- Token de um espaço de trabalhoPermitido
Experimente
Com o Done conectado, peça ao seu assistente algo como:
“Registre uma execução enquanto trabalha nesta tarefa, para eu ver quanto custou.”
Conecte o Done ao seu assistente
Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente: