MCP-Konfiguration

Die meisten brauchen diese Seite nicht. Jeder moderne KI-Client (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) bringt eine Oberfläche mit, über die sich Engram in wenigen Klicks hinzufügen lässt. Die Anleitung pro Client findest du unter KI-Integrationen.

Wenn du lieber eine Konfigurationsdatei bearbeitest (oder dein Client keine Oberfläche hat), gibt es drei Wege, der einfachste zuerst: Übergib die Einrichtung deiner KI, arbeite die Tabs pro Client durch oder verzichte ganz auf OAuth und nutze einen API-Schlüssel.

Lass deine KI das einrichten

Der schnellste Weg: Füge den folgenden Prompt in deinen KI-Assistenten ein. Er erkennt, in welchem Client er läuft, bearbeitet die richtige Konfigurationsdatei (oder führt den richtigen CLI-Befehl aus) und sagt dir, was als Nächstes zu tun ist.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

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.

Reference: https://engram.page/docs/mcp/manual-config/

Falls etwas schiefgeht (oder du es lieber selbst machst), enthalten die Tabs pro Client unten die komplette manuelle Anleitung.

Der MCP-Endpunkt von Engram

https://mcp.engram.page

Engram spricht MCP über HTTPS. Es gibt zwei Arten der Authentifizierung:

• OAuth (Standard). Wenn sich dein Client zum ersten Mal mit der obigen URL verbindet, öffnet sich ein Browserfenster zur Anmeldung. Danach hält der Client ein Token und verbindet sich unbemerkt neu. Keine Schlüssel zum Kopieren.
• API-Schlüssel für Headless-, Skript- oder Shared-Vault-Setups. Sende den Schlüssel als Bearer-Token in einem Authorization-Header. Siehe API-Schlüssel-Authentifizierung weiter unten.

In beiden Fällen brauchst du weder Umgebungsvariablen noch einen lokalen Serverprozess.

Deinen Client konfigurieren

Wähle unten deinen Client. Jeder Tab ist eine vollständige Anleitung: Konfiguration, Neuladen, Authentifizierung beim ersten Start und wo du der KI beibringst, Engram tatsächlich zu nutzen.

Beim Self-Hosting ersetzt du in allen Snippets unten die Cloud-URL durch die /api/mcp-URL deines eigenen Backends. Die maßgeblichen Platzhalter stehen im Abschnitt Endpunkt oben.

Claude Code

1. Engram hinzufügen. Nutze die Claude-Code-CLI, die die Konfigurationsänderung für dich übernimmt:

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

Mit --scope user steht Engram in jedem Projekt zur Verfügung. Lass es weg (oder nimm --scope project), um Engram auf die .mcp.json des aktuellen Projekts zu beschränken.

Lieber manuell? Füge Folgendes 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.

3. Authentifizierung beim ersten Start. Claude Code fragt nicht von selbst nach. Führe in der neuen Sitzung /mcp aus, wähle engram (es zeigt △ needs authentication) und dann Authenticate. Dein Browser öffnet OAuth. Melde dich bei Engram an, bestätige die Verbindung, und Claude Code speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. Claude beibringen, es zu nutzen. Hänge das folgende Snippet an ~/.claude/CLAUDE.md an, deine Anweisungsdatei auf Nutzerebene, die für jedes Projekt gilt.

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.

Cursor

1. Konfiguration bearbeiten. Füge Engram zu ~/.cursor/mcp.json (nutzerweit) oder .cursor/mcp.json im Projektstamm (projektbezogen) hinzu:

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

2. Neu laden. Beende Cursor vollständig (Cmd+Q / File → Exit) und öffne es neu. Ein Neuladen des Fensters reicht nicht; MCP-Server werden beim App-Start registriert.

3. Authentifizierung beim ersten Start.

Wenn Cursor Engram zum ersten Mal aufruft, öffnet sich dein Browser für OAuth. Melde dich bei Engram an, bestätige die Verbindung, fertig. Cursor speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. Cursor beibringen, es zu nutzen. Füge das folgende Snippet zu deinen Cursor Rules hinzu: ~/.cursor/rules (nutzerweit) oder .cursor/rules in einem Projekt.

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.

VS Code

1. Konfiguration bearbeiten. Füge Engram zu .vscode/mcp.json in deinem Workspace hinzu. VS Code nutzt servers statt mcpServers und verlangt "type": "http":

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Neu laden. Führe in der Befehlspalette Developer: Reload Window aus (Cmd+Shift+P / Ctrl+Shift+P). Ein vollständiger Neustart von VS Code ist nicht nötig.

3. Authentifizierung beim ersten Start.

Wenn Copilot Chat (or your MCP-aware extension) Engram zum ersten Mal aufruft, öffnet sich dein Browser für OAuth. Melde dich bei Engram an, bestätige die Verbindung, fertig. Copilot Chat (or your MCP-aware extension) speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. VS Code beibringen, es zu nutzen. Füge das folgende Snippet zu den Custom Instructions deines Workspace hinzu (Copilot Chat → Einstellungen → Custom Instructions, oder das Pendant deiner Erweiterung).

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.

Windsurf

1. Konfiguration bearbeiten. Füge Engram zu ~/.codeium/windsurf/mcp_config.json hinzu:

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

2. Neu laden. Beende Windsurf vollständig und öffne es neu. Ein Neuladen des Fensters löst die Registrierung des MCP-Servers womöglich nicht aus.

3. Authentifizierung beim ersten Start.

Wenn Windsurf Engram zum ersten Mal aufruft, öffnet sich dein Browser für OAuth. Melde dich bei Engram an, bestätige die Verbindung, fertig. Windsurf speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. Windsurf beibringen, es zu nutzen. Füge das folgende Snippet in den AI-Rules-Bereich von Windsurf (Workspace → AI Rules) oder für nutzerweite Regeln in ~/.codeium/windsurf/global_rules.md ein.

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.

Zed

1. Konfiguration bearbeiten. Öffne ~/.config/zed/settings.json und füge Engram unter context_servers hinzu (der Wrapper-Schlüssel von Zed, nicht das übliche mcpServers):

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

2. Neu laden. Führe in der Befehlspalette zed: reload settings aus (Cmd+Shift+P). In hartnäckigen Fällen beende Zed vollständig und öffne es neu.

3. Authentifizierung beim ersten Start.

Wenn Zed's assistant Engram zum ersten Mal aufruft, öffnet sich dein Browser für OAuth. Melde dich bei Engram an, bestätige die Verbindung, fertig. Zed's assistant speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. Zed beibringen, es zu nutzen. Füge das folgende Snippet zum Standard-Prompt deines Assistenten in settings.json hinzu (unter assistant.default_prompt) oder über die Assistenten-Einstellungen.

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.

Other / Custom

1. Konfiguration bearbeiten. Die meisten MCP-Clients akzeptieren den üblichen mcpServers-Wrapper:

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

Erkennt dein Client diese Form nicht, sieh in seiner Dokumentation nach dem erwarteten Wrapper-Schlüssel (VS Code nutzt servers, Zed nutzt context_servers).

2. Neu laden. Die meisten Clients brauchen einen vollständigen Neustart, nicht nur ein Neuladen des Fensters, damit neue MCP-Server registriert werden.

3. Authentifizierung beim ersten Start.

Wenn the client Engram zum ersten Mal aufruft, öffnet sich dein Browser für OAuth. Melde dich bei Engram an, bestätige die Verbindung, fertig. the client speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist derzeit der volle Scope mcp; granulare Scopes pro Aktion stehen auf der Roadmap.

4. Deiner KI beibringen, es zu nutzen. Lege das folgende Snippet dort ab, wo dein Client dauerhafte System- oder globale Anweisungen entgegennimmt.

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.

API-Schlüssel-Authentifizierung

OAuth ist der Standard. Nutze einen API-Schlüssel für Headless- oder Skript-Zugriff, Kontrolle pro Verbindung (Bot mit Schreibrecht vs. Agent nur mit Leserecht) oder um einen Vault zu teilen, ohne die volle Anmeldung zu gewähren. Ein Schlüssel authentifiziert sowohl MCP als auch die REST-API. Derzeit trägt jeder Schlüssel den vollen Zugriff deines Kontos; feinere Scopes pro Schlüssel stehen auf der Roadmap.

Schlüssel erstellen

Erstelle einen unter app.engram.page/settings/api-keys. Engram zeigt den vollständigen Schlüssel nur einmal bei der Erstellung, danach nur noch sein Präfix. Behandle ihn wie ein Passwort und bewahre ihn sicher auf.

In deine Konfiguration einfügen

Füge einen headers-Block hinzu, der den Schlüssel als Bearer-Token sendet. Der Wrapper-Schlüssel (mcpServers / servers / context_servers) richtet sich nach dem Client, den du gerade konfigurierst. Nutze also dieselbe Form wie in deinem Tab oben. Für die üblichen mcpServers-Clients:

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

Mit einem API-Schlüssel öffnet sich beim ersten Verbinden kein Browser; der Schlüssel authentifiziert sofort. Zum Rotieren erstellst du in den Einstellungen einen neuen Schlüssel und ersetzt den Wert in deiner Konfiguration.

Achtung

Behandle den Schlüssel wie ein Passwort. Committe ihn nicht in die Versionsverwaltung; halte API-Schlüssel aus mcp.json-Dateien heraus, die eingecheckt werden. Nutze entweder Umgebungsvariablen-Ersetzung, wo dein Client sie unterstützt, oder lege die Konfiguration in eine Datei auf Nutzerebene (nicht auf Projektebene).

Fehlerbehebung

• Der Client sieht Engram nach der Änderung nicht. Starte den Client vollständig neu, nicht nur das Fenster.
• Der Browser öffnet sich nicht zur Authentifizierung. Stelle sicher, dass kein Popup-Blocker im Weg ist; manche Clients leiten das OAuth-Fenster durch eigene Browser-Logik, die bei Blockade stillschweigend fehlschlägt.
• Failed to connect. Prüfe, ob die URL erreichbar ist. Clientübergreifende Probleme findest du unter Fehlerbehebung.

Für die Abläufe über die Oberfläche des jeweiligen Clients siehe KI-Integrationen.