Scadenzario MCP: collega un assistente AI alle tue scadenze

Cos'è

Scadenzario espone un server MCP. MCP (Model Context Protocol) è lo standard aperto che permette a un assistente AI di usare un servizio esterno in modo diretto, invece di limitarsi a leggere il testo che gli incolli.

In pratica: colleghi l'assistente una volta sola e da lì in poi le tue scadenze sono dati vivi. Se ne aggiungi una dall'assistente, la trovi sul telefono pochi secondi dopo, con le notifiche già programmate.

Cosa può fare l'assistente

Cinque operazioni, niente di più:

• Cercare fra le tue scadenze — per periodo, testo, categoria o stato. "Cosa mi scade entro ottobre?"
• Leggere una singola scadenza con tutti i suoi dettagli.
• Elencare le tue categorie, per assegnare quella giusta a una nuova scadenza.
• Creare una scadenza — con data, ricorrenza, promemoria, importo.
• Creare più scadenze insieme, fino a venti per volta.

L'uso che vale davvero la pena

L'ultima operazione è quella interessante. Puoi allegare all'assistente una polizza, un contratto d'affitto, una visura o una bolletta e chiedergli di trovare le date importanti e inserirle. Il documento lo legge l'assistente; Scadenzario riceve solo le scadenze risultanti.

Esempi di richieste che funzionano:

• «Aggiungi l'assicurazione auto il 14 novembre, ricordamelo 30, 7 e 1 giorno prima.»
• «Ogni 15 del mese ricordami di pagare 650 € di affitto.»
• «Leggi questo contratto e inserisci tutte le scadenze che trovi.»
• «Quanto devo pagare complessivamente entro fine mese?»

Cosa non può fare

Vale la pena saperlo prima, per non chiederglielo invano. L'assistente non può:

• modificare una scadenza esistente;
• segnarla come completata o pagata;
• eliminarla;
• accedere alle scadenze condivise nei team;
• vedere o scaricare gli allegati (sa solo se una scadenza ne ha);
• leggere o scrivere i campi personalizzati.

È una scelta, non una dimenticanza: completare una scadenza ricorrente significa anche generare l'occorrenza successiva, ed eliminarne una tocca la sincronizzazione fra dispositivi. Sono operazioni che per ora restano dove sono già affidabili, cioè nell'app. Modifica, completamento ed eliminazione sono le prime candidate ad arrivare.

Genera il token di accesso

Il token si genera dall'app, non da questo sito:

1. Apri Impostazioni.
2. Tocca Analizza con AI.
3. Scegli Collega un assistente.
4. Tocca Genera token e copialo subito.

Serve un account con sincronizzazione attiva. Un account anonimo non ha dati sul cloud, quindi non c'è niente da collegare.

Configurazione

L'indirizzo del server è sempre lo stesso:

https://www.scadenzario.app/api/mcp

Il token va inviato come header Authorization: Bearer. Tieni il token in una variabile d'ambiente, così non finisce dentro un file di configurazione che potresti condividere o versionare:

export SCADENZARIO_MCP_TOKEN="il-tuo-token"

Claude Code

claude mcp add --transport http scadenzario \
  https://www.scadenzario.app/api/mcp \
  --header "Authorization: Bearer $SCADENZARIO_MCP_TOKEN"

Codex

In ~/.codex/config.toml, oppure in .codex/config.toml se lo vuoi solo per un progetto:

[mcp_servers.scadenzario]
url = "https://www.scadenzario.app/api/mcp"
bearer_token_env_var = "SCADENZARIO_MCP_TOKEN"

Claude Desktop

Impostazioni > Connettori > Aggiungi connettore personalizzato. Incolla l'indirizzo del server e aggiungi l'header di autorizzazione con il tuo token.

Cursor e altri client

Qualsiasi client che supporti un server MCP remoto su HTTP con header personalizzati funziona. La configurazione è sempre la stessa coppia: l'indirizzo qui sopra e l'header Authorization: Bearer <token>.

Come verificare che funzioni

Chiedi all'assistente: «Quali scadenze ho nei prossimi trenta giorni?». Se risponde con le tue scadenze vere, il collegamento è attivo. Se dice di non avere accesso, controlla che la variabile d'ambiente sia impostata nella sessione da cui hai avviato il client.

Sicurezza

• Il token non viene salvato in chiaro. Scadenzario conserva solo il suo hash SHA-256: un accesso al database non consegna credenziali utilizzabili.
• Non passa mai nell'indirizzo. Viaggia in un header, non nell'URL, dove finirebbe nei log dei server e nelle cronologie.
• Vale solo per il tuo account. L'utente non è un parametro che l'assistente può scegliere: viene ricavato dal token e basta.
• La revoca è immediata. Dall'app, con lo stesso percorso usato per generarlo.
• Un token per volta. Rigenerarlo invalida il precedente, quindi se sospetti che sia finito nel posto sbagliato ti basta rigenerarlo.

Su cosa raccogliamo e come lo trattiamo, vedi la privacy policy.

Domande frequenti

Serve l'abbonamento PRO?

No. Serve un account con sincronizzazione attiva. Valgono i limiti del tuo piano: 20 scadenze sincronizzate nel piano gratuito, 5.000 con PRO. Se l'assistente prova a crearne una oltre il limite, riceve un errore chiaro e te lo dice.

L'assistente vede tutte le mie scadenze?

Vede le scadenze personali dell'account a cui appartiene il token. Le scadenze condivise nei team non sono accessibili.

Funziona con ChatGPT?

Non ancora. I connettori di ChatGPT accettano solo autenticazione OAuth oppure nessuna autenticazione, e Scadenzario usa un token di accesso. Funziona invece con Claude, Claude Code, Codex, Cursor e gli altri client MCP che permettono di impostare un header di autorizzazione.

Le scadenze create dall'assistente mi notificano?

Sì. Arrivano sul telefono con la normale sincronizzazione e le notifiche vengono programmate come per quelle create a mano.

Se revoco il token perdo delle scadenze?

No. Il token governa solo l'accesso: le scadenze già create restano dove sono.