# Ein Kontext. Mehrere Apps und Agenten.

Dein Wissen muss nicht umziehen, wenn eine weitere KI dazukommt. Entscheidend ist, **wem der Kontext gehört und mit welchen Rechten eine Verbindung arbeitet**.

## Was heute möglich ist

| Dein Vorhaben | Heutiger Weg |
|---|---|
| Weitere Apps sollen ausgewählten Kontext nutzen. | Wähle beim OAuth-Verbinden ein Agentenprofil oder ausdrücklich dein persönliches Konto. |
| Ein Agent soll unabhängig eigenen Kontext besitzen. | Nutze ein eigenes Konto und teile ausgewählte Inhalte über Buckets. |
| Ein unterstützter Client soll nur Kernkontext lesen. | Ein vertrauenswürdiger Controller kann einen zeitlich begrenzten Nur-Lesen-Zugang ausstellen. Das ist kein eigenständiges Agentenkonto und keine Auswahl einzelner privater Fakten. |

Du brauchst **nicht für jede App ein neues Konto**. Persönliches OAuth und verwaltete Agenten sind unterschiedliche Zugangsarten: Ein verwalteter Agent handelt unter seiner eigenen Identität.

[App verbinden](/docs/connect) · [Ohne lokalen Browser anmelden](/docs/headless) · [Kontext nur lesen](/docs/read-only)

## Eigene Zugänge pro Agent

Agenten findest du unter **Kontext → Agenten**. Hier legst du Profile an und verwaltest ihre Freigaben. **Apps & API-Keys** im Kontomenü unten in der Navigation zeigt die verbundenen Clients und ihre Zugänge.

Der eigene Workspace erhält den Agentennamen in Kebab-Case, etwa `agent-moss` oder `agent-research-bot`. Ist der Name bereits vergeben, folgt `-2`, `-3` usw. Bestehende automatisch erzeugte UUID-Namen erhalten ebenfalls einen lesbaren Namen; ihre bisherigen MCP-Adressen bleiben als Alias gültig. Inhalte und Berechtigungen bleiben beim selben Workspace.


Unter [Agenten](/account/agents) kannst du benannte Agenten unter deinem bestehenden Konto verwalten. Der Kontext bleibt in deiner Ablage; jeder Agent erhält eine eigene Identität und ausdrücklich vergebene Rechte.

| Du verwaltest | Dein Nutzen |
|---|---|
| Name und Identität | Du erkennst, welcher Agent eine Änderung ausgeführt hat. |
| Erlaubte Bereiche und Aktionen | Ein Agent arbeitet nur in seinem freigegebenen Umfang. |
| Laufzeit und einzelne Zugänge | Du kannst einen Zugang erneuern oder entziehen, ohne alle Agenten neu einzurichten. |
| Menschliche Freigaben | Die Arbeit eines Agenten wird nicht automatisch als deine persönliche Entscheidung dargestellt. |

Beispiel: Ein Recherche-Agent liest ein freigegebenes Wiki, ein Arbeits-Agent bearbeitet Aufgaben. Beide arbeiten unter deinem Konto, mit getrennten Rechten. Dafür wird weder dein Wissen kopiert noch ein zweites Besitzerkonto angelegt. Generative KI und Agenten laufen weiterhin außerhalb von meinKontext; nur die Suche nutzt derzeit als vorübergehenden Test ein kleines lokales Modell in meinKontext.

## Einrichten und freigeben

1. Öffne [Agenten](/account/agents) unter **Kontext**. Die Seite listet alle deine Agenten mit ihrem Stand (**Verbunden**, **Nicht verbunden**, **Widerrufen**). Lege über **Neuer Agent** zum Beispiel „Moss“ an; der neue Agent öffnet sich direkt.
2. Klicke **Freigabe hinzufügen**. Suche ein Wiki, einen Bucket, ein Objekt, einen optionalen Workspace oder Plugin-Inhalte wie Aufgaben. Inhalte kannst du gemeinsam zum Lesen freigeben. Bei Plugin-Inhalten wählst du den gewünschten Zugriff; die Zeile nennt das Plugin, zu dem sie gehören.
3. Nutze beim ersten Mal **Verbinden**. Übernimm den einmalig angezeigten Zugang in den Secret-Speicher deines MCP-Clients. Niemals im Chat oder in Kontext-Dokumenten speichern.

Alle Freigaben stehen danach unter **Freigaben** beim Agenten. Einen anderen Agenten öffnest du über seine Zeile in der Liste; seine Details erscheinen daneben, auf dem Handy anstelle der Liste, und **Zur Liste** führt zurück. Rechts an jeder Freigabe steht der aktuelle Zugriff. Bei Kerninhalten wählst du **Lesen**, **Lesen · Schreiben nach Freigabe** oder **Lesen und Schreiben**. Bei Plugin-Inhalten änderst du die Rolle über das Berechtigungsmenü. Die separate Aktion **Entfernen** entzieht die jeweilige Freigabe; die Liste hat keine aufklappbaren Ebenen. Eine Wiki-Freigabe umfasst das ganze Wiki, einschließlich späterer Artikel und Originaldateien. Jeder neu angelegte Agent erhält einen eigenen Workspace unter deinem Konto. Zusätzlich kannst du ganze oder ausgewählte Bereiche aus deiner Ablage freigeben.

Für eigene Aufgaben kannst du dem Agenten die Aufgaben eines Workspaces wie „Moss“ unter deinem Konto mit Schreibrecht freigeben. Für externe Aktionen wählst du zuerst die Integrationen und öffnest an der Verbindung **Bearbeiten** und legst pro Aktion fest: **Nicht erlaubt**, **Nach meiner Bestätigung** oder **Direkt erlaubt**. Integrationen benötigt dafür Version 0.0.2. Ohne Aktionsfreigabe darf der Agent die Verbindung nicht benutzen.

## Agent verbinden

1. Öffne unter [Agenten](/account/agents) deinen Agenten und klicke im Abschnitt **Verbindung** auf **Verbinden** (später **Verbindung verwalten**, auch im Menü „⋮“ des Agenten).
2. Wähle die Gültigkeit und klicke **Neuen Zugang ausstellen**. Übernimm den einmalig sichtbaren **MCP-Bearer** in den Secret-Speicher deines Clients.
3. Lege im Client eine MCP-Verbindung mit diesen Einstellungen an:

| Einstellung | Wert |
|---|---|
| Server-Adresse | `https://meinkontext.de/mcp` |
| Transport | Streamable HTTP |
| Authentifizierung | Bearer-Token: der soeben ausgestellte Agenten-Zugang |

Wenn der Client statt eines Token-Felds eigene HTTP-Header erwartet, verwende `Authorization: Bearer <Agenten-Zugang>`. Ersetze den Platzhalter durch den Zugang; füge bei einem eigenen Bearer-Token-Feld nur den Token ein. Speichere ihn weder im Chat noch im Repository. Die Server-Adresse oben gehört zu dieser Instanz: Preview-Zugänge funktionieren nur in der Preview.

4. Aktiviere die Verbindung beziehungsweise verbinde den Client neu. Der Zugang ordnet die Verbindung automatisch dem Agenten und seinen Freigaben zu; eine zusätzliche Agenten-ID oder Bucket-ID in der URL ist nicht nötig.
5. Öffne im Menü „⋮“ des Agenten **Zugriff prüfen** für diesen Zugang und teste im Client, ob die ausgewählten Inhalte erreichbar sind.

## Mit OAuth verbinden, etwa aus Luma

1. Lege den Agenten unter [Agenten](/account/agents) an und wähle seine Freigaben.
2. Starte in deiner App eine MCP-Verbindung zu `https://meinkontext.de/mcp` und melde dich bei meinKontext an.
3. Wähle unter **Profil und Bereich** den Agenten: **Gesamtes Profil** umfasst sein gesamtes Profil. Ein einzelner aufgeführter Workspace schränkt die Verbindung weiter ein.
4. Klicke **Erlauben**. Die App erhält einen eigenen Zugang für dieses Profil. Du musst keinen Token kopieren.
5. Prüfe im Client, ob freigegebene Inhalte erreichbar sind und private Inhalte außerhalb der Auswahl fehlen.

**Mein Konto · vollständiger persönlicher Zugriff** verbindet die App als dich. Wähle diese Option nur, wenn das beabsichtigt ist. Vorhandene persönliche Verbindungen werden nicht automatisch auf einen Agenten umgestellt: Trenne sie im Client und autorisiere sie erneut mit dem gewünschten Profil.

Die Auswahl gilt auch nach einer Token-Erneuerung. Zusätzliche Freigaben erfordern eine erneute Autorisierung; ein Widerruf wirkt auch auf noch gültige Tokens. Unter **Verbindung verwalten** kannst du den jeweiligen OAuth-Zugang widerrufen. Jeder Client erhält eine eigene Arbeitssitzung. OAuth-Agentenzugänge laufen nach 30 Tagen ab; danach neu verbinden. Eine Workspace-Auswahl gewährt niemals Zugriff außerhalb des Profils.

Die Einrichtung des MCP-Servers hängt vom Client ab; siehe [App verbinden](/docs/connect). Der Luma-Client muss den OAuth-Autorisierungsdialog öffnen. Die Profilwahl findet in meinKontext statt, nicht in einem zusätzlichen Luma-Einstellungsfeld.

**Unbegrenzt** stellt einen Bearer-Zugang ohne Ablaufdatum aus. Er bleibt widerrufbar und bekommt keine zusätzlichen Rechte. Standardmäßig sind 24 Stunden ausgewählt. Für bestehende Agenten ohne eigenen Bereich wähle **Eigenen Bereich einrichten** und stelle danach einen neuen Zugang aus.

Nach Ablauf stellst du hier einen neuen Zugang aus und ersetzt den Token im Client. Das gilt auch, wenn du zusätzliche Freigaben in den Zugang aufnehmen möchtest. Jeder gleichzeitig arbeitende Worker bekommt einen eigenen Zugang.

## Eigener Bereich und zusätzliche Freigaben

Der eigene Workspace ist die Ablage des Agenten, etwa für Anweisungen, Skills und Notizen, und er umfasst die Plugin-Inhalte, die darin liegen: Aufgaben oder ein Wiki in seinem Workspace kann der Agent ohne eigene Freigabe nutzen, mit Schreibrecht bei „Lesen und Schreiben", sonst lesend. Die Zeile „Eigener Bereich" nennt die Plugins, die er so erreicht. Er bleibt in deinem Besitz, auch wenn du den Agentenzugang widerrufst. Den Bereich eines aktiven Agenten kannst du nicht löschen; nach dem Widerruf entfernt das Löschen seines Workspace auch den widerrufenen Agenten. Neue Agenten erhalten diesen Bereich automatisch. Bestehende Zugänge werden dadurch nicht nachträglich erweitert; für die Plugin-Inhalte seines Bereichs braucht ein Agent einen Zugang, der nach dieser Änderung ausgestellt wurde.

Mit „Lesen und Schreiben" auf seinem eigenen Bereich kann ein Agent dort auch eigene Buckets anlegen (`create_agent_bucket`), Objekte aus seinem Bereich hineinlegen (`add_to_agent_bucket`) und sie auflisten (`list_agent_buckets`). Ein solcher Bucket gehört dir und liegt im Workspace des Agenten. Mitglieder fügst nur du hinzu; der Agent kann niemanden einladen und keinen Bucket außerhalb seines Bereichs erreichen.

Das **Profil** bestimmt, wer handelt und welche Freigaben gelten. Ein **Workspace** ist ein optionaler Ausschnitt daraus. Ein Agent sieht standardmäßig seinen eigenen Bereich und seine weiteren Freigaben gemeinsam. `?workspace=<Name>` kann die Verbindung auf einen vollständig freigegebenen Workspace einschränken. Ein unbekannter oder nicht freigegebener Workspace wird abgelehnt.

`?profile=service:<Agenten-ID>` kann zusätzlich prüfen, dass der Zugang zum gewünschten Agenten gehört. Der Parameter wechselt keine Identität und gewährt keine Rechte. Für den Verbindungsaufbau über OAuth bleibt die Auswahl im Autorisierungsdialog maßgeblich; URL-Parameter ersetzen diese Auswahl nicht.

## Schreibanfragen prüfen

Mit **Lesen · Schreiben nach Freigabe** bleibt Lesen möglich. Vor einer Änderung wartet der Agent auf deine Zustimmung für die betroffenen Dateien. Öffne beim Agenten **Änderung prüfen**. Der Dialog zeigt die bisherige Fassung und den Vorschlag.

Wähle die Dateien und die Gültigkeit:

- **Nur diese Änderung:** genehmigt genau den gespeicherten Vorschlag. Ein veränderter Vorschlag benötigt eine neue Anfrage.
- **Für diese Verbindung:** erlaubt weitere Änderungen an denselben Dateien über denselben Agentenzugang. Eine andere Verbindung benötigt eine eigene Zustimmung.
- **Bis zum Widerruf:** erlaubt weitere Änderungen an denselben Dateien auch über neue Zugänge desselben Agenten, solange seine Freigabe weiter gilt.

Für eine gemeinsame Auswahl kannst du Dateimuster verwenden: `notes/*.md` für Markdown-Dateien direkt in diesem Ordner, `notes/**` einschließlich Unterordnern. Der Dialog zeigt die tatsächlich ausgewählten Dateien. Später angelegte Dateien werden nicht automatisch mitgenehmigt.

Nach deiner Zustimmung wiederholt der Agent den ursprünglichen Auftrag. Wiederholungen derselben Anfrage schreiben nicht doppelt. Hat sich die veröffentlichte Fassung inzwischen geändert, muss der Agent sie neu lesen und einen aktuellen Vorschlag erstellen. **Ablehnen** verhindert die Ausführung dieses Vorschlags.

Ein Schreibrecht erlaubt keine Verwaltung von Zugängen und keine Selbstgenehmigung. Von einem Producer verwaltete Wiki-Artikel werden weiterhin über dessen Schreibweg aktualisiert. Plugin-Aktionen und externe Anbieteraktionen behalten ihre eigenen Berechtigungen und Freigaberegeln.

## Im Alltag

- **Freigabe hinzufügen** ergänzt die Liste. Die Suche durchsucht beim Tippen dein ganzes Konto: Inhalte und Plugin-Inhalte wie Aufgaben. Die Auswahl öffnet sich in einem eigenen Dialog.
- **Wartet auf dich** erscheint nur bei offenen Bestätigungsanfragen und führt zum ursprünglichen Auftrag.
- **Verbinden** erscheint, wenn noch kein gültiger Zugang alle gespeicherten Freigaben umfasst. Neue Rechte benötigen einen neuen Zugang; bestehende Zugänge werden nicht automatisch erweitert. Dasselbe gilt nach der Aktualisierung eines Plugins: Ein Zugang gilt für die Plugin-Version, mit der er ausgestellt wurde, und der Agent braucht danach einen neuen. Entzug gilt sofort für neue Zugriffe.

Was auf dich wartet, steht auch unter **Offene Vorgänge** auf der Übersicht und in `list_action_items`: jede Änderung, die ein Agent vorschlägt, und jeder Agent, dessen neue Freigaben erst nach dem Verbinden wirken. Ein Eintrag führt direkt zum Prüfdialog oder zu **Verbindung verwalten** und verschwindet, sobald du entschieden oder verbunden hast.

Im Dialog **Verbindung verwalten** findest du die Einrichtung und einzelne Zugänge. Das Menü „⋮“ des Agenten enthält außerdem **Zugriff prüfen** und, nach einer Rückfrage, **Agent widerrufen**. Bei **Zugriff prüfen** siehst du, was ein ausgewählter Zugang tatsächlich erreicht. Diese Momentaufnahme führt keine Anbieteraktion aus; jeder tatsächliche Zugriff prüft die Rechte erneut.

Ein manuell ausgestellter Zugang gilt wahlweise 24 Stunden, sieben oder 30 Tage oder unbegrenzt bis zum Widerruf. OAuth-Agentenzugänge gelten 30 Tage. Jeder gleichzeitig arbeitende Worker braucht einen eigenen Zugang; derselbe Zugang setzt dieselbe Arbeitssitzung fort. Bereits gelesene Kopien lassen sich nicht zurückrufen. Hält ein gestoppter Agent eine Aufgabenübernahme, kannst du als Eigentümer der Aufgaben **Übernahme zurücksetzen** mit Begründung verwenden.

## Was eine Freigabe umfasst

Du wählst Inhalte einzeln oder als Ganzes aus (ganzes Wiki, Bucket, Workspace). Nur ausdrücklich freigegebene Kerninhalte erscheinen in Auflistung, Suche und Dateiabrufen. Ein zusätzlich freigegebener Workspace ergänzt das Profil. Wählst du beim Verbinden gezielt einen einzelnen Workspace, begrenzt er diese Verbindung auf seine aktuellen Inhalte; normale persönliche Workspace-Verbindungen bleiben Katalogansichten.

Aufgaben, Kalender und Integrationen unterstützen die eigene Agentenidentität. Nachrichten und im Konfigurator erstellte Plugins bleiben gesperrt, bis ihr jeweiliger Identitätsvertrag diese Nutzung unterstützt. Installations- und Verwaltungsrechte sind keine Inhaltsrechte. Dein persönliches Gedächtnis bleibt privat, bis du einzelne Fakten ausdrücklich freigibst. Erhaltene Buckets kannst du hier nicht weiterfreigeben; du musst den ausgewählten Bucket selbst besitzen.

## Integrationen für einen Agenten freigeben

Für jede freigegebene Verbindung wählst du je Aktion:

- **Nicht erlaubt:** Der Agent kann die Aktion nicht ausführen.
- **Nach meiner Bestätigung:** Der Auftrag wartet, bis du den gespeicherten Inhalt im Browser prüfst. Das gilt auch für Leseaktionen, wenn du sie so einstellst.
- **Direkt erlaubt:** Der Agent darf diese Aktion ohne weitere Bestätigung ausführen, solange alle aktuellen Rechte und die ursprünglichen Grenzen seines Zugangs gelten. Das kann ausdrücklich auch eine Schreibaktion sein.

Die Prüfseite zeigt Verbindung, Aktion, vollständige Argumente, anfragenden Agenten und Arbeitssitzung. Du bestätigst den ursprünglichen Auftrag oder lehnst ihn ab. Ein abgelehnter Auftrag wird auch bei Wiederholung nicht ausgeführt; der Agent kann die Bestätigung nicht selbst erteilen. Die Prüfung verfällt nach 15 Minuten, spätestens aber mit dem Zugang oder seinen Rechten. Änderungen an der Verbindung, Werkzeugdefinition oder Berechtigung können einen neuen Auftrag erforderlich machen. Wiederholtes Bestätigen desselben Auftrags löst ihn nicht erneut aus. Bei unklarem Ausgang zuerst beim Anbieter prüfen.

Zugangsdaten des Anbieters bleiben beim geschützten Executor. Ein Agent benötigt keinen Zugriff auf deine Secrets, um eine von dir eingerichtete Verbindung zu nutzen.

## Das Gedächtnis deines Agenten

Jeder Agent speichert seine eigenen Gedanken und Fakten in seinem eigenen Workspace unter deinem Konto. Gleichnamige Fakten in deinem persönlichen Gedächtnis oder in einem anderen Agenten-Workspace bleiben getrennt.

Seine Definition erhält der Agent beim Verbinden. Die Anweisungen, die er dabei bekommt, nennen die Anweisungen, Skills und anderen Objekte, die du mit ihm geteilt hast, und sein MCP-Client listet die geteilten Skills über die standardisierte Skills-Schnittstelle (`skills/list`, `skills/get`, `skill://`). Er braucht also keinen meinKontext-eigenen Aufruf, um sie zu laden. Was außerhalb seines Zugriffs liegt, erscheint dort nicht.

Unter **Gedächtnis** öffnest du neben dem Seitentitel die Workspace-Auswahl. Suche den Agenten nach Namen und wähle seinen Bereich. **Alle Workspaces** zeigt wieder die Fakten aller Workspaces. Dort kannst du seine Fakten suchen, die Faktenkarte und den Verlauf ansehen sowie Fakten vergessen oder endgültig löschen. Dein Kontoexport enthält die Workspace-Gedächtnisse getrennt.

Über **Agenten → Freigabe hinzufügen** kannst du einzelne Fakten oder einen ganzen weiteren Workspace freigeben. Eine Workspace-Freigabe umfasst auch später darin gespeicherte Fakten. Eine einzelne Faktfreigabe folgt dessen Überarbeitungen; nach Vergessen und neuem Anlegen entsteht ein neuer Fakt ohne die alte Freigabe. Nicht freigegebene Herkunftsknoten und Verknüpfungen bleiben für den Agenten verborgen.

Auch Fakten unterstützen **Lesen · Schreiben nach Freigabe**: Prüfe den bisherigen Inhalt und den Vorschlag und erlaube die einzelne Änderung, weitere Änderungen an genau diesem Fakt für diese Verbindung oder bis zum Widerruf. Die Genehmigung eines Fakts erlaubt keine Änderungen an anderen Fakten im selben Workspace.

Verbinde den Agenten nach dem Hinzufügen neuer Freigaben erneut. Ältere Zugänge erhalten nicht automatisch Gedächtnisrechte. In der verbundenen App kann der Agent mit `recall` lesen und mit `remember` oder `forget` Änderungen anfragen. Neue eigene Fakten landen standardmäßig in seinem Workspace. Bei einer wartenden Anfrage muss er nach deiner Zustimmung denselben Auftrag wiederholen.

## Moss unter deinem Konto

Moss erhält einen eigenen Workspace unter deinem Konto. Eigene Dateien und zusätzliche Freigaben bilden gemeinsam sein Profil; eigene Aufgaben kannst du ergänzend freigeben. Ein neuer Agentenzugang verschiebt jedoch keine Daten aus Moss’ bisherigem Konto. Bestehende Aufgaben, historische Namen und die bisherigen Clients müssen gesondert zugeordnet und vor einem Cutover geprüft werden. Das alte Konto erst nach verifizierter Übernahme stilllegen.

## Bleibt ein eigenes Agentenkonto sinnvoll?

Ja, wenn der Agent seinen Kontext unabhängig besitzen soll. Er kann freigegebene Skills, ganze Wikis und Plugin-Inhalte wie Aufgaben nutzen und daneben private Inhalte pflegen. Wird eine Freigabe entzogen, bleiben seine eigenen Inhalte erhalten. Bestehende Agent-Konten werden durch dieses Konzept nicht automatisch zusammengelegt.

[Eigenen Kontext und Freigaben einrichten](/docs/sharing)

## Kann ein Agent in meinem Namen entscheiden?

Ein verwalteter Agenten-Zugang identifiziert den Agenten selbst. Ein Schreibrecht ist keine Bestätigung, dass du etwas persönlich freigegeben hast. Eine eng begrenzte Vertretung mit nachgewiesener Vollmacht wäre ein eigener späterer Schritt. Dafür braucht es einen ausdrücklich menschlich bedienten Freigabeweg. Wichtig für bestehende Verbindungen: Eine KI mit deinem persönlichen OAuth handelt heute als du; diese Anmeldung allein beweist keine menschliche Prüfung.

## Wie wird das geprüft?

Die Abnahme prüft über echte MCP-Verbindungen: getrennte Rechte, sofort wirksamen Entzug für neue Zugriffe, korrekte Urheber, Schutz vor gefälschten menschlichen Freigaben und dieselben Regeln bei Suche, Export und wiederholten Aufrufen. Bereits gelesene Kopien lassen sich nicht zurückrufen.

Die eigene Testsuite „Agenten-Zugänge und Urheberschaft“ prüft zusätzlich Agenten-Befunde, menschliche Entscheidungen, getrennte Arbeitssitzungen und entzogene Schreibrechte. Langfuse zeigt Modellläufe und deren einzelne Prüfungen. Die technischen Berechtigungsregeln werden unabhängig davon getestet; fehlende oder abgebrochene Modellläufe gelten nicht als bestanden.

[SDK-Vertrag und Abnahme](/docs/sdk/agent-access) · [Bestehende Testverfahren](/docs/sdk/testing)

## Definitionen im bestehenden Home schützen

Eine vorhandene Objektfreigabe mit **Lesen · Schreiben nach Freigabe** begrenzt
auch einen direkten Schreibzugriff über Home oder Bucket. **Lesen** auf der
Objektfreigabe verbietet das Schreiben auf dieses Objekt. Andere Arbeitsdateien
im selben Home behalten ihre eigene Regel. Eine Beschränkung im ausgestellten
Zugang bleibt dessen Obergrenze; spätere Freigaben erweitern ihn nicht.

Der Agent verwendet `write_agent_files` mit der aktuellen Revision. Bei `pending`
prüfst du den vorhandenen Dateivorschlag. Nach deiner Zustimmung wiederholt der
Agent denselben Aufruf mit derselben `operationId`; erst dieser Abschluss
veröffentlicht die Änderung. Ein zwischenzeitlicher Rechteentzug wird erneut
geprüft. Die Zustimmung allein veröffentlicht noch nicht.

## Versionsänderungen abfragen

`list_workspace_objects` liefert einem Agenten die autorisierten Stable-Versionen
eines vollständig freigegebenen eigenen Workspaces. `workspace` akzeptiert ID
oder Namen, `kind` begrenzt die Objektart. Die Antwort enthält `kind`, `slug`,
`seq`, `version_id`, `publisher` und einen `etag`, ohne Dateiinhalte.

Mit `if_none_match` aus der vorherigen Antwort erhält der Agent bei gleichem
Stand `unchanged: true`. Auch dann werden die aktuellen Rechte geprüft.
Plugin-Records und abweichend gepinnte Versionen gehören nicht zu dieser Liste.
`publisher` bezeichnet den belegbaren veröffentlichenden Akteur, keine menschliche
Freigabe. Fehlt das Publikationsereignis im aufbewahrten Audit, ist der Wert `null`.

## Agenten per MCP verwalten

Deine persönliche MCP-Verbindung erreicht dieselben Schritte wie die Seite [Agenten](/account/agents) über diese Werkzeuge:

| Auf der Seite | MCP-Werkzeug |
|---|---|
| Agentenliste mit Stand und Zugängen | `agent_access_list` listet deine Agenten, nicht geheime Zugangsreferenzen und die Plugin-Inhalte mit den Rollen, die du vergeben kannst. |
| **Neuer Agent** | `agent_access_create` mit `name` legt den Agenten samt eigenem Workspace an, den der Agent lesen und beschreiben darf. Es gibt keine weiteren deiner Inhalte frei und stellt keinen Zugang aus. |
| Zugriff auf Plugin-Inhalte, **Entfernen** | `agent_access_grant` mit `agent_id`, `collection_id` und einer `role_id` aus `agent_access_list`; `role_id: null` entfernt die Freigabe. |
| **Zugriff prüfen** | `agent_access_list` mit `agent_id` und `credential_id` liefert die Live-Vorschau dieses Zugangs. Beide Angaben sind gemeinsam erforderlich; der Aufruf verändert nichts. |
| Vorschau vor einer Änderung | `access_preview` spielt eine Freigabeänderung für einen deiner Agenten probeweise durch und zeigt, was er gewinnen oder verlieren würde. |
| **Agent widerrufen**, einzelnen Zugang widerrufen | `agent_access_revoke` mit genau einer Angabe, `agent_id` oder `credential_id`. |

Zwei Schritte bleiben außerhalb von MCP. **Verbinden** stellt einen Zugang aus: über die Schaltfläche auf der Seite oder durch einen vertrauenswürdigen Controller, der an `/mcp/agent-credentials` sendet ([SDK-Vertrag](/docs/sdk/agent-access)); kein Werkzeugergebnis enthält je einen Zugang. Wikis, Buckets, Objekte, Workspaces und Fakten gibst du auf der Seite über **Freigabe hinzufügen** frei. MCP erweitert nie, was ein bestehender Zugang erreicht: Was `agent_access_grant` über die ursprüngliche Obergrenze eines Zugangs hinaus hinzufügt, wirkt erst mit einem danach außerhalb von MCP ausgestellten Zugang. Entfernst oder senkst du eine Rolle, gilt das sofort auch für bestehende Zugänge.

Diese Werkzeuge antworten nur auf deiner persönlichen Verbindung. Agenten-, API-Key- und Ausführungsverbindungen sehen sie nicht und können sie nicht aufrufen.
