# FAQ з усунення несправностей
SUMMARY: Рішення поширених проблем Synapse — автентифікація, мережа, дані, розгортання.

FAQ з усунення несправностей
Рішення поширених проблем Synapse.
Не можу увійти
Симптоми
-  повертає 401
- «Invalid email or password»
Рішення
1. Перевірте, що email правильний — чутливий до регістру
2. Перевірте пароль — мінімум 6 символів
3. Спочатку зареєструйтесь, якщо немає облікового запису: 
4. Скиньте пароль (якщо налаштовано SMTP) через веб-інтерфейс
Я втратив Mind Key
Симптоми
- Не можу доступатися до спогадів
- Mind Key видалено/втрачено
Рішення
Mind Keys неможливо відновити. Вам потрібно:
1. Увійти, щоб отримати JWT: 
2. Вивести список mind-ів:  (з JWT)
3. Створити новий mind: 
4. Зберегти новий Mind Key
5. (Опціонально) Видалити старий mind: 
Дані у старому mind-і втрачено, якщо ви не зможете знайти Mind Key.
API-виклики повертають 401
Симптоми
- Усі API-виклики повертають 401 Unauthorized
- «Mind Key fehlt oder ungültig»
Рішення
1. Перевірте формат заголовка: 
2. Перевірте, що Mind Key починається з  (не , що є JWT)
3. Протестуйте напряму:
   [CODE BLOCK]
4. Mind Key може бути відкликано — створіть новий mind
Дивіться Автентифікацію.
API-виклики повертають 404
Симптоми
- 404 Not Found
- «Route not found»
Рішення
> [!CRITICAL]
> Не вгадуйте шляхи кінцевих точок. Існують лише шляхи зі списку .
1. Перевірте дійсні кінцеві точки: 
2. Порівняйте URL точно — чутливий до регістру, без кінцевих слешів
3. Перевірте HTTP-метод —  та  різні
API-виклики повертають 429
Симптоми
- 429 Too Many Requests
- «Rate limit exceeded»
Рішення
1. Перейдіть на автентифікацію через заголовок (без обмеження):
   [CODE BLOCK]
2. Зачекайте  секунд, якщо доводиться використовувати 
Дивіться Обмеження частоти.
Пошук спогадів не повертає результатів
Симптоми
-  повертає порожньо
- Знаєте, що спогади існують
Рішення
1. Перевірте, що спогади існують: 
2. Перевірте синтаксис пошуку — у FTS5 специфічний синтаксис
3. Спробуйте простіший запит —  замість 
4. Використовуйте семантичний пошук для концептуальних запитів: 
Дивіться Пошук FTS5.
Спогади не зберігаються
Симптоми
- POST /memory повертає успіх
- GET /memory/recall не показує їх
Рішення
1. Перевірте, що той самий Mind Key — різні ключі = різні mind-и
2. Перевірте відповідь — POST повертає 
3. Спробуйте GET /memory (JSON-список) замість /memory/recall (текст)
4. Перевірте фільтр —  або  можуть ховати їх
Інструменти не з'являються в Claude Desktop
Симптоми
- Claude Desktop показує 0 інструментів
- Немає іконки 🔌
Рішення
1. Повністю перезапустіть Claude Desktop (Cmd+Q)
2. Перевірте, що файл конфігурації є коректним JSON
3. Перевірте Node.js 18+ встановлено
4. Запустіть MCP вручну: 
5. Перевірте логи: 
Дивіться Усунення несправностей MCP.
Synapse офлайн
Симптоми
- Не можна досягти synapse.schaefer.zone
- curl тайм-аутиться
Рішення
1. Перевірте інтернет — спробуйте інший сайт
2. Перевірте стан Synapse: 
3. Зачекайте — можливо, тимчасовий збій або розгортання
4. Перевірте сторінку статусу (якщо є)
Для self-hosted: перевірте статус Docker-контейнера, підключення до БД.
Помилки бази даних
Симптоми
- 500 Internal Server Error
- «Database connection failed»
Рішення
Для self-hosted:
1. Перевірте, що PostgreSQL працює: 
2. Перевірте DATABASEURL у середовищі
3. Перевірте міграції: 
4. Перевірте місце на диску: 
Для хостингу: зверніться до підтримки.
Webhook не спрацьовує
Симптоми
- Зареєстровано webhook, але не отримуєте зворотних викликів
- Немає POST на ваш URL
Рішення
1. Перевірте, що URL доступний: 
2. Перевірте фільтр подій —  ловить усі події пам'яті
3. Протестуйте webhook: 
4. Перевірте, що webhook увімкнено: 
5. Перевірте SSL — Synapse потребує дійсний HTTPS для URL webhook-ів
Дивіться Webhooks API.
Cron-завдання не запускається
Симптоми
- Створено cron-завдання, але воно не спрацьовує
-  не оновлюється
Рішення
1. Перевірте синтаксис розкладу — має бути коректний 5-польовий cron АБО ціле число секунд
2. Перевірте, що кінцева точка дозволена — має бути http(s), без приватних IP
3. Перевірте, що завдання увімкнено: 
4. Зачекайте на наступний запланований час — cron не миттєвий
Дивіться Cron та планувальник.
Потрібна додаткова допомога?
1. Перевірте наявну документацію: <https://synapse.schaefer.zone/docs>
2. Шукайте в документах: 
3. Відкрийте issue: <https://gitlab.com/schaefer-services/synapse/-/issues>
4. Контакт: дивіться сторінку 
Наступні кроки
- Помилки та обробка помилок
- API FAQ
- Усунення несправностей MCP