Salta ai contenuti

MCP risoluzione problemi

https://mcp.engram.page
  • URL errato. L’endpoint MCP si trova a /api/mcp (vedi endpoint sopra). L’host senza percorso non è l’endpoint MCP e restituirà un errore 404.
  • TLS per self-host. L’endpoint MCP deve essere HTTPS. HTTP non protetto viene rifiutato dai client secondo OAuth 2.1.
  • Backend non raggiungibile.Verifica di poter accedere direttamente a/api/health`. Se fallisce, MCP non può funzionare.
  • Account non attivo. Accedi a app.engram.page e verifica che la tua sottoscrizione sia valida.
  • Configurazione non completata. Completa la configurazione su app.engram.page (le condizioni d’uso, più la fase di configurazione del vault per alcune registrazioni). L’errore 403 include un link alla fase che ti manca.
  • Limitato durante l’autenticazione OAuth. Aspetta un minuto e riprova.
  • Verifica che il vault sia stato effettivamente sincronizzato da Obsidian. Controlla il Centro di sincronizzazione e app.engram.page.
  • Verifica che il token OAuth includa effettivamente lo scope mcp; aggiungi nuovamente il Connector se hai saltato l’autorizzazione durante la prima installazione.
  • Prova una query più specifica. La ricerca semantica restituisce i primi K risultati, quindi query vaghe su un vault grande potrebbero non mostrare ciò che ti aspetti.

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

Codex 0.163 e versioni precedenti potrebbero continuare a tentare l’accesso anche se non più valido, oppure perdere i dati di accesso, invece di chiederti di effettuare nuovamente il login (problemi segnalati openai/codex#48507 e openai/codex#39054, entrambi ancora aperti). Codex 0.164.0 interrompe i tentativi di accesso falliti, quindi aggiorna prima Codex.

Se gli strumenti di Engram continuano a non funzionare, riconnettiti. Esegui questo comando, usando il nome che hai dato al server quando lo hai aggiunto:

Finestra del terminale
codex mcp login engram
  • Log del server: per la versione self-host, consulta Self-Host
  • Log di sistema: Claude Desktop → Aiuto → Apri la console per sviluppatori
  • Segnala problemi su engram-app/engram