Configurazione MCP

Usa Done in Hermes Agent

Collega Done a Hermes Agent di Nous Research: aggiungi https://trydone.app/mcp a config.yaml, accedi con hermes mcp login e tieni una lista di attività da cui lavora il tuo agente.

Per chi è

Per chi usa Hermes Agent di Nous Research e vuole che tenga con te una vera lista di attività: può annotare attività, lavorare quelle che gli affidi e mettere in sospeso una domanda invece di tirare a indovinare.

Configuralo

URL del server MCP di Done

https://trydone.app/mcp

Aggiungi il server e accedi Accesso con OAuth

Aggiungi Done a ~/.hermes/config.yaml:

mcp_servers:
  done:
    url: "https://trydone.app/mcp"
    auth: oauth

Esegui hermes mcp login done e approva l’accesso in Done. Hermes si registra da solo, conserva l’accesso sulla tua macchina e lo rinnova.
Esegui hermes mcp test done per verificare che risponda ed elenchi gli strumenti di Done. In una sessione aperta, /reload-mcp applica la modifica.

Oppure usa un token Token MCP

Genera un token MCP in Done, in Impostazioni → Accesso degli agenti, e invialo come intestazione al posto di auth: oauth:
```
mcp_servers:
  done:
    url: "https://trydone.app/mcp"
    headers:
      Authorization: "Bearer <your-mcp-token>"
```

Su un host senza schermo la strada è un token: Done non offre l’accesso con codice dispositivo che Hermes può usare in quel caso.

Ti serve una chiave più ristretta? In Impostazioni → Accesso degli agenti → Token MCP aggiuntivi puoi crearne una di sola lettura, o limitata a un progetto o a uno spazio di lavoro: l’agente non vedrà mai più di così.

Cosa dirgli

Con Done collegato, parla con l’assistente come al solito. Ognuna di queste frasi corrisponde a un vero strumento di Done:

“Cosa ho in programma oggi?”

get_todays_plan

“Aggiungi un’attività: mandare la fattura a Sam venerdì p1”

quick_capture

“Prendi la tua prossima attività di Done e proponi un piano prima di iniziare.”

next_task → propose_plan

“Se arrivi a una decisione che non puoi prendere, chiedimelo e continua con il resto.”

ask_decision

“Quando hai finito, mandamela da approvare.”

propose_completion

Tutti gli strumenti, i prompt e le risorse che Done espone sono nel riferimento MCP.

L’approvazione obbligatoria

Per impostazione predefinita un assistente non può chiudere le tue attività. Quando pensa che un’attività sia finita chiama propose_completion, che la mette In attesa di approvazione finché non la approvi o la rimandi indietro da In attesa di te; il lavoro più corposo parte da propose_plan, che aspetta il tuo via libera. Una domanda passa da ask_decision: quell’attività aspetta la tua risposta mentre l’agente passa alla successiva. Done lo applica sul proprio server, quindi vale qualunque cosa tenti l’assistente: un agente può completare un’attività direttamente solo se hai impostato l’Autonomia di quell’attività per permetterglielo.

Risoluzione dei problemi

invalid_client dopo una reinstallazione o un nuovo collegamento: Hermes tiene un accesso vecchio. Rimuovi il server, elimina il token salvato in ~/.hermes/mcp-tokens/, aggiungilo di nuovo ed esegui hermes mcp login done.
Le modifiche a config.yaml non hanno effetto: Esegui /reload-mcp nella sessione, oppure riavvia Hermes.

Domande frequenti

Posso far vedere a Hermes solo una parte della mia bacheca?

Sì: usa un token da Token MCP aggiuntivi di sola lettura, o limitato a un progetto o a uno spazio di lavoro.

Esiste una chiave API condivisa per Done?

No. Ogni collegamento appartiene a un solo account Done: un accesso con OAuth o un token MCP che generi tu. Non esiste una chiave condivisa o globale. Ogni assistente collegato compare in Impostazioni → Accesso degli agenti, dove puoi revocarlo con un clic.

Cosa può vedere l’assistente?

Solo ciò che vede il tuo account: i tuoi spazi di lavoro e ciò che è stato condiviso con te. Un token di sola lettura, di un progetto o di uno spazio di lavoro restringe ancora di più.

Costa qualcosa?

Il piano Free include 100 chiamate agente (MCP) al mese; Pro e Teams sono illimitati. Il piano dell’assistente stesso è a parte.

Passaggi verificati sulla documentazione ufficiale il 23 ottobre 2026:

hermes-agent.nousresearch.com/docs/user-guide/features/mcp