meinKontextDocs
Navigation & Suche

Plugins

Nachrichten

Kanäle, Freigaben, Antworten und optionale Aufgabenverknüpfungen.

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

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

AnsichtWas du dort findest
EingangFragen, bei denen du als antwortende Person ausgewählt bist
AusgangFragen, die du gestellt hast
KanäleTeilnehmer, Zustimmungen und Kanalzustand
EntwürfeDeine privaten Texte; im Browser zum Lesen und Übernehmen, per MCP auch bearbeitbar
AuswertungGespeicherte 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.

ZustandBedeutung
GespeichertBerechtigte Empfänger können die Nachricht abrufen
LesebestätigungDiese Person hat das Lesen ausdrücklich bestätigt
BeantwortetEin vorgesehener Empfänger hat eine freigegebene Antwort gesendet
GeklärtDer Fragesteller hat die Anfrage ausdrücklich abgeschlossen
AbgelaufenDie 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 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

BeobachtungNächster Schritt
Nachrichten fehlt in der Navigation oder WerkzeuglistePlugin aktivieren; einen Client mit gecachter Werkzeugliste neu verbinden
Der Kontakt sieht den Kanal nichtBestehendes Konto, Bucket-Mitgliedschaft und Mit dir geteilte Kanäle prüfen; später hinzugefügte Personen benötigen einen neuen Kanal
Neue Frage fehltPrüfen, ob alle Teilnehmer zugestimmt haben, der Kanal aktiv ist und deine Rolle Schreiben erlaubt
Eine erwartete Frage fehlt im EingangEigentümerbereich prüfen; der Eingang zeigt Fragen an dich, der Ausgang deine eigenen Fragen
Die Versandfreigabe wird abgelehntAktuelle Datensätze und Revisionen laden und den unveränderten beabsichtigten Inhalt erneut prüfen lassen
Die Verbindung brach beim Senden abMit der normalen berechtigten Verbindung nachlesen; denselben Aufruf innerhalb derselben gültigen Freigabe wiederholen, keine neue Vorgangskennung zum Erzwingen des Versands verwenden
Aufgabe/Termin besprechen fehltAktivierung, 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.