Risoluzione dei problemi MCP

Endpoint

https://mcp.engram.page

”Failed to connect”

• URL sbagliato. L’endpoint MCP si trova in /api/mcp (vedi gli endpoint qui sopra). L’host nudo (senza percorso) non è l’endpoint MCP e restituirà 404.
• TLS in self-host. L’endpoint MCP deve essere HTTPS. I client rifiutano l’HTTP semplice, come richiede OAuth 2.1.
• Backend non raggiungibile. Verifica di poter raggiungere /api/health direttamente. Se non funziona, MCP non può funzionare.

”Authorization failed”

• Account non attivo. Accedi a app.engram.page e controlla che il tuo abbonamento sia in regola.
• Onboarding non completato. Engram richiede l’accettazione dei Termini prima che gli endpoint dell’archivio (MCP compreso) siano utilizzabili.
• Limite di richieste durante OAuth. Attendi un minuto e riprova.

Claude non trova note

• Verifica che l’archivio sia stato effettivamente sincronizzato da Obsidian. Controlla il Centro di sincronizzazione e app.engram.page.
• Verifica che il token OAuth abbia davvero l’ambito mcp; aggiungi di nuovo il connettore se hai saltato l’autorizzazione alla prima installazione.
• Prova una richiesta più specifica. La ricerca semantica restituisce i primi K risultati, quindi richieste vaghe su un archivio grande potrebbero non far emergere ciò che ti aspetti.

”Token expired”

I token OAuth hanno una durata limitata. La maggior parte dei client gestisce il rinnovo automaticamente; riprova l’operazione. Se l’errore persiste, rimuovi e aggiungi di nuovo il connettore.

Dove trovare altre informazioni

• Log lato server: per il self-host, vedi Self-hosting
• Log lato client: Claude Desktop → Help → Open developer console
• Segnala i problemi su engram-app/engram