Solución de problemas de MCP

Endpoints

https://mcp.engram.page

”Failed to connect”

• URL incorrecta. El endpoint MCP está en /api/mcp (consulta los endpoints de arriba). El host sin ruta no es el endpoint MCP y devolverá 404.
• TLS en self-host. El endpoint MCP debe usar HTTPS. Los clientes rechazan HTTP plano según OAuth 2.1.
• Backend inaccesible. Comprueba que puedes acceder directamente a /api/health. Si eso falla, MCP no puede funcionar.

”Authorization failed”

• Cuenta no activa. Inicia sesión en app.engram.page y comprueba que tu suscripción está al día.
• Incorporación sin completar. Engram exige aceptar los Términos antes de poder usar los endpoints de la bóveda (incluido MCP).
• Límite de peticiones durante OAuth. Espera un minuto y vuelve a intentarlo.

Claude no encuentra notas

• Confirma que la bóveda se ha sincronizado realmente desde Obsidian. Revisa el Centro de sincronización y app.engram.page.
• Confirma que el token OAuth lleva realmente el scope mcp; vuelve a añadir el conector si omitiste la autorización en la primera instalación.
• Prueba con una consulta más específica. La búsqueda semántica devuelve los K mejores resultados, así que las consultas vagas en una bóveda grande pueden no mostrar lo que esperas.

”Token expired”

Los tokens OAuth tienen una vida útil limitada. La mayoría de los clientes renuevan el token automáticamente; vuelve a intentar la operación. Si el fallo continúa, elimina el conector y vuelve a añadirlo.

Dónde buscar más información

• Registros del servidor: para self-host, consulta Self-Host
• Registros del cliente: Claude Desktop → Help → Open developer console
• Abre incidencias en engram-app/engram