Cursor

Cursor unterstützt MCP erstklassig. Lege eine mcp.json ab, starte Cursor neu, und OAuth läuft in deinem Browser, sobald der Agent zum ersten Mal zu Engram greift. 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. mcp.json bearbeiten. Erstelle oder bearbeite ~/.cursor/mcp.json (nutzerweit) oder .cursor/mcp.json im Projektstamm (projektbezogen, hat bei gleichem Servernamen Vorrang vor der globalen Datei):

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

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

3. Prüfen. Öffne Settings → Tools & MCP und bestätige, dass engram in der Serverliste steht.

Authentifizierung beim ersten Start

Cursor fragt beim Verbinden nicht nach OAuth. Es startet beim ersten Tool-Aufruf. Öffne einen neuen Chat und bitte den Agenten, dein Engram zu durchsuchen. Dein Browser öffnet sich, du meldest dich bei Engram an und bestätigst die Verbindung. Cursor speichert das Token und verwendet es ab dann weiter. Die Berechtigung ist der volle Scope mcp. Granulare Scopes pro Aktion stehen auf der Roadmap.

Um OAuth zu überspringen (für Headless- oder Shared-Vault-Setups), tausche den Block gegen einen API-Schlüssel aus:

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

Einen Schlüssel bekommst du unter app.engram.page/settings/api-keys.

Cursor beibringen, es zu nutzen

Füge das folgende Snippet zu deinen Cursor Rules hinzu: ~/.cursor/rules (nutzerweit) oder eine Datei .cursor/rules/*.mdc 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.

Ausprobieren

Sobald du verbunden bist, frage den Agenten von Cursor:

• 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.

Cursor 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.

Fehlerbehebung (Cursor-spezifisch)

• Zwei engram-Einträge unter Tools & MCP. Der Server ist sowohl in ~/.cursor/mcp.json als auch in .cursor/mcp.json definiert. Entferne einen (die projektbezogene Datei hat Vorrang).
• Der Server erscheint in den Einstellungen, aber der Agent ruft ihn nie auf. Bekanntes Problem bei der Injektion der globalen Konfiguration in manchen Cursor-Builds. Abhilfe: Verschiebe die Konfiguration in die projektbezogene .cursor/mcp.json.
• OAuth fragt nie nach. Der Agent hat noch kein Tool aufgerufen. Erzwinge es: Bitte den Agenten, das Engram-Tool search beim Namen aufzurufen. Bleibt es still, starte Cursor neu; veralteter Verbindungszustand kann den ersten Aufruf blockieren.

Clientübergreifende Fehler findest du unter Fehlerbehebung.

Widerruf

So trennst du Cursor von Engram:

1. Suche in Cursor 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. Cursor muss sich neu authentifizieren, um sich wieder zu verbinden.

Um es clientseitig zu entfernen, lösche den Block engram aus deiner mcp.json und starte Cursor neu.

Nächste Schritte

MCPÜberblick über das Protokoll.

ScopesWas die Berechtigung umfasst.

Alle IntegrationenEinen anderen Client wählen.