Ir al contenido

MCP solución de problemas

https://mcp.engram.page
  • 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.
  • Cuenta inactiva. Inicia sesión en app.engram.page y 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.
  • 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.

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.

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:

Ventana de terminal
codex mcp login engram
  • 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