# FAQ по устранению проблем
SUMMARY: Решения типовых проблем Synapse — аутентификация, сеть, данные, развёртывание.

FAQ по устранению проблем
Решения типовых проблем Synapse.
Не могу войти
Симптомы
-  возвращает 401
- «Invalid email or password»
Решения
1. Проверьте email — чувствителен к регистру
2. Проверьте пароль — минимум 6 символов
3. Сначала зарегистрируйтесь, если нет аккаунта: 
4. Сбросьте пароль (если настроен SMTP) через веб-интерфейс
Я потерял Mind Key
Симптомы
- Не могу получить доступ к воспоминаниям
- Mind Key удалён/потерян
Решения
Mind Key нельзя восстановить. Необходимо:
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 точно — чувствителен к регистру, без trailing-слешей
3. Проверьте HTTP-метод —  и  различаются
API-вызовы возвращают 429
Симптомы
- 429 Too Many Requests
- «Rate limit exceeded»
Решения
1. Перейдите на header-auth (без лимита):
   [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. Проверьте место на диске: 
Для хостинга: сообщите в поддержку.
Вебхук не срабатывает
Симптомы
- Зарегистрировали вебхук, но колбэки не приходят
- Нет POST на ваш URL
Решения
1. Убедитесь, что URL доступен: 
2. Проверьте фильтр событий —  соответствует всем событиям памяти
3. Протестируйте вебхук: 
4. Проверьте, что вебхук включён: 
5. Проверьте SSL — Synapse требует валидный HTTPS для URL вебхуков
См. 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. Контакт: см. страницу 
Следующие шаги
- Ошибки и обработка ошибок
- FAQ по API
- Устранение проблем MCP