Timeout MCP? Controlla la modifica prima di riprovare

Perché un timeout non dice se la modifica è avvenuta?

La tua IA ha chiesto a uno strumento di fare una modifica, poi ha aspettato. Non è arrivata nessuna risposta, quindi l’app di IA ha smesso di aspettare e ha segnalato un errore. Quell’etichetta descrive l’attesa, non la modifica. Riprovare una modifica già fatta significa ritrovarsi con due ticket, due pagine o due messaggi.

Gli sviluppatori la chiamano una scrittura. Possono essere successe tre cose.

La specifica MCP lo prevede. Un client dovrebbe impostare un timeout su ogni richiesta e, quando scade, interrompere la richiesta e smettere di aspettare. Un’interruzione non è una garanzia. Il server può ignorarla quando il lavoro è già finito o non può essere fermato. Può anche arrivare dopo che la risposta è stata inviata.

La guida API di Stripe dice lo stesso: dopo che una connessione si interrompe, potresti non sapere se la richiesta è stata eseguita. Dice anche di trattare un errore del server come esito sconosciuto.

Cosa fare dopo un timeout, in ordine?

Segui questi passi in ordine. I primi due richiedono un minuto.

1. Ferma il nuovo tentativoAdesso

   Dì alla tua IA di non ripetere la chiamata: « Non riprovare. Controlla prima se è stata fatta. » Un nuovo tentativo da solo è il modo in cui una modifica viene fatta due volte.

2. Guarda nello strumento, non nella chat1 minuto

   Apri lo strumento stesso: la pagina di Notion, le issue di GitHub, la cartella. Cerca il titolo o l’id che avevi chiesto. La chat sa solo che la chiamata è fallita.

3. Leggi ciò che trovi2 minuti

   Trovata e completa: la modifica è stata fatta. Vai avanti e non ripeterla.
   Trovata, a metà: completa la parte mancante con un aggiornamento, non con una nuova creazione.
   Non trovata: non è mai arrivata, oppure è ancora in corso. Aspetta un minuto e guarda di nuovo.

4. Riprova una volta sola, e solo una chiamata sicuraPoi

   Se manca ancora, riprova una volta sola. La tabella qui sotto dice quali chiamate si possono ripetere. Prima di un invio, guarda dove arriva.

5. Se va ancora in timeout, correggi la causaDopo

   Una chiamata che va sempre in timeout ha un limite troppo corto o un lavoro troppo grande. Alza il limite per quel server, o chiedi meno per chiamata.

Quali chiamate si possono riprovare in sicurezza?

Una chiamata si può riprovare in sicurezza quando farla due volte dà lo stesso risultato che farla una volta. Le letture rientrano. Molte modifiche no. Lo standard HTTP considera PUT (imposta un valore) e DELETE sicuri da ripetere, e le righe qui sotto lo seguono. L’idempotentHint di uno strumento, o la sua descrizione, prevalgono su di esse.

Una chiave di idempotenza può bloccare il doppione?

A volte. Una chiave di idempotenza è un’etichetta unica inviata con una richiesta. Se la stessa etichetta arriva due volte, il servizio fa il lavoro una volta sola e ripete la sua prima risposta. È pensata per una richiesta che non ha avuto risposta.

• Come funziona una chiave in Stripe. La sua API v1 accetta una chiave nelle richieste POST. Salva il primo risultato, anche un errore, e lo restituisce di nuovo per un nuovo tentativo con la stessa chiave. Conserva le chiavi per almeno 24 ore. La stessa chiave con altri parametri viene rifiutata.
• Cosa deve fare un nuovo tentativo. Invia la stessa chiave e gli stessi parametri. Stripe dice di non riprovare con una chiave nuova finché non conosci l’esito del primo tentativo. Una chiave nuova a ogni tentativo non dà alcuna protezione.
• Cosa offre MCP. Una richiesta tools/call porta il nome di uno strumento e i suoi argomenti. Lo schema della specifica non definisce per essa una chiave di idempotenza. Uno strumento può comunque accettarne una come argomento proprio, quindi leggi i suoi argomenti.
• Cosa può dichiarare uno strumento. idempotentHint dice che richiamare lo strumento con gli stessi argomenti non ha effetti aggiuntivi. È solo un suggerimento. La specifica dice che i client non dovrebbero mai basare le decisioni su suggerimenti di server di cui non si fidano.

Quindi una chiave è un vantaggio in più, non un piano. Quando lo strumento non ne offre nessuna, il controllo qui sopra ti protegge.

Come si cambia il timeout MCP?

Un limite troppo corto interrompe il lavoro legittimo. Uno troppo lungo ti lascia ad aspettare. Dove lo imposti dipende dall’app di IA. Ecco le impostazioni di Claude Code.

Il valore predefinito di 60 secondi per i server remoti. Un server raggiunto via HTTP, SSE o come connettore di claude.ai ha un secondo timer. Si applica a ogni richiesta fino al primo byte di risposta del server. Dura 60 secondi, a meno che MCP_TOOL_TIMEOUT, il timeout del server o MCP_TIMEOUT non siano impostati più alti. I server stdio locali non hanno un timer per richiesta.

Per impostarlo per un solo server, aggiungi "timeout": 600000 alla sua voce in .mcp.json. Sono dieci minuti.

Una chiamata lenta non è sempre una chiamata fallita. Dalla versione 2.1.212, Claude Code sposta in un’attività in background una chiamata MCP nella conversazione principale dopo due minuti. Consegna il risultato quando la chiamata finisce.

La documentazione MCP di Cursor non descrive nessuna impostazione di timeout. La specifica MCP non indica alcun numero. Dice che gli SDK dovrebbero permettere di configurare i timeout per richiesta, e che un client dovrebbe sempre mantenere un massimo.

Per il lavoro che richiede minuti, un server può usare MCP Tasks. Restituisce subito un handle, e il client fa polling sul risultato, anche dopo una riconnessione. Devono supportarlo entrambe le parti, e il supporto dei client varia.

Cosa fa Delta MCP quando una risposta si perde?

Delta MCP è un’app gratuita sul tuo computer, tra la tua IA e i suoi strumenti. Quando una modifica non riceve risposta, non indovina e non si limita a riprovare. Legge lo strumento.

Prima che una modifica parta, Delta MCP sceglie una lettura che può mostrare se è avvenuta. Quella lettura è rileggere l’oggetto, o rileggere una lista. Quando non arriva risposta, esegue subito quella lettura. Ciò che mostra la lettura decide:

Una chiamata a uno strumento fatta così com’è non può essere annullata da Delta MCP. Se una chiamata precedente è riuscita, resta fatta, e la risposta la elenca perché la tua IA non la ripeta. Ogni task che cambia qualcosa viene conservato in Activity, con ogni modifica prima e dopo.

Come viene controllato e applicato un task