Claude Code

Die CLI claude mcp add von Claude Code übernimmt die Konfigurationsänderung für dich und hält die Registrierung pro Projekt oder pro Nutzer getrennt. OAuth läuft beim ersten Aufruf eines Engram-Tools in deinem Browser. Hintergrund zum Protokoll findest du unter MCP.

Voraussetzungen

Bevor du anfängst, prüfe:

• Du hast ein Engram-Konto unter app.engram.page.
• Mindestens ein Vault ist synchronisiert. Öffne das Obsidian-Plugin oder die Web-App und prüfe, ob Notizen innerhalb des letzten Tages synchronisiert wurden.
• Du kannst dich im Browser anmelden. Der MCP-Authentifizierungsablauf öffnet ein Browserfenster.
• Wenn du statt OAuth einen API-Schlüssel nutzen willst: API-Schlüssel erfordern Pro. Die OAuth-Anmeldung funktioniert in jedem Tarif, auch im kostenlosen, und ist der empfohlene Weg. Free und Starter können keine API-Schlüssel erstellen oder verwenden.

Endpunkt

https://mcp.engram.page

Einrichtung

1. Engram bei der Claude-Code-CLI registrieren.

claude mcp add --transport http --scope user engram https://mcp.engram.page

Mit --scope user steht Engram in jedem Projekt zur Verfügung. Nimm stattdessen --scope project, um Engram auf die .mcp.json des aktuellen Repos zu beschränken.

Lieber von Hand? Füge den folgenden Block in ~/.claude.json (nutzerweit) oder in .mcp.json im Projektstamm ein:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Neu laden. Beende deine aktuelle Claude-Code-Sitzung und starte claude erneut. Mit claude mcp list prüfst du, ob Engram registriert ist. Es sollte mit dem Status △ needs authentication erscheinen.

Authentifizierung beim ersten Start

Claude Code fragt nicht von selbst nach OAuth. Führe in einer frischen Sitzung /mcp aus, wähle engram und dann Authenticate. Dein Browser öffnet sich, du meldest dich bei Engram an und bestätigst die Verbindung. Claude Code speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist der volle Scope mcp. Granulare Scopes pro Aktion stehen auf der Roadmap.

Claude beibringen, es zu nutzen

Hänge das folgende Snippet an ~/.claude/CLAUDE.md an, die Anweisungsdatei auf Nutzerebene von Claude Code. Sie gilt für jedes Projekt. Überschreibungen pro Repo gehören in eine CLAUDE.md auf Projektebene im Repo-Stamm.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Ausprobieren

Sobald Engram registriert und authentifiziert ist, frage Claude:

• Durchsuche meinen Vault nach Notizen zum Bewerbungsprozess für Entwickler und fasse die drei wichtigsten zusammen.
• Finde alles, was ich im letzten Monat über Embeddings geschrieben habe.

Claude ruft das Tool search von Engram auf (oder get_note, write_note usw.), holt Ergebnisse und antwortet im Kontext. Wenn das Tool auslöst, bist du startklar.

API-Schlüssel statt OAuth

Für Headless-Rechner, CI oder einen geteilten Vault überspringst du OAuth und bindest die Verbindung an einen Engram-API-Schlüssel. Erstelle einen unter app.engram.page/settings/api-keys und sende ihn als Bearer-Header.

Die schnelle Variante schreibt den Schlüssel direkt in die Konfigurationsdatei:

claude mcp add --transport http --scope user engram https://mcp.engram.page \
  --header "Authorization: Bearer engram_YOUR_KEY_HERE"

Das ist für --scope user in Ordnung (~/.claude.json bleibt auf deinem Rechner). Für --scope project ist es nicht in Ordnung, denn .mcp.json soll committet werden. Lade den Schlüssel stattdessen aus der Umgebung.

Den Schlüssel aus einer Umgebungsvariable laden

Claude Code ersetzt ${VAR} und ${VAR:-default}, wenn es die .mcp.json liest. Bei HTTP-Servern gilt die Ersetzung für die Felder url und headers, und genau dort steht ein API-Schlüssel. Committe Folgendes:

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer ${ENGRAM_API_KEY}"
      }
    }
  }
}

Nur der Variablenname steht im Repo. Jede Mitwirkende liefert ihren eigenen Schlüssel, und Engram ordnet jeden ihrem eigenen Konto zu, eine geteilte .mcp.json bedeutet also nie einen geteilten Vault.

Claude Code liest die Umgebung, mit der es gestartet wurde. Exportiere den Schlüssel also, bevor du claude startest:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Für einen Schlüssel pro Repo nutze direnv und halte den Wert in einer per gitignore ausgeschlossenen .envrc:

export ENGRAM_API_KEY="engram_YOUR_KEY_HERE"

Führe einmal direnv allow aus und starte claude dann aus diesem Verzeichnis.

Achtung

Ist die Variable nicht gesetzt, wird die Konfiguration trotzdem geladen, und Claude Code sendet den Literal-String Bearer ${ENGRAM_API_KEY}, den Engram mit 401 ablehnt. claude mcp list markiert das:

[Warning] [engram] mcpServers.engram: Missing environment variables: ENGRAM_API_KEY

Suche zuerst nach dieser Zeile, wenn sich ein Setup mit Schlüssel nicht verbindet.

Zwei Dinge ändern sich, sobald ein Schlüssel im Spiel ist. Beim ersten Verbinden öffnet sich kein Browser, und /mcp bietet kein Authenticate mehr an: Ein gesetzter Authorization-Header deaktiviert den OAuth-Fallback vollständig. Was ein Schlüssel abdeckt und wie du ihn rotierst, steht unter MCP-Konfiguration → API-Schlüssel-Authentifizierung.

Fehlerbehebung (Claude-Code-spezifisch)

• claude mcp list zeigt engram nicht. Der Befehl lief in einem anderen Scope als erwartet. Prüfe sowohl ~/.claude.json (Nutzer) als auch .mcp.json (Projekt) auf den Eintrag und führe dann claude mcp add mit dem richtigen --scope-Flag erneut aus.
• /mcp listet engram nicht in der Auswahl. Du hast die CLI nach claude mcp add nicht beendet und neu gestartet. Starte claude neu.
• Die Option Authenticate tut nichts, oder der Browser öffnet sich nie. Eine Headless- oder Remote-Sitzung kann keinen Browser öffnen. Führe Claude Code auf einem Rechner mit Desktop-Browser aus oder nutze stattdessen einen API-Schlüssel.

Clientübergreifende Fehler findest du unter Fehlerbehebung.

Widerruf

So trennst du Claude Code von Engram:

1. Suche in Claude Code den Eintrag des Connectors oder MCP-Servers und entferne ihn.
2. Öffne in Engram dein Konto → API Keys & Sessions und widerrufe die passende Sitzung.
3. Das OAuth-Token wird serverseitig ungültig. Claude Code muss sich neu authentifizieren, um sich wieder zu verbinden.

Du kannst die Registrierung auch lokal mit claude mcp remove engram entfernen. Das löscht den Konfigurationseintrag, lässt das serverseitige Token aber aktiv, bis du es in Engram widerrufst.

Nächste Schritte

MCPÜberblick über das Protokoll.

ScopesWas die Berechtigung umfasst.

Alle IntegrationenEinen anderen Client wählen.