{"title":"FAQ по устранению проблем","slug":"troubleshooting","category":"faq","summary":"Решения типовых проблем Synapse — аутентификация, сеть, данные, развёртывание.","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":613,"read_minutes":3,"lang":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# FAQ по устранению проблем\n\nРешения типовых проблем Synapse.\n\n## Не могу войти\n\n### Симптомы\n\n- `POST /login` возвращает 401\n- «Invalid email or password»\n\n### Решения\n\n1. **Проверьте email** — чувствителен к регистру\n2. **Проверьте пароль** — минимум 6 символов\n3. **Сначала зарегистрируйтесь**, если нет аккаунта: `POST /register`\n4. **Сбросьте пароль** (если настроен SMTP) через веб-интерфейс\n\n## Я потерял Mind Key\n\n### Симптомы\n\n- Не могу получить доступ к воспоминаниям\n- Mind Key удалён/потерян\n\n### Решения\n\nMind Key нельзя восстановить. Необходимо:\n\n1. Войти для получения JWT: `POST /login`\n2. Получить список mind: `GET /minds` (с JWT)\n3. Создать новый mind: `POST /minds`\n4. Сохранить новый Mind Key\n5. (Опционально) Удалить старый mind: `DELETE /minds/:id`\n\n**Данные в старом mind утеряны**, если вы не сможете найти Mind Key.\n\n## API-вызовы возвращают 401\n\n### Симптомы\n\n- Все API-вызовы возвращают 401 Unauthorized\n- «Mind Key fehlt oder ungültig»\n\n### Решения\n\n1. **Проверьте формат заголовка**: `Authorization: Bearer mk_...`\n2. **Проверьте, что Mind Key начинается с `mk_`** (а не `eyJ` — это JWT)\n3. **Протестируйте напрямую**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **Mind Key мог быть отозван** — создайте новый mind\n\nСм. [Аутентификация](/docs/getting-started/authentication).\n\n## API-вызовы возвращают 404\n\n### Симптомы\n\n- 404 Not Found\n- «Route not found»\n\n### Решения\n\n> [!CRITICAL]\n> Не угадывайте пути эндпоинтов. Существуют только пути из `GET /endpoints`.\n\n1. **Проверьте допустимые эндпоинты**: `curl https://synapse.schaefer.zone/endpoints`\n2. **Сравните URL точно** — чувствителен к регистру, без trailing-слешей\n3. **Проверьте HTTP-метод** — `GET /memory` и `POST /memory` различаются\n\n## API-вызовы возвращают 429\n\n### Симптомы\n\n- 429 Too Many Requests\n- «Rate limit exceeded»\n\n### Решения\n\n1. **Перейдите на header-auth** (без лимита):\n ```bash\n # Don't\n curl \".../memory/recall?key=mk_...\"\n \n # Do\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. **Подождите `Retry-After` секунд**, если необходимо использовать `?key=`\n\nСм. [Лимиты запросов](/docs/api/rate-limits).\n\n## Поиск по памяти возвращает пустой результат\n\n### Симптомы\n\n- `GET /memory/search?q=...` возвращает пусто\n- Знаю, что воспоминания есть\n\n### Решения\n\n1. **Убедитесь, что воспоминания существуют**: `GET /memory/recall`\n2. **Проверьте синтаксис поиска** — у FTS5 специфический синтаксис\n3. **Попробуйте более простой запрос** — `?q=docker` вместо `?q=docker+swarm+deployment`\n4. **Используйте семантический поиск** для концептуальных запросов: `GET /memory/semantic-search?q=...`\n\nСм. [FTS5-поиск](/docs/concepts/fts5-search).\n\n## Воспоминания не сохраняются\n\n### Симптомы\n\n- POST /memory возвращает успех\n- GET /memory/recall не показывает их\n\n### Решения\n\n1. **Убедитесь, что тот же Mind Key** — разные ключи = разные mind\n2. **Проверьте ответ** — POST возвращает `{ \"id\": \"mem_...\", \"status\": \"stored\" }`\n3. **Попробуйте GET /memory** (JSON-список) вместо /memory/recall (текст)\n4. **Проверьте фильтр** — `?category=` или `?tag=` могут скрывать их\n\n## Инструменты не появляются в Claude Desktop\n\n### Симптомы\n\n- Claude Desktop показывает 0 инструментов\n- Нет иконки 🔌\n\n### Решения\n\n1. **Полностью перезапустите Claude Desktop** (Cmd+Q)\n2. **Проверьте, что файл конфигурации** — валидный JSON\n3. **Убедитесь, что установлен Node.js 18+**\n4. **Запустите MCP вручную**: `npx -y synapse-mcp-api@latest`\n5. **Проверьте логи**: `~/Library/Logs/Claude/mcp.log`\n\nСм. [Устранение проблем MCP](/docs/mcp/troubleshooting).\n\n## Synapse недоступен\n\n### Симптомы\n\n- Не удаётся подключиться к synapse.schaefer.zone\n- curl тайм-аутится\n\n### Решения\n\n1. **Проверьте интернет** — попробуйте другой сайт\n2. **Проверьте здоровье Synapse**: `curl https://synapse.schaefer.zone/health`\n3. **Подождите** — возможен временный сбой или развёртывание\n4. **Проверьте страницу статуса** (если есть)\n\nДля self-hosted: проверьте статус Docker-контейнера, подключение к БД.\n\n## Ошибки базы данных\n\n### Симптомы\n\n- 500 Internal Server Error\n- «Database connection failed»\n\n### Решения\n\nДля self-hosted:\n\n1. **Проверьте, что PostgreSQL запущен**: `docker ps | grep postgres`\n2. **Проверьте DATABASE_URL** в окружении\n3. **Проверьте миграции**: `npm run migrate:check`\n4. **Проверьте место на диске**: `df -h`\n\nДля хостинга: сообщите в поддержку.\n\n## Вебхук не срабатывает\n\n### Симптомы\n\n- Зарегистрировали вебхук, но колбэки не приходят\n- Нет POST на ваш URL\n\n### Решения\n\n1. **Убедитесь, что URL доступен**: `curl -X POST your-url -d '{}'`\n2. **Проверьте фильтр событий** — `memory.*` соответствует всем событиям памяти\n3. **Протестируйте вебхук**: `POST /webhooks/:id/test`\n4. **Проверьте, что вебхук включён**: `GET /webhooks/:id`\n5. **Проверьте SSL** — Synapse требует валидный HTTPS для URL вебхуков\n\nСм. [Webhooks API](/docs/api/webhooks).\n\n## Cron-задача не запускается\n\n### Симптомы\n\n- Создали cron-задачу, но она не срабатывает\n- `next_run` не обновляется\n\n### Решения\n\n1. **Проверьте синтаксис расписания** — должен быть валидный 5-полейный cron ИЛИ целое число секунд\n2. **Убедитесь, что эндпоинт разрешён** — должен быть http(s), без приватных IP\n3. **Проверьте, что задача включена**: `GET /cron`\n4. **Дождитесь следующего запланированного времени** — cron не мгновенный\n\nСм. [Cron и планировщик](/docs/api/cron).\n\n## Нужно больше помощи?\n\n1. **Проверьте существующую документацию**: \n2. **Поиск по документации**: `GET /docs/search?q=your+question`\n3. **Создайте issue**: \n4. **Контакт**: см. страницу `/support`\n\n## Следующие шаги\n\n- [Ошибки и обработка ошибок](/docs/api/errors)\n- [FAQ по API](/docs/faq/api-faq)\n- [Устранение проблем MCP](/docs/mcp/troubleshooting)\n","content_html":"

FAQ по устранению проблем

\n

Решения типовых проблем Synapse.

\n

Не могу войти

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Проверьте email — чувствителен к регистру
    2. \n
  2. Проверьте пароль — минимум 6 символов
    3. \n
  3. Сначала зарегистрируйтесь, если нет аккаунта: POST /register
    4. \n
  4. Сбросьте пароль (если настроен SMTP) через веб-интерфейс
    5. \n
\n

Я потерял Mind Key

\n

Симптомы

\n\n

Решения

\n

Mind Key нельзя восстановить. Необходимо:

\n
    \n
  1. Войти для получения JWT: POST /login
    2. \n
  2. Получить список mind: GET /minds (с JWT)
    3. \n
  3. Создать новый mind: POST /minds
    4. \n
  4. Сохранить новый Mind Key
    5. \n
  5. (Опционально) Удалить старый mind: DELETE /minds/:id
    6. \n
\n

Данные в старом mind утеряны, если вы не сможете найти Mind Key.

\n

API-вызовы возвращают 401

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Проверьте формат заголовка: Authorization: Bearer mk_...
    2. \n
  2. Проверьте, что Mind Key начинается с mk_ (а не eyJ — это JWT)
    3. \n
  3. Протестируйте напрямую:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. Mind Key мог быть отозван — создайте новый mind
    5. \n
\n

См. Аутентификация.

\n

API-вызовы возвращают 404

\n

Симптомы

\n\n

Решения

\n
Не угадывайте пути эндпоинтов. Существуют только пути из `GET /endpoints`.
    \n
  1. Проверьте допустимые эндпоинты: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. Сравните URL точно — чувствителен к регистру, без trailing-слешей
    3. \n
  3. Проверьте HTTP-метод — GET /memory и POST /memory различаются
    4. \n
\n

API-вызовы возвращают 429

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Перейдите на header-auth (без лимита):
    # Don't\ncurl ".../memory/recall?key=mk_..."\n\n# Do\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. Подождите Retry-After секунд, если необходимо использовать ?key=
    3. \n
\n

См. Лимиты запросов.

\n

Поиск по памяти возвращает пустой результат

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Убедитесь, что воспоминания существуют: GET /memory/recall
    2. \n
  2. Проверьте синтаксис поиска — у FTS5 специфический синтаксис
    3. \n
  3. Попробуйте более простой запрос — ?q=docker вместо ?q=docker+swarm+deployment
    4. \n
  4. Используйте семантический поиск для концептуальных запросов: GET /memory/semantic-search?q=...
    5. \n
\n

См. FTS5-поиск.

\n

Воспоминания не сохраняются

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Убедитесь, что тот же Mind Key — разные ключи = разные mind
    2. \n
  2. Проверьте ответ — POST возвращает { "id": "mem_...", "status": "stored" }
    3. \n
  3. Попробуйте GET /memory (JSON-список) вместо /memory/recall (текст)
    4. \n
  4. Проверьте фильтр — ?category= или ?tag= могут скрывать их
    5. \n
\n

Инструменты не появляются в Claude Desktop

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Полностью перезапустите Claude Desktop (Cmd+Q)
    2. \n
  2. Проверьте, что файл конфигурации — валидный JSON
    3. \n
  3. Убедитесь, что установлен Node.js 18+
    4. \n
  4. Запустите MCP вручную: npx -y synapse-mcp-api@latest
    5. \n
  5. Проверьте логи: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

См. Устранение проблем MCP.

\n

Synapse недоступен

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Проверьте интернет — попробуйте другой сайт
    2. \n
  2. Проверьте здоровье Synapse: curl https://synapse.schaefer.zone/health
    3. \n
  3. Подождите — возможен временный сбой или развёртывание
    4. \n
  4. Проверьте страницу статуса (если есть)
    5. \n
\n

Для self-hosted: проверьте статус Docker-контейнера, подключение к БД.

\n

Ошибки базы данных

\n

Симптомы

\n\n

Решения

\n

Для self-hosted:

\n
    \n
  1. Проверьте, что PostgreSQL запущен: docker ps | grep postgres
    2. \n
  2. Проверьте DATABASE_URL в окружении
    3. \n
  3. Проверьте миграции: npm run migrate:check
    4. \n
  4. Проверьте место на диске: df -h
    5. \n
\n

Для хостинга: сообщите в поддержку.

\n

Вебхук не срабатывает

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Убедитесь, что URL доступен: curl -X POST your-url -d '{}'
    2. \n
  2. Проверьте фильтр событий — memory.* соответствует всем событиям памяти
    3. \n
  3. Протестируйте вебхук: POST /webhooks/:id/test
    4. \n
  4. Проверьте, что вебхук включён: GET /webhooks/:id
    5. \n
  5. Проверьте SSL — Synapse требует валидный HTTPS для URL вебхуков
    6. \n
\n

См. Webhooks API.

\n

Cron-задача не запускается

\n

Симптомы

\n\n

Решения

\n
    \n
  1. Проверьте синтаксис расписания — должен быть валидный 5-полейный cron ИЛИ целое число секунд
    2. \n
  2. Убедитесь, что эндпоинт разрешён — должен быть http(s), без приватных IP
    3. \n
  3. Проверьте, что задача включена: GET /cron
    4. \n
  4. Дождитесь следующего запланированного времени — cron не мгновенный
    5. \n
\n

См. Cron и планировщик.

\n

Нужно больше помощи?

\n
    \n
  1. Проверьте существующую документацию: https://synapse.schaefer.zone/docs
    2. \n
  2. Поиск по документации: GET /docs/search?q=your+question
    3. \n
  3. Создайте issue: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. Контакт: см. страницу /support
    5. \n
\n

Следующие шаги

\n\n","urls":{"html":"/docs/faq/troubleshooting","text":"/docs/faq/troubleshooting?format=text","json":"/docs/faq/troubleshooting?format=json","llm":"/docs/faq/troubleshooting?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}