Устранение неполадок MCP

Эндпоинты

https://mcp.engram.page

«Failed to connect»

• Неверный URL. MCP-эндпоинт находится по адресу /api/mcp (см. эндпоинты выше). Голый хост (без пути) не является MCP-эндпоинтом и вернёт 404.
• TLS при самостоятельном хостинге. MCP-эндпоинт должен работать по HTTPS. Обычный HTTP клиенты отклоняют согласно OAuth 2.1.
• Бэкенд недоступен. Проверьте, что /api/health отвечает напрямую. Если нет, MCP работать не может.

«Authorization failed»

• Учётная запись неактивна. Войдите на app.engram.page и проверьте, что с подпиской всё в порядке.
• Онбординг не завершён. Engram требует принять Условия, прежде чем станут доступны эндпоинты хранилища (включая MCP).
• Превышен лимит запросов во время OAuth. Подождите минуту и повторите.

Claude не находит заметки

• Убедитесь, что хранилище действительно синхронизировано из Obsidian. Проверьте Центр синхронизации и app.engram.page.
• Убедитесь, что OAuth-токен действительно несёт область mcp; добавьте коннектор заново, если при первой установке вы пропустили авторизацию.
• Попробуйте более конкретный запрос. Семантический поиск возвращает top-K, поэтому расплывчатые запросы по большому хранилищу могут не найти то, что вы ожидаете.

«Token expired»

У OAuth-токенов ограниченный срок жизни. Большинство клиентов обновляют их автоматически; повторите операцию. Если ошибка не уходит, удалите коннектор и добавьте его заново.

Где искать дополнительную информацию

• Серверные логи: для самостоятельного хостинга см. Self-Host
• Логи клиента: Claude Desktop → Help → Open developer console
• Сообщайте о проблемах в engram-app/engram