Scopes

Wenn du Engram als MCP-Connector hinzufügst, erhält der Client ein OAuth-Zugriffstoken. Das Token trägt einen Scope, der bestimmt, was der Client in deinem Vault tun darf.

Was das Token aktuell erlaubt

Der MCP-Endpunkt von Engram bietet derzeit einen einzigen, monolithischen Scope: mcp.

Ein Token mit dem Umfang mcp gewährt der Anwendung Zugriff auf alle MCP-Funktionen: Lesen von Notizen, semantische Suche, Schreiben von Notizen, Bearbeiten von Ordnern, Anhängen. Es gibt keine Berechtigungen pro Aktion, sondern ist auf die Vaults beschränkt, die du bei der Verbindung im Einwilligungsbildschirm auswählst. Du kannst bestimmte Vaults auswählen oder alle Vaults (einschließlich Vaults, die du später erstellst).

Granulare Scopes sind geplant

Den Scope mcp in Scopes pro Aktion aufzuteilen (notes:read, notes:search, notes:write, notes:delete, folders:write, metadata:read), steht auf der Roadmap. Sobald das da ist, kannst du im Connector-Ablauf nur die Mindestberechtigungen erteilen, die ein Agent braucht („lesen und suchen, aber nie schreiben”), statt wie heute alles oder nichts.

Wenn dir granulare Berechtigungen jetzt schon wichtig sind, hilft nur: Verbinde keine Agenten, denen du nicht zutraust, deinen Vault zu beschreiben. Eine Möglichkeit, die Berechtigung nach der Ausstellung im Protokoll einzuschränken, gibt es derzeit nicht.

Zugriff prüfen und widerrufen

Einstellungen → Verbindungen in der Engram-App listet alle aktiven OAuth-Verbindungen und API-Schlüssel auf. Klicke Widerrufen, um einen zu entfernen:

• Ein widerrufener API-Schlüssel funktioniert sofort nicht mehr.
• Eine widerrufene OAuth-Verbindung kann ihren Zugriff nicht mehr erneuern, und ihr aktueller Zugriffstoken verfällt innerhalb von 15 Minuten.

Scope-Grammatik (für SDK-Entwickler)

Der Endpunkt gibt seine unterstützten Scopes über /.well-known/oauth-authorization-server bekannt. SDK-Entwickler sollten diese Metadaten lesen, statt Scope-Strings fest einzucodieren, denn die granulare Aufteilung taucht dort zuerst auf.