MCP solución de problemas
Puntos finales
Sección titulada «Puntos finales»https://mcp.engram.pageFailed to connect
Sección titulada «Failed to connect»- URL incorrecta. El punto final MCP se encuentra en
/api/mcp(consulta puntos finales arriba). El host sin ruta no es el punto final MCP y devolverá un error 404. - Autoalojamiento con TLS. El punto final MCP debe ser HTTPS. HTTP sin cifrar es rechazado por los clientes según OAuth 2.1.
- El servidor no es accesible. Verifica que puedes acceder directamente a
/api/health. Si eso falla, MCP no podrá funcionar.
Authorization failed
Sección titulada «Authorization failed»- Cuenta inactiva. Inicia sesión en
app.engram.pagey verifica que tu suscripción esté activa. - La configuración no está completa. Finaliza la configuración en
app.engram.page(los términos y condiciones, más el paso de la bóveda para algunos usuarios). El error 403 incluye un enlace al paso que falta. - Límite de solicitudes durante la autenticación OAuth. Espera un momento e inténtalo de nuevo.
Claude no encuentra ninguna nota
Sección titulada «Claude no encuentra ninguna nota»- Confirma que la bóveda se haya sincronizado realmente desde Obsidian. Verifica el Centro de sincronización y
app.engram.page. - Confirma que el token OAuth tenga el alcance
mcp; vuelve a agregar el Conector si omitiste la autorización durante la instalación inicial. - Intenta una consulta más específica. La búsqueda semántica devuelve los top-K, por lo que las consultas vagas en una bóveda grande podrían no mostrar lo que esperas.
Token expired
Sección titulada «Token expired»Los tokens OAuth tienen una duración limitada. La mayoría de los clientes gestionan la renovación automáticamente; intenta la operación de nuevo. Si el error persiste, elimina y vuelve a agregar el Conector.
Codex ha perdido el acceso a Engram
Sección titulada «Codex ha perdido el acceso a Engram»Las versiones 0.163 y anteriores de Codex pueden seguir intentando iniciar sesión con credenciales inválidas, o perder la sesión, en lugar de pedirte que inicies sesión de nuevo (problemas relacionados openai/codex#48507 y openai/codex#39054, ambos aún abiertos). La versión 0.164.0 de Codex deja de intentar iniciar sesión si falla, así que actualiza Codex primero.
Si las herramientas de Engram siguen fallando, reconéctalas. Ejecuta esto, utilizando el nombre que le diste al servidor cuando lo agregaste:
codex mcp login engramDónde buscar más información
Sección titulada «Dónde buscar más información»- Registros del servidor: para el autoalojamiento, consulta Autoalojamiento
- Registros del cliente: Claude Escritorio → Ayuda → Abrir la consola del desarrollador
- Reporta problemas en engram-app/engram