← Tutta la documentazione MCP
Configurazione MCP

Usa Done in Codex

Collega Done a OpenAI Codex: aggiungi https://trydone.app/mcp con codex mcp add o in config.toml, accedi con codex mcp login e Codex potrà lavorare le tue attività di Done.

Per chi è

Per gli sviluppatori che usano la CLI di Codex, l’estensione di Codex per l’IDE o Codex nell’app desktop di ChatGPT. Tutti e tre condividono un unico file di configurazione, quindi configuri Done una volta sola. ChatGPT sul web non lo legge: per quello, vedi Usa Done in ChatGPT.

Configuralo

URL del server MCP di Done

https://trydone.app/mcp

Aggiungi il server e accedi Accesso con OAuth

  1. Aggiungi Done alla configurazione di Codex:
    codex mcp add done --url https://trydone.app/mcp
  2. Accedi e approva l’accesso in Done nella finestra del browser che si apre. Codex si registra da solo su Done e riceve l’accesso su 127.0.0.1.
    codex mcp login done
  3. Chiedi a Codex qualcosa dall’elenco qui sotto per verificare che raggiunga le tue attività.

Il primo comando scrive una tabella [mcp_servers.done] con url = "https://trydone.app/mcp" in ~/.codex/config.toml: puoi anche aggiungerla a mano.

Oppure usa un token Token MCP

  1. Genera un token MCP in Done, in Impostazioni → Accesso degli agenti, e mettilo in una variabile d’ambiente, per esempio nel profilo della tua shell:
    export DONE_MCP_TOKEN="<your-mcp-token>"
  2. Indica a Codex quella variabile in ~/.codex/config.toml:
    [mcp_servers.done]
url = "https://trydone.app/mcp"
bearer_token_env_var = "DONE_MCP_TOKEN"

Un token è adatto a una macchina remota o senza schermo, dove l’accesso dal browser non raggiunge l’indirizzo locale di Codex.

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

L’accesso non si completa mai su una macchina remota
Codex attende l’accesso su 127.0.0.1 della macchina su cui gira, che il tuo browser non raggiunge via SSH. Usa lì la configurazione con token.
401 Unauthorized con un token
La variabile non è impostata nella shell da cui è partito Codex, oppure il token è stato rigenerato. Controlla echo $DONE_MCP_TOKEN e riavvia Codex.

Domande frequenti

Codex in ChatGPT sul web usa questa configurazione?

No. Il file locale vale per la CLI di Codex, l’estensione per l’IDE e l’app desktop di ChatGPT. Per ChatGPT sul web, aggiungi Done come server MCP personalizzato.

OAuth o token?

Con OAuth nessun segreto resta nei tuoi file. Un token funziona sulle macchine senza schermo e può essere di sola lettura o limitato a un progetto.

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:

Altri assistenti