# FAQ Troubleshooting
SUMMARY: Soluzioni ai problemi comuni di Synapse — auth, rete, dati, deployment.

FAQ Troubleshooting
Soluzioni ai problemi comuni di Synapse.
Non riesco a fare login
Sintomi
-  restituisce 401
- "Invalid email or password"
Soluzioni
1. Verifichi che l'email sia corretta — case sensitive
2. Controlli la password — minimo 6 caratteri
3. Si registri prima se non ha un account: 
4. Resetti la password (se SMTP configurato) tramite la UI web
Ho perso la mia Mind Key
Sintomi
- Non riesco ad accedere alle memorie
- La Mind Key è stata eliminata/persa
Soluzioni
Le Mind Key non possono essere recuperate. Deve:
1. Fare login per ottenere JWT: 
2. Elencare le menti:  (con JWT)
3. Creare una nuova mente: 
4. Salvare la nuova Mind Key
5. (Opzionale) Eliminare la vecchia mente: 
I dati nella vecchia mente sono persi a meno che non ritrovi la Mind Key.
Le chiamate API restituiscono 401
Sintomi
- Tutte le chiamate API restituiscono 401 Unauthorized
- "Mind Key fehlt oder ungültig"
Soluzioni
1. Verifichi il formato dell'header: 
2. Controlli che la Mind Key inizi con  (non  che è JWT)
3. Testi direttamente:
   [CODE BLOCK]
4. La Mind Key potrebbe essere revocata — crei una nuova mente
Veda Autenticazione.
Le chiamate API restituiscono 404
Sintomi
- 404 Not Found
- "Route not found"
Soluzioni
> [!CRITICAL]
> Non indovini i percorsi degli endpoint. Esistono solo i percorsi in
> .
1. Controlli gli endpoint validi: 
2. Confronti l'URL esattamente — case sensitive, nessuno slash finale
3. Controlli il metodo HTTP —  vs  sono diversi
Le chiamate API restituiscono 429
Sintomi
- 429 Too Many Requests
- "Rate limit exceeded"
Soluzioni
1. Passi all'auth tramite header (nessun rate limit):
   [CODE BLOCK]
2. Attenda  secondi se deve usare 
Veda Limiti di traffico.
La ricerca nelle memorie non restituisce risultati
Sintomi
-  restituisce vuoto
- Sa che le memorie esistono
Soluzioni
1. Verifichi che le memorie esistano: 
2. Controlli la sintassi di ricerca — FTS5 ha una sintassi specifica
3. Provi una query più semplice —  invece di 
4. Usi la ricerca semantica per query concettuali: 
Veda Ricerca FTS5.
Le memorie non persistono
Sintomi
- POST /memory restituisce success
- GET /memory/recall non le mostra
Soluzioni
1. Verifichi la stessa Mind Key — chiavi diverse = menti diverse
2. Controlli la risposta — POST restituisce 
3. Provi GET /memory (lista JSON) invece di /memory/recall (testo)
4. Controlli i filtri —  o  potrebbero nasconderle
Gli strumenti non appaiono in Claude Desktop
Sintomi
- Claude Desktop mostra 0 strumenti
- Nessuna icona 🔌
Soluzioni
1. Riavvii completamente Claude Desktop (Cmd+Q)
2. Verifichi che il file di configurazione sia JSON valido
3. Controlli Node.js 18+ installato
4. Esegua MCP manualmente: 
5. Controlli i log: 
Veda Troubleshooting MCP.
Synapse è offline
Sintomi
- Non riesce a raggiungere synapse.schaefer.zone
- curl va in timeout
Soluzioni
1. Controlli la sua internet — provi un altro sito
2. Controlli la salute di Synapse: 
3. Attenda — potrebbe essere un outage temporaneo o deployment
4. Controlli la pagina di stato (se disponibile)
Per self-hosted: controlli lo stato del container Docker, la connessione al
database.
Errori del database
Sintomi
- 500 Internal Server Error
- "Database connection failed"
Soluzioni
Per self-hosted:
1. Controlli che PostgreSQL sia in esecuzione: 
2. Controlli DATABASEURL nell'env
3. Controlli le migrazioni: 
4. Controlli lo spazio su disco: 
Per hosted: segnali al support.
Webhook non si attiva
Sintomi
- Webhook registrato ma non riceve callback
- Nessuna POST alla sua URL
Soluzioni
1. Verifichi che l'URL sia raggiungibile: 
2. Controlli il filtro eventi —  corrisponde a tutti gli eventi memory
3. Testi il webhook: 
4. Controlli che il webhook sia abilitato: 
5. Verifichi SSL — Synapse richiede HTTPS valido per le URL dei webhook
Veda Webhooks API.
Il cron job non viene eseguito
Sintomi
- Creato cron job ma non si attiva
-  non si aggiorna
Soluzioni
1. Controlli la sintassi della pianificazione — deve essere cron a 5 campi valido OPP secondi interi
2. Verifichi che l'endpoint sia consentito — deve essere http(s), no IP privati
3. Controlli che il job sia abilitato: 
4. Attenda il prossimo momento pianificato — cron non è istantaneo
Veda Cron & Scheduler.
Ha bisogno di altro aiuto?
1. Controlli la documentazione esistente: <https://synapse.schaefer.zone/docs>
2. Cerchi nella documentazione: 
3. Apra un issue: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. Contatti: veda la pagina 
Prossimi passi
- Errori e gestione degli errori
- FAQ API
- Troubleshooting MCP