Zum Inhalt springen

MCP Fehlerbehebung

https://mcp.engram.page
  • Falsche URL. Der MCP-Endpunkt befindet sich unter /api/mcp (siehe Endpunkte oben). Der reine Host (ohne Pfad) ist nicht der MCP-Endpunkt und gibt einen 404-Fehler zurück.
  • Self-Host TLS. Der MCP-Endpunkt muss HTTPS verwenden. Unverschlüsseltes HTTP wird von Clients gemäß OAuth 2.1 abgelehnt.
  • Backend nicht erreichbar. Stelle sicher, dass du /api/health direkt erreichen kannst. Wenn das fehlschlägt, kann MCP nicht funktionieren.
  • Konto nicht aktiv. Melde dich bei app.engram.page an und überprüfe, ob dein Abonnement gültig ist.
  • Einrichtung nicht abgeschlossen. Schließe die Einrichtung unter app.engram.page ab (die Nutzungsbedingungen und der Vault-Schritt für einige Anmeldungen). Die 403-Meldung enthält einen Link zu dem fehlenden Schritt.
  • Während der OAuth-Authentifizierung wurde die Rate begrenzt. Warte eine Minute und versuche es erneut.
  • Stelle sicher, dass der Vault tatsächlich von Obsidian synchronisiert wurde. Überprüfe die Sync-Zentrale und app.engram.page.
  • Stelle sicher, dass das OAuth-Token den mcp-Bereich enthält; füge den Connector erneut hinzu, wenn du die Autorisierung bei der ersten Installation übersprungen hast.
  • Versuche eine spezifischere Abfrage. Die semantische Suche liefert die Top-K-Ergebnisse, daher können vage Abfragen in einem großen Vault möglicherweise nicht das liefern, was du erwartest.

OAuth-Token haben eine begrenzte Lebensdauer. Die meisten Clients handhaben die Aktualisierung automatisch; versuche die Operation erneut. Wenn der Fehler weiterhin besteht, entferne und füge den Connector erneut hinzu.

Codex 0.163 und frühere Versionen können immer wieder versuchen, dich anzumelden, auch wenn die Anmeldung ungültig ist, oder die gespeicherte Anmeldung verlieren, anstatt dich erneut zur Anmeldung aufzufordern (Probleme openai/codex#48507 und openai/codex#39054, beide noch offen). Codex 0.164.0 stoppt die wiederholten Versuche einer fehlgeschlagenen Anmeldung. Aktualisiere also zuerst Codex.

Wenn die Engram-Tools weiterhin fehlschlagen, verbinde sie erneut. Führe dies aus, wobei du den Namen verwendest, den du dem Server gegeben hast, als du ihn hinzugefügt hast:

Terminal-Fenster
codex mcp login engram
  • Server-seitige Protokolle: Für Self-Host, siehe Self-Host
  • Client-seitige Protokolle: Claude Desktop → Hilfe → Entwicklerkonsole öffnen
  • Melde Fehler bei engram-app/engram