MCP-Fehlerbehebung

Endpunkte

https://mcp.engram.page

„Failed to connect”

• Falsche URL. Der MCP-Endpunkt liegt unter /api/mcp (siehe Endpunkte oben). Der nackte Host (ohne Pfad) ist nicht der MCP-Endpunkt und liefert 404.
• TLS beim Self-Hosting. Der MCP-Endpunkt muss HTTPS nutzen. Klartext-HTTP lehnen Clients laut OAuth 2.1 ab.
• Backend nicht erreichbar. Prüfe, ob du /api/health direkt aufrufen kannst. Schlägt das fehl, kann MCP unmöglich funktionieren.

„Authorization failed”

• Konto nicht aktiv. Melde dich bei app.engram.page an und prüfe, ob dein Abonnement in Ordnung ist.
• Onboarding nicht abgeschlossen. Engram verlangt die Zustimmung zu den Nutzungsbedingungen, bevor Vault-Endpunkte (auch MCP) nutzbar sind.
• Rate-Limit während OAuth. Warte eine Minute und versuche es erneut.

Claude findet keine Notizen

• Prüfe, ob der Vault tatsächlich aus Obsidian synchronisiert wurde. Sieh in der Sync-Zentrale und auf app.engram.page nach.
• Prüfe, ob das OAuth-Token wirklich den Scope mcp trägt. Füge den Connector erneut hinzu, falls du die Autorisierung bei der Installation übersprungen hast.
• Probiere eine genauere Anfrage. Die semantische Suche liefert die Top-K, daher findet eine vage Anfrage in einem großen Vault womöglich nicht das, was du erwartest.

„Token expired”

OAuth-Tokens haben eine begrenzte Lebensdauer. Die meisten Clients erneuern sie automatisch, versuche den Vorgang also noch einmal. Hält der Fehler an, entferne den Connector und füge ihn erneut hinzu.

Wo du mehr Informationen findest

• Server-Logs: Beim Self-Hosting siehe Self-Hosting
• Client-Logs: Claude Desktop → Help → Open developer console
• Melde Probleme unter engram-app/engram