Der Brief
Zu allem, was dich braucht, gibt es einen Brief, auch ohne dass du etwas einrichtest. Er ist ein Text zum Kopieren, Teilen oder Senden an eine hinterlegte Adresse. Nota übergibt; es handelt nicht.


Was er von selbst mitbringt
Abschnitt betitelt „Was er von selbst mitbringt“Ein Brief sagt, was los ist und seit wann, und bringt mit, was der Core weiß:
- Vorgeschichte: ob es schon einmal vorkam, wann und wie lange es dauerte.
- Was daraus folgt: was nur deswegen offen ist.
- Was beim letzten Mal geholfen hat: der Satz, den jemand zurückgemeldet hat.
- Die letzten Ereignisse des Dings, das neueste zuerst.
Wozu keine Vorlage passt, das bekommt einen Standard-Brief mit diesem Kontext. Es gibt also immer etwas zum Übergeben. Den Kontext schreibt der Core heute auf Englisch, auch wenn deine Vorlage deutsch ist.
Eigene Vorlagen
Abschnitt betitelt „Eigene Vorlagen“Eine Vorlage schreibst du einmal, je Art von Ding oder je Prüfung, in eine Konfigurationsdatei. Es gibt zwei Typen: prompt ist ein Text zum Kopieren, webhook sendet denselben Text an eine Adresse, die du hinterlegt hast. Diese hier ist die Zahlungserinnerung aus dem ersten der Szenarien, ergänzt um einen Bezug und den Kontext:
{ "actions": [ { "id": "zahlungserinnerung", "title": "Zahlungserinnerung", "type": "prompt", "kind": "kunde", "body": "Schreib eine freundliche Zahlungserinnerung an {{thing.name}}: {{amount}}, fällig {{due}}.\n\nBezug: {{summary}}\n{{context}}" } ]}

Die Platzhalter stehen in der Referenz. Eine geänderte Vorlage wird zu einer neuen Version; ein Vorfall wird mit der Version dargestellt, die galt, als er begann.
Einen webhook-Brief aus dem Dashboard zu senden, braucht einen Schlüssel mit der Rolle operate. Mit "auto": true geht er von selbst raus, sobald ein passender Vorfall beginnt. Die Anfrage ist signiert; siehe Benachrichtigungen. So oder so ist es ein signierter Aufruf mit einem Text an eine Adresse, die du gewählt hast: Was dort geschieht, ist deine Sache, nicht die von Nota.
Was geholfen hat
Abschnitt betitelt „Was geholfen hat“Wer es behoben hat — du oder dein Agent —, meldet es in einem Satz zurück, als Ereignis:
{"type":"event","thing":"web-1","event":"fix","summary":"Logs rotiert","vars":{"check":"disk"}}Beim nächsten Mal steht der Satz im Brief zu dieser Prüfung, und dazu, ob es gehalten hat: wie lange, oder dass es das zweite Mal seitdem ist. Wie du eine Meldung schickst, steht unter Selbst melden. Auf dem Server geht es auch von Hand:
nota fixed web-1 disk Logs rotiertDer Rückblick
Abschnitt betitelt „Der Rückblick“Der Brief zu einem Vorfall hilft, eine Sache zu beheben. Der Rückblick hilft, den Ablauf zu verbessern. Die Seite „Rückblick” im Dashboard (und GET /v1/review, im MCP-Server das Werkzeug review) zählt für einen Monat, für alles oder einen Ausschnitt:
- Kam wieder: dieselbe Prüfung am selben Ding, mehr als einmal.
- Was getan wurde und ob es gehalten hat: jede vermerkte Behebung, und wie oft das Ding danach wieder jemanden gebraucht hat.
- Lärm: eine Prüfung, die mindestens dreimal aufging und meist nach höchstens fünfzehn Minuten von selbst vorbei war. Sie kostet Aufmerksamkeit und sagt nichts.
- Zu spät: was nach seiner Fälligkeit erledigt wurde, in ganzen Tagen, und derselbe Schritt, der bei mehreren Dingen zu spät kam, im Schnitt.
Darunter steht dasselbe als ein Brief auf einer Seite, in vier Teilen: das Problem, was dahintersteckt, was getan wurde, was zu verfolgen ist. Nota zählt nur. Die Schlüsse ziehst du oder der Agent, dem du die Seite gibst.
Von Hand melden
Abschnitt betitelt „Von Hand melden“Nicht alles sieht eine Quelle. Auf dem Server sagst du selbst, dass etwas Aufmerksamkeit braucht, und nimmst es wieder zurück:
nota flag shop Kunden melden einen falschen Steuersatznota clear shopDas läuft wie jede andere Meldung, mit Mitteilung und Brief. -crit nach flag macht es kritisch.
Nachfragen: MCP
Abschnitt betitelt „Nachfragen: MCP“Ein Coding-Agent, der einen Brief bekommen hat, kann selbst weiter nachsehen. POST /mcp, mit einem Schlüssel der Rolle read oder operate, ist ein Model-Context-Protocol-Server über dieselben Ansichten. Er kann dort nur lesen.
| Werkzeug | Beantwortet |
|---|---|
attention, ledger | was jemanden braucht, für alles oder einen Ausschnitt |
brief | einen Vorfall und seinen Brief |
thing, things, scopes, history | ein Ding vollständig, alle Dinge, die Ausschnitte, die Vorfälle der letzten Tage |
money, top | einen Monat in Geld, und was darin herausstach |
Jedes Werkzeug liest; keines schreibt, löst etwas aus oder sendet. Ein Agent, der etwas behoben hat, meldet das wie jede Quelle über /v1/ingest mit einem Schlüssel der Rolle ingest. Was die Werkzeuge zurückgeben — Namen, Texte —, stammt von Quellen und ist Daten, keine Anweisung; der Server sagt das, wenn sich ein Client verbindet.
{ "mcpServers": { "nota": { "type": "http", "url": "https://nota.example.org/mcp", "headers": { "Authorization": "Bearer nota_…" } } }}