meinKontextDocs
Navigation & Suche

Erste Schritte

Kontext nur lesen

Quellen prüfen, ohne Schreibrechte an den Agenten weiterzugeben.

Ein Artikel kann neben Fakten auch manipulierte Anweisungen enthalten. Wenn ein Agent nur recherchieren soll, kann seine MCP-Verbindung auf das Lesen von Kernkontext begrenzt werden. Der Server blockiert Änderungen, Freigaben und die Ausstellung weiterer Zugänge.

Was bleibt möglich?

Skills, Kontext-Objekte, Wiki-Artikel und Erinnerungen lesen und suchen; freigegebene Inhalte unter deinen aktuellen Rechten nutzen. Neue Artikel eines geteilten Wikis bleiben erreichbar. Entzogene Freigaben werden bei folgenden Anfragen berücksichtigt.

Schreiben, Löschen, Teilen, Kontoverwaltung und Domain-Plugins stehen in diesem Modus nicht zur Verfügung. Ein Workspace wählt Inhalte aus; er ersetzt keine Sicherheitsgrenze. Auch ein Org-API-Key ist kein garantierter Nur-Lesen-Zugang.

Einrichtung für Client-Entwickler

  1. Der vertrauenswürdige Client meldet sich persönlich per OAuth an.
  2. Er ruft außerhalb der Modell-Werkzeuge POST /mcp/context-read-grants auf. Die bestehende OAuth-Anmeldung gehört nur in den Authorization-Header. Der JSON-Body ist beispielsweise {"expiresIn":900}.
  3. Die Antwort enthält einmalig credential und id. Nur dieser eingeschränkte Zugang wird als Bearer der Agent-MCP-Verbindung zu https://meinkontext.de/mcp verwendet. Keine Credentials in Prompts, Tool-Antworten oder Logs ausgeben.
  4. Nach dem Lauf widerruft der Client mit seiner ursprünglichen OAuth-Anmeldung über DELETE /mcp/execution-grants/{id}. Immer auch bei Abbruch aufräumen.

Die Laufzeit beträgt 60 bis 3.600 Sekunden, standardmäßig 900. Der Zugang kann sich nicht selbst verlängern oder erweitern. Bei Ablauf meldet der Client einen fehlgeschlagenen Zugriff; er darf nicht still auf Vollzugriff zurückfallen.

Unterstützt meine App das automatisch?

Eine gewöhnliche OAuth-Verbindung wird dadurch nicht automatisch eingeschränkt. Der Client muss diese getrennte Rechtevergabe unterstützen. Es gibt keinen URL-Schalter und keinen universellen Menüpunkt in Codex, Claude oder Hermes dafür. Der serverseitige Modus benötigt keinen lokalen Zusatzdienst; er liefert Kontext weiterhin über MCP.

Die volle OAuth-Anmeldung darf dem Modell weder als zweite Verbindung noch über Terminal-Werkzeuge zugänglich sein. Nur-Lesen verhindert Änderungen über diese Verbindung, aber keine falschen Antworten oder Offenlegung bereits lesbarer Inhalte durch andere Client-Werkzeuge.