# Nachrichten: Fragen, Antworten und klare Entscheidungen

Messages ist ein eigenständig aktivierbares Plugin. Es speichert Kommunikation für
Menschen und externe Agenten. meinKontext erzeugt keine Antworten und startet keine Agenten.

## Workspaces im Browser

Im Seitenkopf wählst du einen deiner persönlichen **Workspaces**. **Alle Inhalte** zeigt alle Inhalte, auf die du zugreifen darfst, auch ohne Workspace-Zuordnung. Ein leerer Workspace bleibt leer. Verwalte die Zuordnung unter [Workspaces](/account/workspaces). Die Auswahl gilt auch beim Navigieren, Suchen und Exportieren innerhalb des Plugins. Speichere offene Änderungen vor einem Workspace-Wechsel; der Wechsel schließt bisherige Editoren.

Ein Workspace sagt, wo Inhalte liegen und wo ein Agent arbeitet; ein Bucket sagt, wer sonst noch darauf zugreifen darf. Die Workspace-Auswahl im Browser ist keine Freigabe: sie erweitert weder Zugriffsrechte noch MCP-Zugänge. [Mehr zu Workspaces](/docs/context).

## Mit einem bekannten Kontakt starten

1. **Nachrichten** unter **Plugins verwalten** aktivieren. Per MCP geht das mit
   `plugin_configure({"plugin_id":"meinkontext.messages","enabled":true})`.
2. Einen Bucket mit den bestehenden Konten deiner Kontakte teilen.
3. Unter **Nachrichten → Kanäle** die Teilnehmer auswählen. Der Kreis bleibt fest:
   Spätere Bucket-Mitglieder erhalten keinen Zugriff auf diesen Kanal.
4. Der Kontakt aktiviert Nachrichten auch in seinem Konto und öffnet
   **Mit dir geteilte Kanäle**. Dort den geteilten Kanal auswählen.
5. Die übrigen Teilnehmer wählen **Diesem Kanal zustimmen** mit ihrem eigenen Konto.
   Der Ersteller stimmt bereits beim Anlegen zu. Erst wenn alle zugestimmt haben,
   ist der Kanal aktiv.

Freigabe und Zustimmung sind getrennt. Die Teilnehmerliste allein vergibt keine Rechte.
Entfernte Mitgliedschaften oder Rollen sperren spätere Lesezugriffe, Änderungen und
Wiederholungen. Ein pausierter oder widerrufener Kanal nimmt keine Kommunikation mehr
an; aktuell berechtigte Personen können die bestehende Historie weiterhin lesen und
exportieren. Bereits heruntergeladene Kopien können nicht zurückgerufen werden.
Ein widerrufener Kanal lässt sich nicht reaktivieren.

## Eingang und geteilte Kanäle finden

| Ansicht | Was du dort findest |
|---|---|
| Eingang | Fragen, bei denen du als antwortende Person ausgewählt bist |
| Ausgang | Fragen, die du gestellt hast |
| Kanäle | Teilnehmer, Zustimmungen und Kanalzustand |
| Entwürfe | Deine privaten Texte; im Browser zum Lesen und Übernehmen, per MCP auch bearbeitbar |
| Auswertung | Gespeicherte Bearbeitungsstände der aktuell zugänglichen Anfragen |

Die Browseransicht zeigt jeweils die Bereiche einer Eigentümerorganisation.
**Mit dir geteilte Kanäle** wechselt zum Bereich des Kontakts. Dort bleiben auch
Eingang, Ausgang und die Auswahl **Bereich** auf diesen Eigentümer bezogen.
**Alle zugänglichen Bereiche** meint die Bereiche dieses Eigentümers, keinen
kontenübergreifenden Gesamteingang. Der MCP-Aufruf `messages_inbox` bündelt dagegen
neue technische Hinweise über die zugänglichen Eigentümer hinweg.

## Eine Frage stellen

**Neue Frage** wählen, Kanal und Thema festlegen und angeben, wer antworten soll und
was geklärt werden muss. **Nachricht prüfen** zeigt den genauen Text, die Empfänger
und die strukturierten Angaben. Erst **Freigeben & senden** speichert die Nachricht
für die Empfänger. Ein Entwurf bleibt ausschließlich für seinen Autor sichtbar.

**Alle Kanalmitglieder können die freigegebene Frage lesen.** Die Auswahl
**Wer soll antworten?** bestimmt die vorgesehenen Antwortenden, nicht einen kleineren
Leserkreis. Für einen anderen Empfängerkreis einen neuen Kanal anlegen.

| Zustand | Bedeutung |
|---|---|
| Gespeichert | Berechtigte Empfänger können die Nachricht abrufen |
| Lesebestätigung | Diese Person hat das Lesen ausdrücklich bestätigt |
| Beantwortet | Ein vorgesehener Empfänger hat eine freigegebene Antwort gesendet |
| Geklärt | Der Fragesteller hat die Anfrage ausdrücklich abgeschlossen |
| Abgelaufen | Die Frist ist vorbei; dafür ist kein Hintergrundjob nötig |

Der Empfänger öffnet die Frage, bestätigt das Lesen bei Bedarf ausdrücklich und
prüft seine Antwort vor dem Versand. Nur der Fragesteller schließt die Anfrage als
geklärt ab. Eine Antwort alleine schließt sie nicht.

Das Öffnen eines Gesprächs bestätigt noch nicht das Lesen. Lesen bedeutet keine
Zustimmung. Ein „Ja“ übernimmt keine Aufgabe und bucht keinen Termin. Dafür bleiben
Tasks und Calendar zuständig. Die Auswertung zählt gespeicherte Bearbeitungsstände
zugänglicher Anfragen; abgelaufene Fristen werden zusätzlich im Gespräch angezeigt.

## Nutzung durch Agenten über MCP

Zuerst `plugin_context` für `meinkontext.messages` laden. Nach der Aktivierung müssen
Clients mit gecachter Werkzeugliste gegebenenfalls neu verbunden werden.

- `messages_inbox`: neue Hinweise aus eigenen und geteilten Kanälen gemeinsam abrufen.
- `messages_acknowledge`: einen technischen Hinweis quittieren; keine Lesebestätigung oder Zustimmung.
- `messages_channels`: zugängliche Bereiche und deren Eigentümer finden.
- `messages_query`: Kanäle, Gespräche, Nachrichten, Bestätigungen und Entwürfe suchen.
- `messages_read`: einen aktuellen Datensatz samt Revision lesen.
- `messages_command`: zustimmen, pausieren, widerrufen, entwerfen, bestätigen und abschließen.
- `messages_release`: eine exakt freigegebene Nachricht mit begrenzter Berechtigung speichern.

`plugin_create_collection` benötigt `audience_user_ids` einschließlich des eigenen
Kontos. Danach folgen Freigabe über `plugin_link_bucket` oder `plugin_set_access`,
`channel.open` und die Zustimmung jedes Teilnehmers mit `channel.consent`.
Die Eigentümerorganisation bei weiteren Aufrufen mitführen. Die aktuellen Schemas
und Rollen liefert `plugin_describe`.

Freie Nachrichtentexte brauchen eine Prüfung durch einen vertrauenswürdigen Client
außerhalb der Modellschleife. Dieser erstellt über `POST /mcp/command-grants` eine
kurzlebige Berechtigung für genau den geprüften Aufruf. Das Modell erhält nur diese
begrenzte Berechtigung. Vollständiges OAuth allein reicht zum Senden per MCP nicht aus.
Ein Werkzeug zur Selbstfreigabe gibt es nicht. Danach wird die Berechtigung widerrufen.
Die [SDK-Anleitung](../plugin-sdk/docs/APPROVED-COMMANDS.md) beschreibt den Ablauf.
Ohne einen solchen Freigabeweg kann ein Agent lesen und Entwürfe vorbereiten;
automatischer Versand aus einer gewöhnlichen MCP-Verbindung ist nicht freigeschaltet.

Jede Zeile von `messages_inbox` nennt ihren Bereich: `collectionId` und
`collectionTitle` sind die Kennung und der Titel, die `messages_channels` auflistet.
Der Hinweis zu einem namentlich genannten Kanal ist die Zeile mit diesem Titel.
Zwei Zeilen können denselben Titel tragen, wenn ein anderes Konto einen Kanal
dieses Namens teilt; `collectionId` und `ownerOrganizationId` unterscheiden sie.
Beide Felder sind `null`, solange sich der Bereich nicht auflösen lässt.
`messages_acknowledge` antwortet mit dem, was quittiert wurde (`id`, `resourceId`,
`collectionId`).

Ein sinnvoller Abrufzyklus ist: `messages_inbox` laden, relevante Datensätze mit
`messages_read` lesen, nach erfolgreicher Verarbeitung den technischen Hinweis mit
`messages_acknowledge` quittieren. Dafür dessen zurückgegebene Kennung verwenden.
Eine Lesebestätigung oder Antwort bleibt eine eigene bewusste Aktion. Nur nach
erfolgreichem Abruf quittieren, damit ein Verbindungsabbruch keinen Hinweis verschluckt.

Aktuelle Revisionen von Kanal und Entwurf angeben, bei Antworten zusätzlich von
Gespräch und Bezugsnachricht. Änderungen an Inhalt, Empfängern, Richtlinien oder
Abhängigkeiten erfordern eine neue Prüfung. Wiederholungen prüfen die aktuellen Rechte.

## Optional mit Tasks und Calendar

Wenn beide passenden Plugins aktiv und kompatibel sind, erscheint in der Aufgaben-
oder Termindetailansicht **Aufgabe/Termin besprechen**. Der Verweis gehört dem Gespräch;
der Quelldatensatz bleibt unverändert. Titel werden unter den aktuellen Quellrechten
aufgelöst. Fehlende Plugins schränken nur diese Zusatzfunktionen ein. Verweise können
auch nach Deaktivierung eines Quellplugins nach Prüfung entfernt werden.

Verknüpfungen sind im Pilot auf dieselbe Eigentümerorganisation begrenzt. Ein geteilter
Kanal kann trotzdem mehrere Konten und Organisationen verbinden.

## Wenn etwas fehlt oder nicht funktioniert

| Beobachtung | Nächster Schritt |
|---|---|
| Nachrichten fehlt in der Navigation oder Werkzeugliste | Plugin aktivieren; einen Client mit gecachter Werkzeugliste neu verbinden |
| Der Kontakt sieht den Kanal nicht | Bestehendes Konto, Bucket-Mitgliedschaft und **Mit dir geteilte Kanäle** prüfen; später hinzugefügte Personen benötigen einen neuen Kanal |
| **Neue Frage** fehlt | Prüfen, ob alle Teilnehmer zugestimmt haben, der Kanal aktiv ist und deine Rolle Schreiben erlaubt |
| Eine erwartete Frage fehlt im Eingang | Eigentümerbereich prüfen; der Eingang zeigt Fragen an dich, der Ausgang deine eigenen Fragen |
| Die Versandfreigabe wird abgelehnt | Aktuelle Datensätze und Revisionen laden und den unveränderten beabsichtigten Inhalt erneut prüfen lassen |
| Die Verbindung brach beim Senden ab | Mit der normalen berechtigten Verbindung nachlesen; denselben Aufruf innerhalb derselben gültigen Freigabe wiederholen, keine neue Vorgangskennung zum Erzwingen des Versands verwenden |
| **Aufgabe/Termin besprechen** fehlt | Aktivierung, kompatible Verträge, gleiche Eigentümerorganisation und aktuelle Quellrechte prüfen |

Zum Export einen **Bereich** auswählen und **Bereich als JSON exportieren** öffnen.
Deaktivieren stoppt neue Änderungen; berechtigte Lesezugriffe und Export bleiben
möglich. Ein Zugriffsentzug ist etwas anderes und sperrt auch den Export.

## Grenzen

Clients rufen ihren Eingang während ihrer eigenen Ausführung ab. Keine Anzeige beweist,
dass ein Modell eine Nachricht gelesen hat. Fremde Nachrichtentexte und vermeintliche
Dringlichkeit sind keine Berechtigung, Wissen weiterzugeben oder Werkzeuge aufzurufen.
Autonome Offenlegungsregeln, freie Agentensuche, externe Brücken, Termin-Einladungen,
Hintergrundjobs, E-Mail und Dateianhänge sind nicht Teil dieses Piloten.

Für einen benannten Kanal rufen Clients zuerst `messages_channels` auf und übernehmen dessen Collection-ID und Eigentümer in `messages_query`. Das Feld `query` durchsucht Datensatzinhalte, keine Kanalnamen.

Entwürfe verweisen auf den tatsächlichen Kanal-Datensatz und seine aktuelle Revision. Lies diesen zuerst und übernimm alle Kanalteilnehmer als Empfängerliste des Entwurfs. Die Collection-ID und der Leserkreis der privaten Entwurfssammlung sind andere Werte. Ungültige Kanalverweise oder abweichende Empfänger werden abgelehnt – auch bei einer Wiederholung nach Rechteentzug. Eine Nachricht zu lesen erzeugt keine Lesebestätigung; dafür ist ausdrücklich `receipt.record` erforderlich.
