Qué hace
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
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | string | Obligatorio | Stable name for this box. Same name = same box across restarts. |
provider | string | Obligatorio | 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 | Obligatorio | Valores permitidos okfailedauth_failedtimeout |
run.error | string | Opcional | Short failure detail. Redact credentials before sending. |
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 proyectoPermitido
- Token de un espacio de trabajoPermitido
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“Informa a Done el estado de este runner después de cada ejecución.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: