MCP устранение неполадок
Эндпоинты
Заголовок раздела «Эндпоинты»https://mcp.engram.pageFailed to connect
Заголовок раздела «Failed to connect»- Неверный URL. Эндпоинт MCP находится по адресу
/api/mcp(см. эндпоинты выше). Сам хост (без пути) не является эндпоинтом MCP и вернет ошибку 404. - Самостоятельная настройка TLS. Эндпоинт MCP должен использовать HTTPS. Обычный HTTP отклоняется клиентами в соответствии со стандартом OAuth 2.1.
- Сервер недоступен. Убедитесь, что вы можете напрямую обратиться к
/api/health. Если это не удается, MCP не сможет работать.
Authorization failed
Заголовок раздела «Authorization failed»- Аккаунт неактивен. Войдите в
app.engram.pageи проверьте, что ваша подписка действительна. - Настройка не завершена. Завершите настройку на
app.engram.page(ознакомьтесь с условиями, а также выполните этап добавления хранилища для некоторых типов аккаунтов). Код ошибки 403 содержит ссылку на этап, который вы пропустили. - Превышен лимит запросов во время OAuth. Подождите минуту и повторите попытку.
Claude не нашел ни одной заметки
Заголовок раздела «Claude не нашел ни одной заметки»- Убедитесь, что хранилище действительно было синхронизировано с Obsidian. Проверьте Центр синхронизации и
app.engram.page. - Убедитесь, что токен OAuth действительно содержит область
mcp; добавьте соединитель заново, если вы пропустили этап авторизации при первой установке. - Попробуйте более конкретный запрос. Семантический поиск возвращает топ-K, поэтому расплывчатые запросы к большому хранилищу могут не показать то, что вы ожидаете.
Token expired
Заголовок раздела «Token expired»Токены OAuth имеют ограниченный срок действия. Большинство клиентов автоматически обновляют их; попробуйте выполнить операцию еще раз. Если ошибка сохраняется, удалите и добавьте соединитель заново.
Codex больше не может использовать Engram
Заголовок раздела «Codex больше не может использовать Engram»В версиях Codex 0.163 и более ранних может происходить повторная попытка входа, даже если он больше недействителен, или данные для входа могут быть утеряны, вместо того чтобы попросить вас войти снова (проблемы openai/codex#48507 и openai/codex#39054, обе все еще открыты). Версия Codex 0.164.0 прекращает повторные попытки входа, если он отклонен, поэтому сначала обновите Codex.
Если инструменты Engram по-прежнему не работают, переподключитесь. Выполните эту команду, используя имя, которое вы присвоили серверу при его добавлении:
codex mcp login engramГде найти больше информации
Заголовок раздела «Где найти больше информации»- Журналы на стороне сервера: для самостоятельного хостинга, смотрите Самостоятельный хостинг
- Журналы работы клиента: Claude Настольное приложение → Справка → Открыть консоль разработчика
- Сообщайте о проблемах в engram-app/engram