← Tous les outils MCP

Report runner heartbeat

runner_heartbeat
Écriture

Ce qu’il fait

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.

Paramètres

NomTypeObligatoireDescription
namestringObligatoire

Stable name for this box. Same name = same box across restarts.

providerstringObligatoire

Which CLI this box runs.

Valeurs autoriséesclaudecodex
versionstringFacultatif

Daemon version, for support.

claimedbooleanFacultatif

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.

runobjectFacultatif

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.statusstringObligatoire
Valeurs autoriséesokfailedauth_failedtimeout
run.errorstringFacultatif

Short failure detail. Redact credentials before sending.

Annotations

Les indications que le serveur envoie avec cet outil. Un client les lit pour décider s’il doit vous demander avant un appel.

Lecture seulereadOnlyHint: false
Modifie des données de votre compte Done.
DestructifdestructiveHint: false
Ajoute ou lit seulement ; rien de ce qui existe n’est supprimé ni écrasé.
IdempotentidempotentHint: false
Chaque appel peut ajouter quelque chose de nouveau : un commentaire, une exécution, une tâche.
Monde ouvertopenWorldHint: false
Ne touche que votre propre compte Done.

Quels jetons peuvent l’appeler

Une connexion établie avec OAuth a un accès complet. Un jeton créé dans Réglages → Accès des agents → Jetons MCP supplémentaires peut être restreint, et un jeton restreint ne voit jamais au-delà de son projet ou de son espace de travail.

  • Accès completAutorisé
  • Jeton en lecture seuleRefusé
  • Jeton limité à un projetAutorisé
  • Jeton limité à un espace de travailAutorisé

Essayez

Une fois Done connecté, demandez à votre assistant quelque chose comme :

“Signalez l’état de ce runner à Done après chaque exécution.”

Connectez Done à votre assistant

Un point d’accès MCP par compte, via OAuth ou un jeton. La configuration pas à pas pour chaque client :

Vue d’ensemble de la configuration MCP →