O que faz
For a self-hosted runner box only. Registers this box against the account and reports its health, so the human can see their runner in Done rather than by reading logs over SSH. Call it on connect, on the interval this returns, and once after every run with that run's outcome. Report run.status 'auth_failed' when the model credential is rejected — a box whose subscription login expired still holds its stream open, so that is the one failure Done cannot otherwise see.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Obrigatório | Stable name for this box. Same name = same box across restarts. |
provider | string | Obrigatório | Which CLI this box runs. Valores permitidos claudecodex |
version | string | Opcional | Daemon version, for support. |
claimed | boolean | Opcional | For a Done-provisioned box: true once a model credential exists on this machine. Done cannot see this for itself, so the box reports it. |
run | object | Opcional | The outcome of the run that just finished. Omit on a plain check-in — omitting it leaves the previous outcome standing rather than clearing it. |
run.status | string | Obrigatório | Valores permitidos okfailedauth_failedtimeout |
run.error | string | Opcional | Short failure detail. Redact credentials before sending. |
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 projetoPermitido
- Token de um espaço de trabalhoPermitido
Experimente
Com o Done conectado, peça ao seu assistente algo como:
“Informe ao Done o estado deste runner depois de cada execução.”
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: