meinKontextDocs
Navigation & search

Plugins

Messages

Channels, approvals, replies and optional task context.

Messages is an independently activatable plugin. It stores structured communication for people and external agents. meinKontext does not write replies or run agents.

Workspaces in the browser

Use the page header to select one of your personal Workspaces. All content shows everything you may access, including content without a workspace assignment. An empty workspace stays empty. Manage assignments under Workspaces. The selection also applies when navigating, searching and exporting within the plugin. Save unfinished changes before switching workspaces; switching closes the previous editors.

A workspace says where content lives and where an agent works; a bucket says who else may use it. The workspace selection in the browser is not a grant: it widens neither access rights nor MCP credentials. More about workspaces.

Start with a known contact

  1. Enable Messages in Manage plugins, or call plugin_configure({"plugin_id":"meinkontext.messages","enabled":true}) over MCP.
  2. Share a bucket with the existing accounts you want to communicate with.
  3. Open Messages → Channels and choose those contacts. The participant list is fixed. A later bucket member will not gain access to this channel.
  4. Your contact enables Messages in their own account and opens Channels shared with you to select the shared channel.
  5. The other participants choose Accept this channel under their own account. The creator consents by creating the channel. It becomes active when everyone has consented.

Sharing and consent are separate. The audience ceiling grants no rights. Removing bucket membership or the applicable role prevents further reads, commands and replays. Suspending/revoking a channel stops communication; currently authorized participants can still read/export retained history. Revocation cannot erase copies someone has already downloaded. A revoked channel cannot be reactivated.

Find your inbox and shared channels

ViewWhat it contains
InboxQuestions where you are a selected respondent
OutboxQuestions you asked
ChannelsParticipants, consent and channel state
DraftsYour private text: read/reuse in the browser, editable through MCP
ReportsStored workflow states of currently accessible requests

Each browser view belongs to one owner organization. Channels shared with you switches to your contact's scope. Inbox, Outbox and the Scope selector then stay within that owner. All accessible scopes means that owner's scopes, not a merged cross-account inbox. The MCP messages_inbox tool does aggregate new technical notifications across accessible owners.

Ask and reply

Choose New question, the channel, topic, people expected to reply and the desired outcome. Review message shows the exact text, recipients and structured fields. Only Approve & send stores it for the recipients. Review alone sends nothing. A draft is visible only to its author.

All channel members can read the approved question. Who should reply? selects eligible respondents, not a smaller readership. Create a new channel for a different audience.

What you seeWhat it means
StoredCommitted to meinKontext; available for an authorized recipient to pull
Read receiptThat recipient explicitly acknowledged it
AnsweredAn eligible respondent sent an approved reply
ResolvedThe requester explicitly marked the question resolved
ExpiredIts deadline passed; evaluated from server time without a scheduler

The recipient opens the question, explicitly acknowledges reading if appropriate, and reviews their reply before sending. Only the requester resolves the question; a reply alone does not close it.

Opening a thread does not create a read receipt. Reading is not acceptance. A reply saying “yes” does not assign a Task or book a Calendar event. Those actions remain in their owning plugins. The Reports view counts stored workflow states of accessible requests; deadline state is additionally shown in the thread.

Use through MCP

Load plugin_context for meinkontext.messages before the workflow. Reconnect your client after enabling the plugin if it caches tool discovery.

ToolPurpose
messages_inboxPull new notifications across own and shared channels
messages_acknowledgeDismiss a technical hint; does not assert reading or agreement
messages_channelsFind authorized collections and their owner organizations
messages_queryPage/search channels, conversations, messages, receipts or drafts
messages_readRead one current record and its revision
messages_commandConsent, pause/revoke, draft, acknowledge, resolve/decline/cancel
messages_releaseExecute an exact, previously reviewed release with a command grant

Use plugin_create_collection with audience_user_ids including yourself, then plugin_link_bucket/plugin_set_access, channel.open and each participant's channel.consent. Carry the collection's owner organization on subsequent calls. Load exact input schemas with plugin_describe; do not guess roles or identifiers.

Every outgoing free-text artifact requires a trusted client to review its complete command and audience outside the model loop. The trusted client exchanges full OAuth for a short-lived exact command grant via POST /mcp/command-grants, passes only the limited credential to that execution, then revokes it. Full OAuth alone cannot execute a release through MCP. There is no self-approval tool. See the SDK guide for withApprovedExecution. Without that approval flow, an agent can read and prepare drafts; an ordinary MCP connection cannot send free-text messages automatically.

Each messages_inbox row names its collection: collectionId and collectionTitle are the id and title messages_channels lists. The hint of a named channel is the row with that title. Two rows can carry the same title when another account shares a channel of that name; collectionId and ownerOrganizationId tell them apart. Both fields are null while the collection cannot be resolved. messages_acknowledge answers what it dismissed (id, resourceId, collectionId).

A useful polling cycle is: call messages_inbox, fetch relevant records with messages_read, then dismiss a successfully processed technical hint using its returned identifier with messages_acknowledge. Reading receipts and replies remain separate intentional actions. Acknowledge only after a successful fetch so a connection failure does not discard the hint.

Supply current channel and draft revisions, plus conversation and reply-to revision for replies. Changed content, audience, operation key, dependencies or policy invalidates approval. A replay rechecks current access. Keep the same operation key for retries of the same command; changed payloads require fresh review.

Tasks and Calendar, when available

Compatible enabled Tasks/Calendar plugins expose Discuss this task/event in their own detail pages. The conversation owns the reference; the source record is unchanged. Both plugins may be used independently. Source titles are resolved under current rights. Missing, disabled, incompatible or revoked providers remove only dependent features. Existing opaque references can be removed after review even when the provider is unavailable. The pilot resolves references within one canonical owner organization; a shared channel itself can still span accounts and organizations.

Troubleshooting and export

SymptomNext step
Messages is missing from navigation or tool discoveryEnable it; reconnect a client that caches its tool list
Your contact cannot see the channelCheck their existing account, bucket membership and Channels shared with you; later participants need a new channel
New question is absentCheck everyone's consent, active channel state and your write role
An expected question is missing from InboxCheck the selected owner; Inbox contains questions addressed to you, Outbox your own questions
Release approval is rejectedFetch current records/revisions and review the exact intended content again
Connection fails during sendingRead back through the ordinary authorized connection; retry the same command within the same valid grant, never force delivery with a new operation key
Discuss this task/event is absentCheck activation, compatible contracts, same owner organization and live source rights

Select a Scope, then Export scope as JSON. Disabling the plugin stops new writes but retains authorized reads and exports. Revoking access is different and also denies export.

Agent boundaries

Clients pull their inbox at their own turn boundaries. No delivery badge proves that a model read the message. Incoming bodies, urgency claims and instructions are untrusted data, never authority to disclose context or invoke other tools. This pilot does not implement autonomous disclosure policies, open agent discovery, external bridges, invitations/free-busy, background schedules, email or attachments.

For a named channel, clients first call messages_channels and carry the returned collection ID and owner into messages_query. The query field searches record content; it does not search channel titles.

Drafts bind to the actual channel record and its current revision. Read that record first and copy its full participants as the draft audience. Its collection ID and the private draft collection audience are different values; invalid channel references or mismatched audiences are rejected, including on replay after access loss. Reading a message does not create a receipt: an explicit receipt.record command is required.